Omnimaga

Calculator Community => Major Community Projects => The Axe Parser Project => Topic started by: Roboman on April 23, 2013, 03:21:59 pm

Title: Axe Parser- INCOMPLETE User's Guide
Post by: Roboman on April 23, 2013, 03:21:59 pm
You know the user's guide that comes with axe parser?  I think it is very incomplete... :-\  I found alot of typos and grammar errors throughout the book.  Not to mention it has not been updated for 1.2.0 yet... O.O.  We must pull together and fix this issue! :ninja:
Title: Re: Axe Parser- INCOMPLETE User's Guide
Post by: Turtle on April 23, 2013, 03:27:38 pm
Its incomplete? :o What is it missing?
Title: Re: Axe Parser- INCOMPLETE User's Guide
Post by: Roboman on April 23, 2013, 05:56:09 pm
Well, in its current sate, it looks very unprofessional...
I found alot of typos and grammar errors throughout the book.  Not to mention it has not been updated for 1.2.0 yet... O.O
Title: Re: Axe Parser- INCOMPLETE User's Guide
Post by: DJ Omnimaga on April 24, 2013, 02:11:56 am
Compared to almost all readmes of other Ticalc.org games, programs and softwares, I think Axe guide is by far the most professional one that isn't written by KermMartian. It might not be 100% complete, but it gets the job done for explaining how the language works and it comes with an explanation of what each command does (separate file). Plus, like most other languages, there are various third-party tutorials available out there (although the largest one is in French).

Also Quigibo is gone since version 1.2.0. Runer112 took over the Axe project since 2012 so it is possible that he either lacks the tools to edit a PDF file (or that PDF file in particular) or he simply prefers to focus his efforts on improving the language rather than the readme.

Since you're the first person in 3 years to complain about the readme incompleteness (other than myself regarding how Getcalc() works, but it was more a confusing command syntax than readme issue)  care to explain in details what, besides spelling/grammar problems, looks unprofessional and incomplete in the User's Guide?
alot
It just seems a bit odd to me that after 3 years, somebody with only 58 posts (2 of which contains no text), who was at the wrong end of a ban stick once, suddenly starts complaining about the Axe Parser user's guide having *a lot of typos and grammar errors...
Title: Re: Axe Parser- INCOMPLETE User's Guide
Post by: Darl181 on April 24, 2013, 02:30:17 am
Also worth noting is the "User's Guide" is more of a "Getting Started" guide imo. After reading it through a few times, personally I haven't found much of a need to come back to it except when introducing others to the language (the commands list, however..)

The best teacher is experience ;)
Title: Re: Axe Parser- INCOMPLETE User's Guide
Post by: Roboman on April 24, 2013, 03:47:06 pm
:-[  I never mean to say things so negativley...
I am a bit socialy aqward so I often dont pick up on sarcasm or recognize myself being rude...

I meant to say... Axe Parser is so great, that I was a little dissapointed with a few grammar errors(I could not have do it without you) in the guide.  I was saying we(as a community) should screen through the pdf and make sure it has top quality to match Axe Parser...

I am sorry for any offence...
Title: Re: Axe Parser- INCOMPLETE User's Guide
Post by: DJ Omnimaga on April 25, 2013, 12:07:45 am
It's ok. Just make sure that when you criticize something by saying it's incomplete/unprofessional to make sure to explain why in details. You said grammar/typos, but from your sentence it seemed like there might have been other issues with the readme, in which case stating them would have been a good idea. Or in the case where there are typos, since the readme is big and was made by a retired programmer, it might be good to point some of them out in case someone or Runer112 are willing to fix them. :)