On 8/17/06, Miguel Zúñiga <mzuniga@xxxxxxx> wrote:
On the official side, the Documentation Team is kind of... on stand by. I am waiting for two years for the official doc-team, but since the Wiki came i had the chance to "publish" some text i wrote, and get some feedback. I realize i am not a big programmer, but it is the more "official" channel available for interacting and giving opinions.
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.
Hosting * separate repos, so members can't mess with our source code? * integrated with our repos, so it looks more official? __ A very open documentation project there will be a lot of contributors, so a separate repos would be better.
Repository * centralized like Subversion * distributed like Mercurial or Bazaar-NG (contributions get easier, maybe requires more maintenance work on member's side) __ Personally, I really liked Mercurial, but hosting could be more complicated than simply using SourceForge or BerliOS (Subversion).
Policy * anonymous commits * everyone gets an account on request * you must send patches before you get repos access __ I think the second option is the best.
When those decisions are made you could create a team and work on the documentation. It's very simple. You just have to make a few decisions and start working. ;)
> Creative use of UI and web design combined with the use of subdomains > would be enough to provide the distinction that is needed between the two > types of content. I would like to discuss this with DarkWyrm to see if we > can contribute to the design of the new website to cope with this.
I vote for subdomains. It would be easier to review and correct the "unofficial" content than begin all over again from scratch. Having at least something to compare with for the final documentation, when it is time to do it. With a subdomain, there will be a feeling of "unofficial but accepted", and Drupal provides that possibility...
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.
Bye, Waldemar Kornewald
