The internet is a lawless place with knowledge and sarcastic wit the pistols of this wild frontier.
Don't go out without being sufficiently armed.

~Blade

Other places

Ares (Current version: 0.B)

Ares's primary facilities have been moved elsewhere:

  • If you wish to report a bug in Ares, please proceed to its bugtracker.
  • If you'd like to request a feature, register a blueprint.
  • If you have questions or can provide answers regarding Ares's usage, visit the Q&A section.
  • Before you post a new question, you should check the FAQ, though.

Behavior

  • Mind the forum rules.
  • Due to its documentedly horrible quality, we do not offer NPatch support.


Thread Closed 
 
Thread Rating:
  • 0 Votes - 0 Average
  • 1
  • 2
  • 3
  • 4
  • 5
The Great Documentation Dilemma
Author Message
Sergeant Nighthawk Offline
Automatic Greeting System
****
Moderators

Posts: 572
Joined: 14 Oct 2005
Reputation: 4
Post: #1
The Great Documentation Dilemma
Greetings, everyone.
All of us have mentioned at some point to you about the need to hire people to carry out several non-coding tasks to keep Ares progress flowing nice and calmly. Well, take a guess what I'm here to talk about again...

Please note, for those of you who are bound to read this, and send fifty-thousand PMs to my inbox saying "I want to be Ares tester!!!11", this is not a call for testers, this is for other Ares-related activities.

Specifically, we're looking for a Documentation Maintainer.

What this entails is updating our ever-inflating Ares Manual with entries for new features, tags, and options introduced into the game by Ares, and correcting old ones to reflect new information.

What is required is a time commitment (i.e., you need to be active), the ability to work to a tight schedule, the ability to use IRC, basic HTML knowledge, and a good command of the English language.

We're looking for one because the documentation as it stands is currently being updated on-the-fly by the developers. This is not a stable arrangement, as it takes time away from coding, and also results in gaps and holes where features haven't been documented. Basically, Ares will take much longer to release under these circumstances, and without such a documentation maintainer, will likely stop development at the 0.2 release.

And while you're still reading this, please note we are also looking for Project Ambassadors (to handle PR work), Promo Material Creators (description is pretty self explanatory), and User Support Agents (to respond to members with difficulties using Ares).

If you're interested, please send me a PM. Ares' continued existence beyond version 0.2 will depend on people filling these posts.

Thanks.

Nighthawk.
Ares Project Manager.

Ares Project Manager.
[Image: t3wbanner.png]
[Image: cncgsigsb_sml.png]
Open Ares positions: Documentation Maintainer, Active Testers.
PM if interested.
07.06.2011 21:49:12
Visit this user's website Find all posts by this user
Private secondwtq Offline
Junior Member
**
Members

Posts: 9
Joined: 28 Feb 2010
Reputation: 0
Post: #2
RE: The Great Documentation Dilemma
No any comment... Well, I have very silly English, so I may not be qualified for a Documentation Editor, but I will try my best helping Chinese Ares useres with their problems while using Ares.
11.06.2011 06:23:41
Find all posts by this user
Private Zero.Zone Offline
Junior Member
**
Members

Posts: 33
Joined: 5 Apr 2011
Reputation: 0
Post: #3
RE: The Great Documentation Dilemma
Passing..

Whassat...
15.06.2011 12:34:01
Find all posts by this user
~Guest~
Guest
Guests

No info available...
Post: #4
RE: The Great Documentation Dilemma
I know its not matter now, but I will say it: I am disappointed! And this is shame! Totally shame!
You all want stable Ares, you all want to have tool for awesome modding, but you do not want to talk! At least to post something.
Guy said ten days ago ,,Ares' continued existence beyond version 0.2 will depend on people filling these posts."
And nobody even wants to write something like: ,,Sorry guys, its exam time now, I will see about future, maybe I can help about this in future!"
But no, nobody is even pretend to be interested. Everyone is just searching for these forums hopping about new news update, and even more hopping about new release for Ares, just as me.
At least my English sucks, so I cant help, but for sure here are people whose English is good.
~MasterHaosis
17.06.2011 01:03:43
Private Steel Mirage Offline
The Amazing Doc Man
***
Members

