best_practices_for_collaborative_document_development
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
best_practices_for_collaborative_document_development [2010/02/12 12:15] – created tkbletsc | best_practices_for_collaborative_document_development [2010/04/27 17:13] (current) – tkbletsc | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Best practices for collaborative document development ====== | ====== Best practices for collaborative document development ====== | ||
- | * For any document of non-trivial length and more then 2 people, use some kind of shared access: | + | * For any document of non-trivial length and more than 2 people, use some kind of shared access: |
* Source control (subversion, | * Source control (subversion, | ||
* Single shared-storage Office documents with change tracking | * Single shared-storage Office documents with change tracking | ||
* Google docs | * Google docs | ||
* etc. | * etc. | ||
- | * Agree on minutae early: naming, style, point-of-view, | + | * Agree on minutae early: naming, style, point-of-view, |
- | * Don't let an individual or part of the team go off and write part of the doc in isolation for an extended period of time | + | * Don't let an individual or part of the team go off and write part of the doc in isolation for an extended period of time. |
- | * Unless your writers have worked with each other for a while, the text you get back won't fit with the flow and voice of other sections | + | * Unless your writers have worked with each other for a while, the text you get back won't fit with the flow and style of other sections |
- | * There may have been a mis-communication | + | * There may have been a miscommunication |
* There is a tendency to put off completion of the section to near the deadline for the whole document, making editing or a rewrite impossible | * There is a tendency to put off completion of the section to near the deadline for the whole document, making editing or a rewrite impossible | ||
* For large groups, someone needs to be a technical executive have final say in decisions of scope and content. | * For large groups, someone needs to be a technical executive have final say in decisions of scope and content. | ||
* As your team grows, stronger leadership is required to limit meeting length, frivolous discussion, and the effects of standing disagreements. | * As your team grows, stronger leadership is required to limit meeting length, frivolous discussion, and the effects of standing disagreements. | ||
* more tbd | * more tbd |
best_practices_for_collaborative_document_development.1266005737.txt.gz · Last modified: 2010/02/12 12:15 by tkbletsc