[Asterisk-doc] a few lines

[Nicholas Bachmann]

Leif Madsen wrote:

>>-----Original Message-----
>>From: asterisk-doc-admin@lists.digium.com [mailto:asterisk-doc-
>>admin@lists.digium.com] On Behalf Of Randy Resnick
>>Sent: Friday, June 11, 2004 2:04 PM
>>To: asterisk-doc@lists.digium.com
>>Subject: Re: [Asterisk-doc] a few lines
>>
>>Randy Resnick wrote:
>>
>>Errr,
>>
>>  ***ADD***: If a mailbox to be checked is not in the default context in
>>  voicemail.conf you must explicity provide the context as in
>>
>>  		mailbox=1000,2000@smokers,2001@drinkers
>>
>>where mailbox 1000 is in defaul, 2000 is in a voicemail.conf context
>>called smokers and 2001 is in the context called drinkers.
>>
>>small typos/errors
>>
>>from Hardware installation where some errors were introduced:
>>
>>  If you are dedicating the computer to Asterisk, free up as many IRQs as
>>possible by disabling USB, serial and parallel port support in the BIOS.
>>Otherwise, you still will want to free as many as possible.
>>
>>from X100P paragraph
>>
>>The only difference between an X100P and X101P is a slight difference in
>>chips, but makes no difference to it's operation.
>>
>>Suggest you change this to
>>
>>The only difference between the X100P and X101P is a slight difference
>>in their respective chips, but this has no effect on their use with
>>asterisk.
>>    
>>
>
>Your comments have been added to the book.
>
>  
>
>>Note that using It's to mean something belonging to or related to 'it'
>>has to be one the most common grammatical error in English writing.
>>Someone might want to grep the whole book for "[Ii]t's" and make sure
>>all of these are contractions of "it is."
>>
>>The other usage "ain't correct" :)
>>    
>>
>
>This is very true.  Right now I am trying to focus on getting areas filled,
>then will do editing at a later date.  If however people submit grammatical
>changes as we go, I will definitely add them.
>  
>
I was thinking of posting a "grammar guide" of common mistakes I've seen 
in the book for people to think about when writing.  Besides its/it's, 
I've seen a few like this:

Nicholas' dog (incorrect)
Nicholas's dog (correct)

I like apples, oranges and bananas. (incorrect)
I like apples, oranges, and bananas. (correct)

When a user enters the MeetMe, they will hear an announcement. (incorrect)
When a user enters the MeetMe, he will hear an announcement. (better or 
"he or she will hear an announcement", but please don't mix pronoun forms)
When entering the MeetMe, the user will hear an announcement (bestest)

The yarn was spun by my Aunt Sally. (Bad, but correct)
Aunt Sally spun the yarn. (Good, in active voice).

I am lactose intolerant, therefore, I don't drink milk in the company of 
others. (incorrect)
I am lactose intolerant; therefore, I don't drink milk in the company of 
others. (correct... use ;s to join independent clauses)

If she'll buy me a ticket, I will go out to see her. (incorrect)
If she buys me a ticket, I will go out to see her. (good)

Thats enough to get everybody started on the road to better grammar.  If 
you have a minute, copies of Strunk's _Elements of Style_ can be found 
on the Internet.

Nick