Posts: 119
Joined: 3 Apr 2011
Reputation: 1
Post: #5
RE: The Great Documentation Dilemma
Quote:If you're interested, please send me a PM.
What about that is hard to get?
He didn't say reply to or spam the thread.
He didn't say leave useless admonished replies.

FormerAres Documentation Manager
Nobody here but us trees...
Graion Dilach Wrote:Worm, you know this guy is an American lawyer of some sort.
Giggle Good one!
17.06.2011 04:18:43
Find all posts by this user
~Guest~
Guest
Guests

No info available...
Post: #6
RE: The Great Documentation Dilemma
He said that many times over about testers too. And be sure, he will say this again about ,,Ares-related" activities. Just wait until he opens new thread about this again. (in case that he is not serious about Ares-depending of it). I think I am using 0.1.960, and I am satisfied with it, even it is for testers only, so I don't really care about this, but I still care about Ares, in case that he is serious. But really, is he serious that this project depends of this?
17.06.2011 11:07:56
Private Professor_Tesla Offline
Member
***
Members

Posts: 156
Joined: 9 Jun 2007
Reputation: 2
Post: #7
RE: The Great Documentation Dilemma
What, do you think he said that for fun? The reason he said that many times about testers was that we would have periods of good testing, and periods of no testing (or not much). People would sign up to test, and then hardly do any testing, so he had to make other threads requesting new testers. I believe he is serious about the lack of documentation slowing or halting Ares development.

"The present is theirs. The future, for which I really worked, is mine."
- Nikola Tesla

"My - y - my - your - my vision has permutated. My - y - my - your - my plans have followed a path unpredicted by the union of Nod and GDI. Your - my - our - our directives must be reassessed." - Kane/CABAL

[Image: 9853.png]
(This post was last modified: 17.06.2011 11:19:12 by Professor_Tesla.)
17.06.2011 11:17:36
Find all posts by this user
Commander-in-Chief DCoder Offline
Not Ares Anymore
*****
Admins

Posts: 1 756
Joined: 22 Nov 2004
Reputation: 18
Post: #8
RE: The Great Documentation Dilemma
Quote:But really, is he serious that this project depends of this?
Seriously?
How did you learn what new functionality is in .960? By reading either the commit messages or the bugtracker discussions, I bet.

How do you think a hundred new users will learn about new functionality and how to use it? 5 will browse the bugtracker or the forums, 5 will get on IRC and ask us, 10 will decide that they have better things to do than hunt around for a decent manual and give up, and the remaining 80 will create 2500 new threads asking the same questions over and over.
If there's a decent manual, like for 0.1, 60 people will find it sufficient, 5 will get on IRC to clarify something, 5 will find typos in it, and the remaining 30 will create 500 new threads at PPM complaining about how the manual is too difficult to read.

17.06.2011 14:05:29
Visit this user's website Find all posts by this user
Sergeant Nighthawk Offline
Automatic Greeting System
****
Moderators

