Online style manuals for writing procedures?
Online style manuals for writing procedures?
(OP)
Does anyone know of any online style manuals related to business writing that include such topics as standard operating procedures? I'm specifically looking for external guidance that addresses such issues as outline numbering abuses, e.g.:
- Do we really need seven indent levels that give us section 6.5.3.4.10.2.3 ?!?
- Must every freakin' paragraph (sometimes even sentences and list items!) within a section have its own number?
- etc...





RE: Online style manuals for writing procedures?
http
To answer you specific questions:
No, not on a routine basis, but sometimes it winds up that way.
Yes. You will understand why if you ever need to transmit comments or questions about a procedure that it under-numbered and you are forced to write something like:
"In section 2.4.5, paragraph 17, seventh bullet, second sentence the manual states...."
RE: Online style manuals for writing procedures?
That looks like me filling out a form 337.
B.E.
RE: Online style manuals for writing procedures?
RE: Online style manuals for writing procedures?
When I send out bid packages, there are usually a lot of sub-divisions.
I like the divisions because when you have a question or comment, you can say "1.2.5.7.13.5.7 Exception. The material to be provided is 316SS instead of 304SS" instead of "1.2.5.7 Thirteenth sentence, fifth point, seventh item". It shortens the reference. Also, "1.2.5.7.13.5.7" is searchable. In a long document, it is a huge help.
"Do not worry about your problems with mathematics, I assure you mine are far greater."
Albert Einstein
Have you read FAQ731-376 to make the best use of Eng-Tips Forums?
RE: Online style manuals for writing procedures?
A clean house is a sign of a broken computer.
RE: Online style manuals for writing procedures?
1.2.3.4.5.6.7 is no more searchable than 1.2.3.4 and 2.1.2.3.
Your question was for some guidance for business writing, then accepted good practice is not to exceed four levels. That is not to say that you cannot have your own weird system. But then do not ask for what is generally done.
What I have seen work good too, at least at one large A/E firm, to number eveyline on each page. Then you can simply refer to them as line 23 on page 5, for example. Use indents to arrange paragraphs and subpara. Even there the practice was not to have more than four indents. Limitation to this was, it worked best only when hard copies only were considered official release.
RE: Online style manuals for writing procedures?
If you are specifically asking about standard operating procedures that have some risk associated with there being completed properly (safety, environmental, financial) then I think you are already starting down the wrong path. I used to use an outline structure for writing operating procedures but after reading a reference in regards to Process Safety Management (I really wish I could find it right now). In it there was some very helpful discussion about the clarity and simplicity required. It showed the 'wrong' ways to write procedures. Outline formats were one of them. At first I thought that this was a bit of nonsense but with back-up information and documented incidents related to poorly written procedures I was sold.
Now to find where I put that thing......
RE: Online style manuals for writing procedures?
STANDARD PRACTICE
TECHNICAL MANUALS
GENERAL PREPARATION AND ASSEMBLY INFORMATION
(available at https://www.logsa.army.mil/pub/40051-1.PDF)
xnuke
"Do you think you used enough dynamite there, Butch?"
Please see FAQ731-376 for tips on how to make the best use of Eng-Tips.
RE: Online style manuals for writing procedures?
Maybe because I'm not a computer geek, and have never had an affinity for computers, I find looking for things in books a whole lot easier and less time-consuming than seeking the same information on line. It might be a different story if I had grown up with computers, but since I never touched one until I was 41 makes something of a difference in my attitude towards them, and the fact that I have a strong basis in old-fashioned research techinques and tools. I don't despise the usefulness of the computer and the internet for research - it is another tool - but I don't discard older, tried-and-true methods, either.
(And then there's the rhetorical question: Why is "Help" never of any help at all?)
RE: Online style manuals for writing procedures?
Books are great sadly my current employer doesn't maintain an extensive library like my last one. I buy the odd book but the prices of many engineering tomes limits me to just the odd one. Internet access is however available so whilst you have to seriously weigh the validity of anything you find it has become invaluable.
Ken
RE: Online style manuals for writing procedures?