Author Topic: Official Online Documentation  (Read 4060 times)

Syntac

  • Posts: 841
  • Turrets: +118/-104
    • Syntac's Stuff
Official Online Documentation
« on: September 23, 2008, 01:00:41 am »
I'm of the opinion that Tremulous needs an official online documentation (not a wiki). It should contain things like information on current development, a coder's guide, and, of course, a manual.

Why shouldn't it be a wiki? For the simple reason that it should only contain information that is known to be 100% true. The only experts on Tremulous are the developers, and as such they are the only ones who should be allowed to maintain this hypothetical documentation.

I'm working on something called FooDocs that might be useful for this purpose. Does anyone else think an official documentation is a good idea?

fingered banana

  • Guest
Re: Official Online Documentation
« Reply #1 on: September 23, 2008, 01:02:20 am »
so it can be a wiki closed to public ;)
edit: it would be cool if someone extracted useful info from the forums. Then someone else checks for correctness
edit: So... we can just write RTFOOD instead of STFF + RTFM + UTFG
« Last Edit: September 23, 2008, 01:06:20 am by fingered banana »

Death On Ice

  • Posts: 1287
  • Turrets: +126/-141
Re: Official Online Documentation
« Reply #2 on: September 23, 2008, 04:15:39 am »
The lazy bastards behind the 1.2 blog were working on this during the summer (before our free time vanished).

mooseberry

  • Community Moderators
  • *
  • Posts: 4005
  • Turrets: +666/-325
Re: Official Online Documentation
« Reply #3 on: September 23, 2008, 04:46:01 am »
Yeah what bastards...  :o

Anyways, interesting idea, but I don't see why this is off topic? Perhaps General Discussion is better.
Bucket: [You hear the distant howl of a coyote losing at Counterstrike.]

मैं हिन्दी का समर्थन

~Mooseberry.

fingered banana

  • Guest
Re: Official Online Documentation
« Reply #4 on: September 23, 2008, 10:57:40 am »
OFFicial :P

Lava Croft

  • Guest
Re: Official Online Documentation
« Reply #5 on: September 25, 2008, 10:53:49 am »
Like most good ideas, there will be tons of people who agree with you that this is a good idea.
Too bad that just having a good idea is easy, actually bringing the idea into practice is a completely different subject.

Annihilation

  • Posts: 684
  • Turrets: +162/-197
Re: Official Online Documentation
« Reply #6 on: September 25, 2008, 06:20:19 pm »
Well, I would love to set one up, but I don't know enough about trem's progess svn etc to do so.  I nominate Paradox! :)
[11:33:20 PM] Kaine:
Quote from: KobraKaine
How do you perform goon-copulation if he doesn't play?
Quote from: PowerOverwhelming
We just get on VC and listen to camels dying until we orgasm

Syntac

  • Posts: 841
  • Turrets: +118/-104
    • Syntac's Stuff
Re: Official Online Documentation
« Reply #7 on: September 25, 2008, 08:40:04 pm »
Well, this is up to the devs, of course. Should they choose to use FooDocs, I can finish it pretty quickly.

Paradox

  • Posts: 2612
  • Turrets: +253/-250
    • Paradox Designs
Re: Official Online Documentation
« Reply #8 on: September 25, 2008, 10:10:30 pm »
Khalsa and I have discussed this before, and the perpetual answer would be "Ya, well, we would like it, but were busy"

I might be able to set up a MediaWiki sometime for it, but I don't have the time or attention span to write every article.

Thats where the community comes in.

But for a wiki, i have a number of ideas. You can see them at the following site:
http://wiki.paradoxdgn.com/wiki/Tremulous_Wiki_ideas
« Last Edit: September 26, 2008, 05:50:57 pm by Paradox »

∧OMG ENTROPY∧

khalsa

  • Administrator
  • Posts: 597
  • Turrets: +187/-132
    • http://www.mercenariesguild.net
Re: Official Online Documentation
« Reply #9 on: September 26, 2008, 07:15:37 am »
Your link is missing an 's'. I like much of your structure ideas.

lol @ official - dev only.

Khalsa
}MG{ Mercenariesguild
ਮਨੁ ਜੀਤੇ ਜਗੁ ਜੀਤਿਆ

+ OPTIMUS +

  • Posts: 1098
  • Turrets: +263/-164
Re: Official Online Documentation
« Reply #10 on: September 26, 2008, 10:51:50 am »
i'd like to read interviews instead. with a programmer, a modeler, a mapper, a game tester, etc. for technical noobs like me, its more interesting than to look deep inside the datas.
success is the ability to go from failure to failure without losing your enthusiasm

+PICS+

Paradox

  • Posts: 2612
  • Turrets: +253/-250
    • Paradox Designs
Re: Official Online Documentation
« Reply #11 on: September 26, 2008, 05:53:15 pm »
Optimus, feel free to add that where you see fit.

∧OMG ENTROPY∧