[openbeos] Re: On the new Haiku website

  • From: "Axel Dörfler" <axeld@xxxxxxxxxxxxxxxx>
  • To: openbeos@xxxxxxxxxxxxx
  • Date: Thu, 17 Aug 2006 17:16:29 +0200 CEST

"DarkWyrm" <darkwyrm@xxxxxxxxxxxxx> wrote:
> > Why don't you start the official Documentation Team? Ask all the 
> > other wiki contributors and start writing. But before you do that, 
> > we need
> > to make a few decisions:
> > 
> > Which format?
> > * DocBook
> > * LaTeX
> > * ...?
> > __ To me, DocBook sounds good.
> Last I knew, we had officially decided on DocBook format for 
> documentation.

Definitely, and there is little reason to change that. Despite the 
missing automatic retrieval of docs from sources (like doxygen 
provides), it's much more flexible and powerful.

If you ask me, we should also have doxygen documentation, but for the 
internal API usage only - since we already put quite an effort into 
this in the sources, there is no reason not to make use of it :-)

> > Subdomains really never gave me the feeling of "unofficial". If 
> > it's
> > in a subdomain the offical project must have set it up. How can 
> > this
> > be understood as unoffical? And if you put "Unoffical" on every 
> > page
> > in the subdomain people will probably doubt that haiku-os.org is
> > official.
> I would agree. I'm all for the idea mentioned a while ago to use a 
> separate domain for community efforts.

A site like haiku-community.net|org would be fine with me, even though 
a community.haiku-os.org wouldn't look too official to me either. But 
in the end, I don't really mind that much, I'm a tiny bit in favour of 
separating them, though.

Bye,
   Axel.


Other related posts: