Grammar and Editing
Many companies have their internal style guides that their information developers use. Many companies don't - they prefer to operating flexibility and usually refer to the industry-accepted style guides. Some such style guides, and links to them, are listed below.
!!begin edit note!!
The stuff that should be hyphenated is in bold. The stuff that I'm none too sure about is in italics. But, for all I know, even the bold stuff may be wrong, so please leave your comments. It would help if you also cite the rule while commenting.
!!end edit note!!
I am helping a friend who wanted lessons in English grammar. I find the going rather tough (having slept through grammar classes in school).
Anyways, today, I wanted to send across an exercise in hyphenation and, not being able to lay my hands on real-life techdoc example, I came up with the following:
It was the twenty fifth of December, in the seventy third year of the reign of Kind Edgar, that the saviour was born. On that star studded night when the gentle shepherds were tending their sheep and when the blue jays had gone to sleep, a child was born to white faced Maria. While the sandal shod husband stood and looked, the hay filled manger lit up with the smile of the child. The smile went a skipping, broke into a thousand pieces and ascended the night sky to burn a golden coloured star. The wise men in the east, who had grown old, bearded and heavy hearted awaiting the birth of the saviour, saw the star and exclaimed, "Here comes the world saviour and the sin redeemer." And they ran towards the west. Little did they know that King Edgar had started a faith based census where every evil doer would be asked the following two questions: Is it self evident that life, liberty and the pursuit of happiness is the birth right of all human beings? Is it that all passwords to Hell should be case sensitive? All such evil doers who could not submit their responses in the government issued template were to be thrice whipped and twice drowned before being hanged on the cross till death.
Am posting it here because I too am not too sure about the hyphentaion in a couple of places.
Looking forward to the feedback :)
I am having a spot of trouble with this sentence:
It isn't gender neutral, I told myself, and was going to edit it when it struck me - How do I edit it? I considered the following option:
But cannot use this sentence because the entire document is, otherwise, in the singular.
Am still thinking it over...So, if any one of you can help me in this, it'd be great.