[Fuego] [PATCH] Docs: Convert tbwiki pages into .rst files
Bird, Tim
Tim.Bird at sony.com
Wed Dec 2 21:45:46 UTC 2020
I committed this patch, and updated a lot of content in the
Fuego_directories and Glossary files.
I mention one outstanding issue is below...
> -----Original Message-----
> From: Pooja <pooja.sm at pathpartnertech.com>
>
> From: Pooja More <pooja.sm at pathpartnertech.com>
>
> Following pages are converted:
> Coding_style.rst
> Fuego_directories.rst
> Glossary.rst
>
> Signed-off-by: Pooja More <pooja.sm at pathpartnertech.com>
> ---
> docs/rst_src/Coding_style.rst | 111 +++++++++++++++
> docs/rst_src/Fuego_directories.rst | 161 +++++++++++++++++++++
> docs/rst_src/Glossary.rst | 277 +++++++++++++++++++++++++++++++++++++
> 3 files changed, 549 insertions(+)
> create mode 100644 docs/rst_src/Coding_style.rst
> create mode 100644 docs/rst_src/Fuego_directories.rst
> create mode 100644 docs/rst_src/Glossary.rst
>
> diff --git a/docs/rst_src/Coding_style.rst b/docs/rst_src/Coding_style.rst
...
> diff --git a/docs/rst_src/Glossary.rst b/docs/rst_src/Glossary.rst
> new file mode 100644
> index 0000000..61bb3d7
> --- /dev/null
> +++ b/docs/rst_src/Glossary.rst
> @@ -0,0 +1,277 @@
> +##############
> +Glossary
> +##############
> +
> +Here is a glossary of terms used in this wiki:
> +
> +Here is a short table that relates a few Jenkins terms to Fuego terms:
> +
> +show_sort_link=0
> +
> +show_edit_links=0
> +
> +Table:
> +
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +| Jenkins term |Fuego term |Description |
> ++==============+==================+==================================================================================
> ==============+
> +|slave |''none'' |this is a long-running jenkins process, that executes jobs. It is usually (?) assigned to a |
> +| | |particular node |
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +|node |board |item being tested (Fuego defines a Jenkins node for each board in the system) |
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +|job |test |a collection of information needed to perform a single test |
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +|''none'' |request |a request to run a particular test on a board |
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +|build |run(or 'test run')|the results from executing the job or test |
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +|''none'' |plan |the plan has the list of tests and how to run them (which variation, or 'spec' to use) |
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +|''none'' |spec |the spec indicates a particular variation of a test |
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> +
I shortened the lines on this table so that the source is only 80-columns wide.
When rendered by sphinx for html output ('make html'), the resulting html
file has a table that is not fit to the page. It has a horizontal scroll bar, instead
of expanding the table cells vertically and wrapping the text.
Can you see if there's a setting that would allow this table to appear without
needing a scroll bar?
Thanks,
-- Tim
More information about the Fuego
mailing list