There was some discussion on the restructuring of Mozilla.org developer documentation (and documentation in general) in the business breakout at the Mozilla developer convention November 9th. At the moment I do not have much time to give away, to be honest, I have to work a lot to survive, and just don't have the available bandwidth. However, I do have a few ideas for criteria that should determine the new structure for Mozila documentation, and wanted to see what people thought of them. Some of the may be obvious; if so, please forgive.
* _Anything we do should fully support the Link Toolbar that was just recently implemented in Mozilla._ This is important, I think; as Mozilla is now the showcase of this feature, Mozilla.org should be structured to be the showcase for the powerful potential of this new feature, and the intuitive organization it helps to bring about. * All existing documentation should be weighed against its relevance to Mozilla 1.o and should then be labeled either "Classic" (no longer relevant) or "1.0" (needs to be updated for 1.0). * Classic documentation that is not relevant to 1.0 can be put into an archive _with its existing structure intact_, at least in the short term. This prevents us from breaking links, etc., in existing docs and having to fix them as a result: that would be a waste of manpower. There's no point in fixing what's irrelevant anyhow, at least not until the more immediate concern of reorganizing that documentation that _is_ still relevant. Another argument for leaving Classic docs in their existing form would be that users of it may be familiar with its quirks, and revamping it would brutalize their familiarity with it. * All efforts of volunteers and whoever else should be first targeted at defining an intelligent structure for Mozilla 1.0 documentation. 1.0 is Mozilla.org's most important release so far (obviously), and so it needs to be as well documented as possible if we're going to try to get people to use it. * Mozilla 1.0, now in sight, should probably be the target for a relaunch of the Mozilla 1.0 documentation, or as soon after that time as is possible. 1.0 will likely bring a lot more eyes to the site.
