[haiku-doc] Re: Revert doxygen to version 1.7.6
- From: Niels Sascha Reedijk <niels.reedijk@xxxxxxxxx>
- To: haiku-doc@xxxxxxxxxxxxx
- Date: Sun, 23 Dec 2012 11:25:07 +0100
Hi,
On Sat, Dec 22, 2012 at 11:15 PM, John Scipione <jscipione@xxxxxxxxx> wrote:
> On Sat, Dec 22, 2012 at 4:35 PM, Niels Sascha Reedijk
> <niels.reedijk@xxxxxxxxx> wrote:
>>> Given that the documentation is broken on 1.8.1 installed on the
>>> server right now can we revert to 1.7.6 for the time being? We can
>>> update the code to look good and then update to the 1.8.x branch again
>>> later on.
>>
>> Yes, or not. I still want to see whether switching to the wiki
>> approach will work. I am sort of stuck on finding a roadmap right now.
>> I would also like to think about how we approach things like
>> organizing functions and creating navigation.
>
> I also think that is a good approach, at least I'm not in love with
> Doxygen. Problem is that Doxygen seems to be the best program out
> there for source code documentation. The wiki would be a good
> secondary solution though. We'd lose all the code checking that
> doxygen does, but the barrier to entry of fixing the docs would be
> lowered. If we could get a few more people involved in documentation
> writing it would be a net win.
Actually, the checking with the header field would not be lost. The
wiki pages can be cross-checked with the Doxygen output and then it is
possible to find out which changes are there.
>> Will we use header files as package containers (which is not really a
>> C++ convention, nor a Haiku one), or will we just use a liberal way of
>> organizing it? Like putting all the support kit functions on one page?
>
> I would organize classes by kit that seems to be the most reasonable
> way to organize them.
So what do we do with functions, defines, enums, typedefs and what
else that are there? Organize by topic (like the BeBook does it) or
organize by header file (like Doxygen).
>> Anyway, I will try to downgrade the server to 1.7.6.
>
> Okay, that will be helpful in the interim, at least the
> api.haiku-os.org page will look decent again.
It is back at 1.7.5.1 and the documentation has already been regenerated.
Regards,
N>
Other related posts:
