[AD] doc / makedoc suggestion

[ Thread Index | Date Index | More lists.liballeg.org/allegro-developers Archives ]


"People don't read FAQs (but should)" is a well known fact :-) This gave me the following idea:

Maybe a new optional section named "related FAQs" could be added to the function descriptions in the documentation, similar to the "see also" one. For example, d_bitmap_proc could have "Related FAQs: <Why can't I get d_bitmap_proc or d_icon_proc to work ?>". fade_out and co. could have "Related FAQs: <How can I fade the screen in a truecolor graphics mode?> ".

What do people think ?

--
Julien Cugnière




Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/