pheffley
ISO this, ISO that !!!
I volunteered for a non-profit health centre, and helped lead a team through their first certification. I also participated in a few other ISO certication / recertification processes. Here are a couple of general things to consider from my school of hard-knocks...
- The document will evolve. It is a living document subject to change as you learn to do things better, or new technology is intorduced. As you learn, you can go back an change existing policies. So don't consider this the be-all-to-end-all type of document. If specifications on security are too lax, or too severe, you can go back and change them.
- The document will need to be reviewed periodically. Your comment about the existing manual being out-of-date is very typical. When documenting your procedures, also plan on how you will review and keep them current. Including a section - to be reviewed every six months at the top of the document may seem okay, but what will you say six months from now!
- for the main policy documents, try to generalize in most areas, but when specifics are required, be specific. This goes back to the review step. Having to change an entire document and get the change authorizated on minor technicalities can be a real waste of time.
- Reference external documents. This is where you can include the detail.
As per management, hey you got the tools. Put together a database that references linked documents, includes the review date, ownership, comments, etc. And provide some categorization codes so the users can quickly find their documents. For example, "global" for use of global variables. "array" for best practices on sizing / resing an array. "api" or "libaries" for any shared libaraies, etc. "security" on security polices. Development, testing, deployment, naming conventions, connection rules, backups, etc. Using a database as a tool helps with the review process, and will help the users reference the procedures in a simpliefied manner -- much easier than flipping pages in a binder.
As Dimandja stated, there are books and books on this. And as Jeremy stated, work at it at a chunk at a time with the realization that the outcome will be a living document.
Richard