[PATCH 1/2] Added FAQ page

[Gedare Bloom]

On Fri, Apr 2, 2021 at 12:55 PM Joel Sherrill <joel at rtems.org> wrote:
>
>
>
> On Fri, Apr 2, 2021 at 1:50 PM Ayushman Mishra <ayushvidushi01 at gmail.com> wrote:
>>
>> Sir, It was given as an issue https://devel.rtems.org/ticket/3958 (
>> Review wiki/TBR/Website/FAQ for correct links) for the faq page
>> https://devel.rtems.org/wiki/TBR/Website/FAQ
>
>
> Thanks for confirming that. When Gedare acks the patches as being
> ok by him, I will see about removing that page and fixing links to it.
>
> --joel
>>
>>
>>
>> On Sat, Apr 3, 2021 at 12:10 AM Joel Sherrill <joel at rtems.org> wrote:
>> >
>> >
>> >
>> > On Fri, Apr 2, 2021 at 1:19 PM Ayushman Mishra <ayushvidushi01 at gmail.com> wrote:
>> >>
>> >> Greetings Sir,
>> >> I have corrected and send patches regarding FAQ page in user manual.I
>> >> was able to build the page on my system and also attached a
>> >> screen-shot of the builded page on browser . I have corrected
>> >> whitespace consistency and reference links according to other
>> >> doc-pages
>> >
>> >
>> > Random question. Is this information from the Wiki or just an update
>> > of what was already in rtems-docs? If this obsoletes any information
>> > in the wiki, I would like to know so we can remove it.
>> >
>> >>
>> >> . Regarding the issue of cross-link between docs , I had
>> >> sent mail on devel mail list
>> >> https://lists.rtems.org/pipermail/devel/2021-March/065882.html but
>> >> haven't got any response , so few days ago after a little discussion
>> >> on discord vijay sir said to post the patch and someone might point it
>> >> to a better way if it exists.
>> >
>> >
>> > I don't know if we know the answer to that with Sphinx. If "we" do, then
>> > I am not part of that "we".  Hopefully someone will educate us. :)
>> >
>> > Gedare.. is the new patch OK? It must be in another thread because
>> > I don't see it here.
>> >
>> > --joel
Patch needs a little bit of tweaking. It's close.

The problem with the cross-doc links is that they are wrong for a
release doc. I don't think we have determined what is the proper
solution to follow yet. They also don't populate the section numbers
in PDF builds, so all you get is the URL and if you have printed
manuals (does anyone do that?) you might not be able to find what you
want. There's no good answer to this problem though, so I'm ok with
merging the patch after the other issues get addressed, but we're
probably adding more effort to the release/post-release procedures
until someone sorts out how to do cross-doc links in a useful way.