EOOXML project lessons learned
From Grokdoc
| Revision as of 18:51, 24 January 2007 Stevenj (Talk | contribs) ← Previous diff |
Revision as of 18:52, 24 January 2007 Stevenj (Talk | contribs) (→Start with Structure) Next diff → |
||
| Line 19: | Line 19: | ||
| Starting with a skeleton structure of topics or problem areas was key. The nature of Wiki editing is that it is easy to add content in a particular place, or to refine a given section into subsections. But it is difficult to do wholesale movements of content from one section to another | Starting with a skeleton structure of topics or problem areas was key. The nature of Wiki editing is that it is easy to add content in a particular place, or to refine a given section into subsections. But it is difficult to do wholesale movements of content from one section to another | ||
| + | |||
| + | == Communicate with other editors == | ||
| + | |||
| + | == Avoid edit conflicts == | ||
| == Adding content == | == Adding content == | ||
Revision as of 18:52, 24 January 2007
Contents |
Purpose of this page
Let's build a page here that can serve as guidance for future collaborative Groklaw document drafting efforts that need to be completed in a very short time. The basic suggested guidance for building this page (and please feel free to edit this section):
- This page is for future guidance, not discussion of problems we encountered. Use this page's talk page or the Groklaw Lessons Learned thread for such discussions.
- Use this page's talk page to discuss what information should be on this page.
- Neither this page nor its Talk page are for corrections to the text of the EOOXML Issues page. For that purpose, please Use the comments/corrections thread on the Groklaw publication of that that page's text. ???NeedLink.
- Please be careful to use section break markup for every section. That's four consecutive hyphens at the beginning of a line immediately followed by a new line. The section break markup goes at the bottom of a section. (The absence or mangling of the section break markup was one of the problems encountered in the drafting project that led to lost edits.)
- This is incorrect: ---- is the wiki for a horizontal rule, not a "section break". If you want a horizontal rule before each section (sections begin with ==Section Title==), the correct thing to do is to use a style sheet that specifies this. Then there would be no confusing and nonstandard (compared to other MediaWiki wikis) "manual" formatting rules.
- Other? ???
Start with Structure
Starting with a skeleton structure of topics or problem areas was key. The nature of Wiki editing is that it is easy to add content in a particular place, or to refine a given section into subsections. But it is difficult to do wholesale movements of content from one section to another
Communicate with other editors
Avoid edit conflicts
Adding content
Usage of the Discussion Page
Notes and fragments of items to be added, not deemed major at that time should be added in the Discussion Pages. After gathering a few similar items, these fragments can represent significant areas of discussion, warranting an addition into the main page.
Deletion of content
Consensus
It would be good if the editor were to cross check sections to be deleted with discussions at the Talk pages to see if other contributors have had substantial deliberations on the issues first. If the editor thinks the section should be deleted even after the consensus was to include the section, then a short justification in the Talk pages would help.
Section deletes
The editor should not delete large areas of the documents in one go. If possible, the editor should delete it section by section to allow the change tracking to correctly reflect the areas deleted.