Posts: 572
Joined: 14 Oct 2005
Reputation: 4
Post: #9
RE: The Great Documentation Dilemma
@Irritating Guest / MasterHaosis / <insert name here>:
Firstly. I have specifically said for people to PM me so as to avoid filling a topic with replies.
Secondly. I am serious. (and don't call me Shirley)
Thirdly. Unlike yourself, I am not in the habit of posting paragraphs of pointlessness. As the project manager, it's safe to assume that when I say the team needs something done, we damn well need it done.

That is all.

Ares Project Manager.
[Image: t3wbanner.png]
[Image: cncgsigsb_sml.png]
Open Ares positions: Documentation Maintainer, Active Testers.
PM if interested.
17.06.2011 17:46:09
Visit this user's website Find all posts by this user
~Guest~
Guest
Guests

No info available...
Post: #10
RE: The Great Documentation Dilemma
(17.06.2011 11:17:36)Professor_Tesla Wrote:  What, do you think he said that for fun?
Not for fun, but to scare people to sign faster. I did not think he is serious about closing whole project because of this.
Well true that, Ares will most likely stay ,,stuck in place" because of this.

(17.06.2011 14:05:29)DCoder Wrote:  How did you learn what new functionality is in .960? By reading either the commit messages or the bugtracker discussions, I bet.


Quote:What, do you think he said that for fun?
Profesor_Tesla, no, I though he said that only to scare people to sign, I did not though he is serious that Ares project will be closed because of that.

[quote='DCoder' pid='18563' dateline='1308312329']How did you learn what new functionality is in .960? By reading either the commit messages or the bugtracker discussions, I bet.
DCoder, I learn it because I read manual. I never read bug tracker or such... I am probably one moder who is not visiting forums and bug tracker. very rarely, but even when I visit, I do not read codes from there. In documentation folder there is manual, you wrote it for reason, and I am reading it. Its always opened when I am modding, in case that I forget some code.

(17.06.2011 14:05:29)DCoder Wrote:  80 will create 2500 new threads asking the same questions over and over.
I did not know about that. Most probably because I do not check out forums and bug tracker, this version is enough for me.

(17.06.2011 14:05:29)DCoder Wrote:  remaining 30 will create 500 new threads at PPM complaining about how the manual is too difficult to read.
DCoder, people are always complain on something, and they WILL complain on something. They will rather complain than trying better to read or understand.
As just random person and modder who is using Ares, I see no difficult n manual. Everything is explained as should be.

DCoder, you forgot one important thing: Prism Forwarding. With that stable functionality in next release,this will be pain in ass to implement for people. That will be subject to open new threads in PPM. Expect that. But I think that many people will ignore this feature because its more complex than standard feature.
18.06.2011 15:34:35
Private MasterHaosis Offline
Junior Member
**
Members

Posts: 5
Joined: 18 Jun 2011
Reputation: 0
Post: #11
RE: The Great Documentation Dilemma
Ah, those were my posts. I should register before, not posting as guest...
18.06.2011 16:06:24
Find all posts by this user
Commander-in-Chief DCoder Offline
Not Ares Anymore
*****
Admins

Posts: 1 756
Joined: 22 Nov 2004
Reputation: 18
Post: #12
RE: The Great Documentation Dilemma
Quote:DCoder, I learn it because I read manual.
And you don't understand why we want to continue having decent documentation?

18.06.2011 18:11:27
Visit this user's website Find all posts by this user
Private MasterHaosis Offline
Junior Member
**
Members

Posts: 5
Joined: 18 Jun 2011
Reputation: 0
Post: #13
RE: The Great Documentation Dilemma
Quote:And you don't understand why we want to continue having decent documentation?
I understand that. And documentation is not decent. it is good, if you ask me. Everything is placed on its place, everything is listed as it should be, simply, and readable... My English is not perfect and yet again I never had trouble no read manual.
I only did not understand if new release of Ares will not happen IN ANY WAY without man who can handle documentation (documentation manager). Now I understand: Basically no guy for this, no new Ares.
(This post was last modified: 18.06.2011 23:40:58 by MasterHaosis.)
18.06.2011 23:40:31
Find all posts by this user
Private Steel Mirage Offline
The Amazing Doc Man
***
Members

Posts: 119
Joined: 3 Apr 2011
Reputation: 1
Post: #14
RE: The Great Documentation Dilemma
Thank you for restating the original post, your input so far has been invaluable. Really. Now can we just let this thread go?

FormerAres Documentation Manager
Nobody here but us trees...
Graion Dilach Wrote:Worm, you know this guy is an American lawyer of some sort.
Giggle Good one!
19.06.2011 04:29:25
Find all posts by this user
Commander-in-Chief Renegade Offline
Lazy Modder
*****
Admins

Posts: 1 906
Joined: 21 Nov 2004
Reputation: 14
Post: #15
RE: The Great Documentation Dilemma
Had you not posted, Steel Mirage, this thread's "last modified" time would have been 5 hours earlier...part of letting a thread go is letting a thread go.

I don't think comments in this thread will be helpful anymore. Those who are interested should PM NH anyway.

Administrative Notice:

Closed.

Forum Rules

(01.06.2011 05:43:25)kenosis Wrote:  Oh damn don't be disgraced again!

(25.06.2011 20:42:59)Nighthawk Wrote:  The proverbial bearded omni-bug may be dead, but the containment campaign is still being waged in the desert.
19.06.2011 11:31:07
Visit this user's website Find all posts by this user
Thread Closed 




User(s) browsing this thread: 1 Guest(s)