API Documentation Status Page

This is a status page for the ​API documentation team. It is intended to be an overview of the current status of the files.

If you are interested in helping out with the API documentation, you should start with ​setting up your environment, and sending a message on the ​mailing list.

One word of warning (which cannot be repeated enough), if you are writing documentation for Haiku, you are absolutely forbidden to have a look at the BeBook in order to prevent any intentional or unintentional copyright infringements.

Workings of this page

The documentation of Haiku's API is a three phase process. Every header file or additional documentation pages go through all the phases, where every phase is completed by a different person.

1. The technical documentation needs to be written. This is the most intense phase. Based on the source, on notes on the ​Haiku website and help from the developer, the initial version of the documentation will be written.
2. After this, there will be a round of technical proofreading, where one of the peers checks if all the documentation is formally correct (in complience with the ​API documentation guidelines) and if the content is correct (does the documentation indeed say what it actually does).
3. The final phase is the spelling and grammar check by someone with a (near-)native level of English.

This page provides a listing of all the files, and which phase it is in. This page is meant as an overview. If you actually want to claim a task, keep in mind the following guidelines:

1. You should send an e-mail to the mailing list on which task you are going to perform, and you should update this page. In case of any confusion that might rise, the mailing list has precendence over this status page.
2. Claims for tasks are valid for up to two weeks until the last sign of life on the mailing list. If you are unable to perform a claimed task, please be so kind to free it for someone else to pick up.
3. Claims for a certain phase can only be made if the one of the previous phase is completed.

Example overview table:

File	Phase I	Phase II	Phase III
Archivable.dox	Niels Sascha Reedijk - 2007-04-16	Piet Paulusma - 2007-04-20

• The filename is linked to the log that is in ViewSVN on Berlios.
• The background color for an open tasks is red.
• The background color for a task in progress is orange.
• A finished task has the green background.
• The dates behind the names are in case of a claimed task, the date of the claim, and in case of a finished task, the date of checkin (which should be updated by the person who checked the change in).

Application Kit Overview

File	Phase I	Phase II	Phase III
Kit Introduction	Niels Sascha Reedijk - 08-08-2007
Messaging Introduction	Niels Sascha Reedijk - 08-08-2007 Needs a second pass
AppDefs.h
Application.h
Clipboard.h
Cursor.h
Handler.h
Invoker.h
Looper.h
Message.dox	Niels Sascha Reedijk - 15-10-2007
MessageFilter.dox	Niels Sascha Reedijk - 28-09-2007
MessageQueue.h
MessageRunner.h
Messenger.h
PropertyInfo.h
Roster.h

Driver Overview

File	Phase I	Phase II	Phase III
USB3.dox	Niels Sascha Reedijk - 2007-05-17	Michael Lotz - 2007-05-18 - unconfirmed
USB_spec.dox	Niels Sascha Reedijk - 2007-05-17	Michael Lotz - 2007-05-18 - unconfirmed
fs_interface.dox	Ingo Weinhold - 2007-04-04
	Niels Sascha Reedijk - 2007-05-21
fs_modules.dox	Ingo Weinhold - 2007-04-04
	Niels Sascha Reedijk - 2007-05-21
usb_modules.dox	Niels Sascha Reedijk - 2007-05-17	Michael Lotz - 2007-05-18 - unconfirmed

Support Kit Overview

File	Phase I	Phase II	Phase III
Archivable.dox	Niels Sascha Reedijk - 2007-04-16	David Weizades - 2007-05-25	Thom Holwerda - 2007-06-04
Beep.dox	Niels Sascha Reedijk - 2007-04-16
BlockCache.dox	Niels Sascha Reedijk - 2007-04-16	David Weizades - 2007-05-22	Thom Holwerda - 2007-05-28
BufferIO.dox	Niels Sascha Reedijk - 2007-04-02
DataIO.dox	Niels Sascha Reedijk - 2007-04-02
Debug.dox
Errors.dox
Flattenable.dox	Niels Sascha Reedijk - 2007-04-02
List.dox	Niels Sascha Reedijk - 2007-04-16	David Weizades - 2007-05-22	Thom Holwerda - 2007-05-23
Locker.dox	Niels Sascha Reedijk - 2007-04-02
SupportDefs.dox	Niels Sascha Reedijk - 2007-04-16
parsedate.dox	Niels Sascha Reedijk - 2007-04-16
Stopwatch.dox	Niels Sascha Reedijk - 2007-04-16
String.dox	Niels Sascha Reedijk - 2007-04-16
support_intro.dox	Niels Sascha Reedijk - 2007-04-16
syslog.dox	Niels Sascha Reedijk - 2007-04-16	Alan Smale - 2007-05-22
TLS.dox	Niels Sascha Reedijk - 2007-05-24
TypeConstants.dox	Niels Sascha Reedijk - 2007-04-16
UTF8.dox