[PATCH rtems-docs v2 1/2] Added FAQ page

Chris Johns chrisj at rtems.org
Sun Apr 4 23:36:57 UTC 2021


On 4/4/21 1:30 pm, Ayushman Mishra wrote:
> Using "-----" makes H4 size headings
> (https://documentation-style-guide-sphinx.readthedocs.io/en/latest/style-guide.html#headings).
> 
> Could there be a single FAQ section and then internal references, ie
> links? : Does it mean making separate .rst pages for each question
> (whose answers were previously written in faq page) and the reader
> will only see hyper-link questions , and regarding cross-link
> questions written single line example: " Please refer section
> "Creating a Patch" of RTEMS Software Engineering manual in
> https://docs.rtems.org/ ".

A single faq.rst is fine. Can there be a single single section and in that you
create anchors and links to them without having section headers?

Chris


More information about the devel mailing list