Author Topic: Axe Parser- INCOMPLETE User's Guide  (Read 4107 times)

0 Members and 1 Guest are viewing this topic.

Offline Roboman

  • LV3 Member (Next: 100)
  • ***
  • Posts: 96
  • Rating: +10/-2
  • These peanuts taste so good!
    • View Profile
Axe Parser- INCOMPLETE User's Guide
« 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:
:w00t:
UP-UP-DOWN-DOWN-LEFT-RIGHT-LEFT-RIGHT-B-A-ENTER


I always post in good faith!
http://en.wikipedia.org/wiki/Good_faith
If I end up being rude please tell me and understand!
Spoiler For Spoiler:
:-[  I never mean to say things ... negativley...
I am a bit socialy aqward so I often dont pick up on sarcasm or recognize myself being rude...

...

I am sorry for any offence...

Offline Turtle

  • Not an admin
  • LV1 Newcomer (Next: 20)
  • *
  • Posts: 10
  • Rating: +0/-0
    • View Profile
Re: Axe Parser- INCOMPLETE User's Guide
« Reply #1 on: April 23, 2013, 03:27:38 pm »
Its incomplete? :o What is it missing?

Offline Roboman

  • LV3 Member (Next: 100)
  • ***
  • Posts: 96
  • Rating: +10/-2
  • These peanuts taste so good!
    • View Profile
Re: Axe Parser- INCOMPLETE User's Guide
« Reply #2 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
:w00t:
UP-UP-DOWN-DOWN-LEFT-RIGHT-LEFT-RIGHT-B-A-ENTER


I always post in good faith!
http://en.wikipedia.org/wiki/Good_faith
If I end up being rude please tell me and understand!
Spoiler For Spoiler:
:-[  I never mean to say things ... negativley...
I am a bit socialy aqward so I often dont pick up on sarcasm or recognize myself being rude...

...

I am sorry for any offence...

Offline DJ Omnimaga

  • Clacualters are teh gr33t
  • CoT Emeritus
  • LV15 Omnimagician (Next: --)
  • *
  • Posts: 55943
  • Rating: +3154/-232
  • CodeWalrus founder & retired Omnimaga founder
    • View Profile
    • Dream of Omnimaga Music
Re: Axe Parser- INCOMPLETE User's Guide
« Reply #3 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...
« Last Edit: April 24, 2013, 02:44:23 am by DJ Omnimaga »

Offline Darl181

  • «Yo buddy, you still alive?»
  • CoT Emeritus
  • LV12 Extreme Poster (Next: 5000)
  • *
  • Posts: 3408
  • Rating: +305/-13
  • VGhlIEdhbWU=
    • View Profile
    • darl181.webuda.com
Re: Axe Parser- INCOMPLETE User's Guide
« Reply #4 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 ;)
« Last Edit: April 24, 2013, 02:31:33 am by Darl181 »
Vy'o'us pleorsdti thl'e gjaemue

Offline Roboman

  • LV3 Member (Next: 100)
  • ***
  • Posts: 96
  • Rating: +10/-2
  • These peanuts taste so good!
    • View Profile
Re: Axe Parser- INCOMPLETE User's Guide
« Reply #5 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...
:w00t:
UP-UP-DOWN-DOWN-LEFT-RIGHT-LEFT-RIGHT-B-A-ENTER


I always post in good faith!
http://en.wikipedia.org/wiki/Good_faith
If I end up being rude please tell me and understand!
Spoiler For Spoiler:
:-[  I never mean to say things ... negativley...
I am a bit socialy aqward so I often dont pick up on sarcasm or recognize myself being rude...

...

I am sorry for any offence...

Offline DJ Omnimaga

  • Clacualters are teh gr33t
  • CoT Emeritus
  • LV15 Omnimagician (Next: --)
  • *
  • Posts: 55943
  • Rating: +3154/-232
  • CodeWalrus founder & retired Omnimaga founder
    • View Profile
    • Dream of Omnimaga Music
Re: Axe Parser- INCOMPLETE User's Guide
« Reply #6 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. :)