New DevMo Roadmap and Progress
Deb Richardson <[email protected]> Thu, 17 Mar 2005 21:54:15 -0500
| Newsgroups | gmane.comp.mozilla.documentation |
|---|---|
| Message-ID | <[email protected]> |
First, let me introduce myself. I'm Deb, and I've been hired by the
Mozilla Foundation to act as the lead driver for the DevMo project.
Over the past couple of weeks I've been formulating project ideas and
plans, and discussing them at length with the other DevMo drivers.
The working-document resulting from this is posted on wiki.mozilla.org,
here:
http://wiki.mozilla.org/wiki/DevMo_Project_Plan_Notes
*****
The "Short Term Goals" section of that document is as follows:
1) Set up a wiki using the MediaWiki software.
2) Set up a basic structure within that wiki towards organizing the
content in meaningful ways. This would be largely, but not entirely,
based off the Documentation Taxonomy.
3) Sort through the existing documentation and other relevant content we
have and figure out what state it's in. This has been started at Links
to Existing Content.
4) Start moving still-valuable content into the wiki within the basic
structure.
5) Start promoting the wiki within the existing developer community.
Hopefully they will take the time to update, edit, and add new content
where they see errors, problems, or holes.
6) Finish branding and layout modifications for the wiki. Create and
brand an initial portal/news-weblog system, then launch to a wider
audience. At that point, if we've done things properly, it will start to
take on a life of its own (with some serious care and feeding in the
background).
*****
Some progress on this list has already been made:
1) A test/development wiki has been set up here:
http://developer-test.mozilla.org/docs/index.php/Main_Page
It's only been there for two days now, so is still very, very much
"under construction" -- the front page is not finished, there's very
little content and structure in the system so far, and the wiki
configuration has to be tweaked a bit still.
2) The structure that /will/ be put in place is reflected on the front
page, with individual wiki areas for each major topic. The list of
current proposed topics (organized by primary audience) can be seen here:
http://developer-test.mozilla.org/docs/index.php/All_Topics
This list of topics is derived from the nacent Document Taxonomy, that I
have been working on over here:
http://wiki.mozilla.org/wiki/Documentation_Taxonomy
3) I've been digging through mozilla.org to find and identify possible
content to migrate into the wiki. The current, and hugely incomplete,
lists are here:
http://wiki.mozilla.org/wiki/Links_to_Existing_Content
http://wiki.mozilla.org/wiki/Organized_Links_to_Existing_Content
If you know of any content that should be on those lists, please feel
free to add it.
4) I've started a "proof-of-concept" piece for the wiki by doing up the
Core JavaScript 1.5 Reference...current (and very incomplete) results
can be seen here:
http://developer-test.mozilla.org/docs/index.php/JavaScript:References:Core_JavaScript_1.5_Reference
5) + 6) -- we're not quite here yet, although the designers have worked
up a MediaWiki skin for wiki.mo that is currently in testing.
*****
All that said, I would very much like to get your feedback on what I've
presented here and on the wikis as the potential future for DevMo. It's
not a small project by any means, but I think it's important we get an
infrastructure in place that makes it as easy and efficient as possible
for people to add and update content within the project.
Unfortunately, while we have a lot of people who would /like/ to
contribute content, most of them simply don't have the time or desire to
spend a lot of time doing writing and markup using traditional
documentation methods.
While not ideal in some ways, I think a wiki makes it significantly
easier for more people who /have/ the knowledge to pass that knowledge
on to others. And really, DevMo is primarily about knowledge transfer,
whether it be through documentation or community.
~ deb ("dria" on irc.mozilla.org)