[spp] [PATCH 1/1] docs: add bug report chapter

Yasufumi Ogawa yasufum.o at gmail.com
Wed Jul 1 16:46:42 CEST 2020


> From: Hideyuki Yamashita <yamashita.hideyuki at ntt-tx.co.jp>
> 
> This patch adds how to issue bug using Bugzilla in RST document.
> Also reference is addded from "CONTRIBUTING.txt".
> 
> Signed-off-by: Hideyuki Yamashita <yamashita.hideyuki at ntt-tx.co.jp>
> Signed-off-by: Naoki Takada <ntakada14 at gmail.com>
> ---
>   CONTRIBUTING.txt           |  6 ++++++
>   docs/guides/bug_report.rst | 18 ++++++++++++++++++
>   docs/guides/index.rst      |  1 +
>   3 files changed, 25 insertions(+)
>   create mode 100644 docs/guides/bug_report.rst
> 
> diff --git a/CONTRIBUTING.txt b/CONTRIBUTING.txt
> index 957b7fb..3b24738 100644
> --- a/CONTRIBUTING.txt
> +++ b/CONTRIBUTING.txt
> @@ -45,6 +45,12 @@ Coding Guidelines
>   * C code should follow the DPDK coding standards.
>   * Python code should follow PEP8.
>   
> +Bug report
> +----------
> +
> +How to issue bug is described in "Bug report" chapter
Please revise
- "issue bug" -> "issue a bug"
- Make "Bug report" to be a link to the chapter

> +in the RST document.
No need to say "RST" because compiled document is not rst format but html.

> +
>   Maintainer
>   ----------
>   
> diff --git a/docs/guides/bug_report.rst b/docs/guides/bug_report.rst
> new file mode 100644
> index 0000000..e9064e3
> --- /dev/null
> +++ b/docs/guides/bug_report.rst
> @@ -0,0 +1,18 @@
> +..  SPDX-License-Identifier: BSD-3-Clause
> +    Copyright(c) 2020 Nippon Telegraph and Telephone Corporation
> +
> +Bug Report
> +==========
> +
> +SPP is hosted project of DPDK.
"SPP is a hosted ..."

> +DPDK uses Bugzilla as its bug tracking system.
> +
This empty line is not needed.

> +Users can issue SPP related bugs in the following link:
> +
> +https://bugs.dpdk.org/enter_bug.cgi?product=SPP
> +
> +Note that to issue new bug, you have to create account to the Bugzilla.
> +
This empty line is not needed.

> +You can view open SPP related bugs in the following link:
> +
> +https://bugs.dpdk.org/buglist.cgi?bug_status=__open__&product=SPP
> \ No newline at end of file
I'm curious about this line. Did you edit this patch on windows possibly?

> diff --git a/docs/guides/index.rst b/docs/guides/index.rst
> index 70ec4a6..3ea80ef 100644
> --- a/docs/guides/index.rst
> +++ b/docs/guides/index.rst
> @@ -15,6 +15,7 @@ SPP documentation
>      commands/index
>      tools/index
>      api_ref/index
> +   bug_report
>   
>   This documentation is the latest tagged version, but some of the latest
>   developing features might be not included.
> 


More information about the spp mailing list