[LTP] [Open discussion] docparse handling

[Andrea Cervesato via ltp <ltp@lists.linux.it>]

Hi all,

we just added a test catalog in the LTP documentation [1], but most of 
the tests are still using asciidoc as the main tests' description 
syntax. Obviously, we need to switch to RST [2] syntax, that is now used 
in the whole LTP documentation along with sphinx [3] support.

I would like to introduce a discussion on this topic, since I seen a few 
patches meant to adapt old tests' descriptions [4] into asciidoc and we 
don't really want to double our job. In particular:

- is [Description] tag still needed? Shall we use **Description** instead?
- shall we start to convert all tests' descriptions into asciidoc? If 
yes, how? Automatically or manually?

Best regards,
Andrea Cervesato

[1] 
https://linux-test-project.readthedocs.io/en/latest/users/test_catalog.html
[2] https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
[3] https://www.sphinx-doc.org/en/master/index.html
[4] 
https://patchwork.ozlabs.org/project/ltp/patch/20250210091044.359274-1-maxj.fnst@fujitsu.com/


-- 
Mailing list info: https://lists.linux.it/listinfo/ltp