WineHQ

Writers

Revision as of 01:10, 14 February 2016 by RosanneDiMesio (talk | contribs) (Add info from Documentation page on old wiki (not enough to warrant a separate page))

Writing Tasks for Wine

In the long run, documentation and coordinating development can be just as important to a software project as coding. Even if you don't feel comfortable programming, there are still many places where Wine could use your help. Language skills are the primary need for maintaining the wiki, translating different portions of the project, and writing good documentation. Understanding the actual code that makes up Wine should only be necessary if you want to help make documentation for developers.

Writing Documentation

Much of Wine's documentation for both users and developers has been ported to this wiki, including the various guides. Keeping the wiki up-to-date by clearing out abandoned and out-dated content, or resolving contradictory statements, gives the wiki a much higher signal-to-noise ratio and makes it easier for both developers and users to find what they're looking for. Editing the wiki just requires writing in MediaWiki syntax. Follow the instructions here to request edit access to the wiki. See Web Content Tasks for tips on editing the Wine wiki.

In addition to the wiki, Wine documentation includes the README file (included in the top level of the Wine git tree), translations of the README in the documentation/ directory of the Wine source tree, and various manpages, which can be found in the same folder as the component they document (most can be found in the tools/ directory, but the manpage for wine itself is located in loader/).

API Documentation

Having our own documentation of the Wine API itself is important for several reasons, the main one being that Microsoft tends to remove all documentation of old APIs (e.g. Win 3.1) as it moves to new ones. Since we are re-implementing the API too, it would probably be a good way for interested developers to learn more about Wine code.

Aspects that are not covered well (or at all) in the "official" documentation, bugs, and inconsistencies are all particularly important. Some examples include little details like what happens if you pass a NULL pointer or if the buffer is too small. Without such documentation, new Wine developers may have a hard time telling whether some strange quirk in the implementation is a genuine bug or if it is actually a (mis)feature that some programs rely on. This will only become more and more important as Wine matures.

There is already a system for automatically generating basic API documentation from the Wine source code. This automated documentation can be found here. If you have an idea for improving the generated documentation, send out an email on the wine-devel mailing list explaining what you would like to try.

Translating

Translating Wine and its documentation are a high priority. See Translating and Translating Documentation for more information.

See Also

  • here and here (different methods result in different values).
This page was last edited on 14 February 2016, at 01:10.