Documentation Project

Place all meeting requests / announcements here...
Post Reply
User avatar
blast
General
General
Posts: 4741
Joined: Fri Mar 21, 2003 3:49 pm
Location: playing.cxx
Contact:

Documentation Project

Post by blast » Wed Jan 31, 2007 4:36 pm

I recall someone posting on the forum saying they wanted to start an unofficial documentation wiki for BZFlag. Was this ever started? The current bzflag.org wiki is not very helpful in this regard, not to mention I always forget my login for it. I was unable to locate the original thread on the forum discussing this idea, so it might have been pruned or just deleted during reorganization.

I think this would be a great idea for some of us to go through with. I would be willing to accept and review documentation that was submit to me, and compile it into a webpage. We could establish a list of topics that need to be defined, and I would also take suggestions for new topics as we go.

Here's just an idea of some of the rough topics we could cover.
  • Downloading, installation, compiling, CVS/SVN
  • Document and explain all menu items
  • Gameplay tips
  • Detailed troubleshooting and common issues
  • FAQ
We would also define the format of each item that we sent in so we could make it easier to properly merge later. The documentation could then be packaged along with the installer, package, or source, and left as website.

I guess I'm looking for further discussions on what our target should be. I suppose we could simply update the man files with this information, but I that might be outside the scope of those files.
"In addition to knowing the secrets of the Universe, I can assure you that I am also quite potty trained." -Koenma (Yu Yu Hakusho)

Image

User avatar
CannonBallGuy
Private First Class
Private First Class
Posts: 2083
Joined: Wed Apr 12, 2006 1:31 am
Contact:

Post by CannonBallGuy » Wed Jan 31, 2007 4:58 pm

I don't see why any such documentation need be unofficial.
The purpose of a wiki is that all (if not most) users can contribute.
Besides, you suggest that docs be sent to you, so either way I think the docs should stay on bz.org.
Perhaps, though, the files can be available for download so that users can store them locally and even host them for those few times when bz.org is down or slow.
Image

Merry Christmas!

"Look, if I don't buy booze for the kids, I don't get any incriminating pictures to show to their parents, my business goes down the sink, my girlfriend leaves me and the baby goes on ebay. So help me search..."

"go Play With Toys urself in a dark alley u donkey ******" - Lt-Kirby2007

User avatar
blast
General
General
Posts: 4741
Joined: Fri Mar 21, 2003 3:49 pm
Location: playing.cxx
Contact:

Post by blast » Wed Jan 31, 2007 5:05 pm

CannonBallGuy wrote:I don't see why any such documentation need be unofficial.
The purpose of a wiki is that all (if not most) users can contribute.
Besides, you suggest that docs be sent to you, so either way I think the docs should stay on bz.org.
Perhaps, though, the files can be available for download so that users can store them locally and even host them for those few times when bz.org is down or slow.
Yes, I was wanting this one to be official (thus why I mentioned it shipping with the installer, packages, and source). I was just wondering if the unofficial docs were already started so they could be merged into this project.

We might be putting up a new wiki powered by MediaWiki on the bzflag list server, so this might be where the actual documentation can go. I'm just not sure how easy that would make it to export a nice looking document to be bundled with the previously stated methods.

I was originally thinking of just storing the documentation in CVS/SVN, and having either myself or a few others accept documentation.

I know there are quite a few fan sites that provide some form of documentation or tips for BZFlag, so it might be nice if we can all team up and generate one large group of documentation that is as complete as possible. It would make it easier for new players who have questions.
"In addition to knowing the secrets of the Universe, I can assure you that I am also quite potty trained." -Koenma (Yu Yu Hakusho)

Image

User avatar
joevano
General
General
Posts: 1863
Joined: Sat Jun 18, 2005 1:08 pm
Location: South Bend, Indiana, USA

Post by joevano » Wed Jan 31, 2007 6:23 pm

Great idea blast, and lets not forget about the map makers. There are lots of things to know about map making. I think that would be a good "area" to cover also. Many of the questions on map making in the map making forum seem to be repeats of the same questions asked before.

User avatar
CannonBallGuy
Private First Class
Private First Class
Posts: 2083
Joined: Wed Apr 12, 2006 1:31 am
Contact:

Post by CannonBallGuy » Wed Jan 31, 2007 9:06 pm

