Re: moving FAQ into reference docs

I have some issues with your points:
 - the FAQ is easy to find. goto and click on FAQ,
just above API. I see cross-referencing the API as a 'nice thing to
have', but not as a reason to do what you are suggesting.
 - this does need doing, but isn't related to moving the FAQ into the
reference manual
 - chicken-and-egg thing. you can't just pick some arbitrary groups,
cause most of them will have one or less questions in them, which is
just wrong diddly wrong wrong.

Havoc, if you want an 'index tool' for the reference manual, then create
one, don't try and make the FAQ something it isn't.

The other thing that concerns me is that the output format of the API
isn't suited to the FAQ.

I'm not trying to be negative, but I can't see an overriding argument
for doing this. They are dofferent beasts.



On Sun, 2001-12-16 at 21:36, Havoc Pennington wrote:
> Hi,
> I'd like to do several things at once:
>  - move the FAQ into the reference manual, so that it's easy to find, 
>    but more importantly so answers can have cross-references into 
>    the docs (many answers should simply be a link to some docs 
>    we ought to have or even do have)
>  - rework answers for GTK 2 when appropriate
>  - organize the questions into smaller groups (e.g. X11 backend, win32
>    backend, text editing/display, widgets in general, memory
>    management, list/tree, menus, etc.)
> Basically I'd like to use the FAQ in part as an index tool to help
> people get started on the reference manual.
> Havoc

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]