Re: [RFC PATCH v4 3/4] dts: add doc generation

2023-10-27 Thread Juraj Linkeš
Thanks for the comments, Yoan. > > diff --git a/doc/guides/tools/dts.rst b/doc/guides/tools/dts.rst > > index 32c18ee472..98923b1467 100644 > > --- a/doc/guides/tools/dts.rst > > +++ b/doc/guides/tools/dts.rst > > @@ -335,3 +335,32 @@ There are three tools used in DTS to help with code > > checki

Re: [RFC PATCH v4 3/4] dts: add doc generation

2023-10-26 Thread Yoan Picchi
On 8/31/23 11:04, Juraj Linkeš wrote: The tool used to generate developer docs is sphinx, which is already used in DPDK. The configuration is kept the same to preserve the style. Sphinx generates the documentation from Python docstrings. The docstring format most suitable for DTS seems to be the

Re: [RFC PATCH v4 3/4] dts: add doc generation

2023-09-20 Thread Juraj Linkeš
> diff --git a/doc/guides/conf.py b/doc/guides/conf.py > index 0f7ff5282d..737e5a5688 100644 > --- a/doc/guides/conf.py > +++ b/doc/guides/conf.py > @@ -7,10 +7,9 @@ > from sphinx import __version__ as sphinx_version > from os import listdir > from os import environ > -from os.path import base