Count me in.
Topics that should be covered..:
Actually Playing
Navigating the Options
Registering Globally
Making a Map
Running a Server
Downloading/Installing from CVS/SVN
Crating Plugins
Image

Merry Christmas!

"Look, if I don't buy booze for the kids, I don't get any incriminating pictures to show to their parents, my business goes down the sink, my girlfriend leaves me and the baby goes on ebay. So help me search..."

"go Play With Toys urself in a dark alley u donkey ******" - Lt-Kirby2007

User avatar
Davy Jones
Private First Class
Private First Class
Posts: 297
Joined: Thu Jan 04, 2007 4:39 am
Location: Davy Jone's Locker

Post by Davy Jones » Wed Jan 31, 2007 9:10 pm

I'd like to help as well

Things That also need to be covered


Leagues-
FAQ about playing-
Techniques-
And others

to be continued...
Owner @ The Twin Towers
Admin @ The Two Boxes
Cop @ Army Of One
Image
Image

User avatar
L4m3r
Hater of Everything
Hater of Everything
Posts: 724
Joined: Tue Feb 08, 2005 5:15 am
Location: Los Angeles

Post by L4m3r » Fri Feb 02, 2007 8:17 pm

If the docs could be kept up to date with changes in CVS, we could break off an "image" of the wiki for each version release and distribute it with the game.

Plugin docs would be nice to have in the wiki, also.
Optimism is just a milder alternative to denial.

User avatar
The Vaxorcist
Private First Class
Private First Class
Posts: 134
Joined: Wed Mar 23, 2005 10:28 am
Location: Santa Rosa, CA

Post by The Vaxorcist » Fri Mar 09, 2007 12:55 am

Great idea. This has been missing for a while.

Start it, and maybe I'll chip in a page or two.
Image
Where's Darwin when you need him?

Lagger@Everywhere

User avatar
blast
General
General
Posts: 4741
Joined: Fri Mar 21, 2003 3:49 pm
Location: playing.cxx
Contact:

Post by blast » Fri Mar 09, 2007 4:27 am

There is a new BZFlag wiki online
"In addition to knowing the secrets of the Universe, I can assure you that I am also quite potty trained." -Koenma (Yu Yu Hakusho)

Image

User avatar
Red Cobra
Private First Class
Private First Class
Posts: 184
Joined: Mon Feb 21, 2005 11:37 pm

Post by Red Cobra » Sat Mar 10, 2007 3:51 am

Very very nice blast! Finally an easy to read wiki on how to do eveything. Thanks a lot.
Cop@R3lax
Trusted@Viper

User avatar
joevano
General
General
Posts: 1863
Joined: Sat Jun 18, 2005 1:08 pm
Location: South Bend, Indiana, USA

Post by joevano » Sat Mar 10, 2007 12:19 pm

Blast does get credit for his contributions, but it is a group project. Many of the people from the IRC channels (#bzflag, and others) have been contributing to it.

Just so you are aware, the url will be changing slightly soon, when the rewrite rules are done. We will be officially announcing it and making references to it on the official BZFlag sites when that happens.

User avatar
Red Cobra
Private First Class
Private First Class
Posts: 184
Joined: Mon Feb 21, 2005 11:37 pm

Post by Red Cobra » Sat Mar 10, 2007 1:30 pm

Sry bout that. Very good job to all the people who worked on this project. It's really helpful.
Cop@R3lax
Trusted@Viper

User avatar
GMMan
Private First Class
Private First Class
Posts: 186
Joined: Sat May 13, 2006 9:32 pm
Location: On the time-space continuum

Post by GMMan » Sat Mar 10, 2007 3:42 pm

Hmmm.... I suppose that was me talking about that wiki. No, it never did. Was on this free wiki request but no one cared.
I haven't touched BZFlag for years, but maybe sometime I'll make a comeback.

I'm on Twitter. And I mess with webOS. This signature is not a blog.

User avatar
joevano
General
General
Posts: 1863
Joined: Sat Jun 18, 2005 1:08 pm
Location: South Bend, Indiana, USA

Post by joevano » Sat Mar 10, 2007 3:47 pm

GMMan wrote:Hmmm.... I suppose that was me talking about that wiki. No, it never did. Was on this free wiki request but no one cared.
I'm confused. What are you trying to say here?

Post Reply