Open Source Writers Group: Roadmap

Revision History
Revision 0.1 November 2, 1999 Revised by: Deb Richardson - deb@oswg.org

Table of Contents
1. Short-Term Development Plans
1.1. Automate Documentation Generation
1.2. Improve Open-Content DocBook Docs
1.3. Create a Proper Volunteers/Projects Database
1.4. Improve and Add to Existing Communications Channels
1.5. Develop a Cooperative Relationship with the OSRT and Similar Groups
2. Long-Term Development Plans
2.1. Open-Content Documentation Symposium/Conference
2.2. Open-Content Documentation Grant Program
2.3. Open-Content Documentation Awards
3. Further Future Development

1. Short-Term Development Plans

Currently, the OSWG has four mailing lists, a website, and a CVS tree. These are a good start towards establishing a foundation for the project, but there is definitely more work to be done.

1.1. Automate Documentation Generation

First off, the automatic generation scripts that turn the DocBook SGML instances contained in the CVS tree have to be completed. These scripts are currently (as of Nov 1, 1999) in the "testing" phase, and should be fully automated within a week or so. More scripts are needed, however, including db2man (for man pages) and db2ascii (for plaintext ascii). Current scripts (which are part of the docbook-tools suite) enable the autogeneration of HTML, PS, PDF, DVI, and TEX formats.

1.2. Improve Open-Content DocBook Docs

Second, the OSWG must increase the quantity and quality of it's DocBook-related resources. Ideally, the OSWG will have DocBook documentation written by one or more OSWG members that includes templates, tutorials, various HOWTOs and FAQs, etc. The purpose of these resources would be to make it as easy as possible for new people to begin writing and submitting documentation in valid DocBook format.

1.3. Create a Proper Volunteers/Projects Database

Also on the OSWG TODO list is the creation and population of a volunteers/projects database that will automate the process of registering volunteers and projects and adding those to the OSWG website. The database will also provide some functionality towards automating the process of matching volunteers to projects and vice-versa. The "documentation wishlist" will also be included, as will all OSWG-initiated projects.

1.4. Improve and Add to Existing Communications Channels

In order to further open the channels of communication, it is hoped that the OSWG will be able to set up an IRC server (ideally irc.oswg.org) to host IRC channels for any documentation project that wishes to take advantage of this service. Naturally, #oswg will be the OSWG's own channel. This shouldn't be difficult to arrange.

1.5. Develop a Cooperative Relationship with the OSRT and Similar Groups

The OSWG could do valuable work with the Open Source Research Team that is part of MetaLab. The OSRT is doing some extremely interesting work regarding metadata and open-source documentation, and the OSWG could and should work with them to improve their ideas and implementations, as well as acting to educate and recruit people to help with the future iterations of this project.