(categorise) |
|||
| (9 intermediate revisions not shown) | |||
| Line 7: | Line 7: | ||
If you notice an improvement which could be made to the Developer Guide, you have a few options: | If you notice an improvement which could be made to the Developer Guide, you have a few options: | ||
| - | * Fix it yourself (if it's already in the guide); let the meego-sdk mailing list know if it's anything significant ( | + | * Fix it yourself (if it's already in the guide); let the meego-sdk mailing list know if it's anything significant (such as you removed or added a large chunk of text; fixing typos is OK and you don't need to tell anyone etc.) |
* Write a new page yourself and log a request to have it added to the Developer Guide; include the title of the page in the title of the bug | * Write a new page yourself and log a request to have it added to the Developer Guide; include the title of the page in the title of the bug | ||
* Log an enhancement request for a page to be added to the Developer Guide if you can't or won't write it yourself; be as specific as you can about the content you expect to see in it | * Log an enhancement request for a page to be added to the Developer Guide if you can't or won't write it yourself; be as specific as you can about the content you expect to see in it | ||
| Line 17: | Line 17: | ||
Documentation issues should also be attached to the appropriate version of the Developer Guide (corresponding to MeeGo versions): check the version of the Developer Guide you're viewing and select the appropriate version when making your request. | Documentation issues should also be attached to the appropriate version of the Developer Guide (corresponding to MeeGo versions): check the version of the Developer Guide you're viewing and select the appropriate version when making your request. | ||
| + | |||
| + | '''Note that none of the above stops you adding new material to the wiki as you see fit: the guidelines are just there to help improve the quality of the "official" developer guides and prevent duplication of effort. If you want to create your own developer guide in the wiki, separate from the "official" guide, there is nothing to stop you doing this.''' | ||
=== Picking up documentation tasks === | === Picking up documentation tasks === | ||
| - | Documentation bugs can be taken on by any MeeGo SDK community member. Please review the [[SDK Tutorial | + | Documentation bugs can be taken on by any MeeGo SDK community member. Please review the [[SDK/Tutorial content]] page when authoring new content. |
Bugs are closed at the discretion of the MeeGo SDK community; for example: | Bugs are closed at the discretion of the MeeGo SDK community; for example: | ||
| Line 29: | Line 31: | ||
== Content categorization == | == Content categorization == | ||
| - | + | See [[Developer guide content organization]] for some suggestions about how to categorise developer guide pages. | |
== Licensing == | == Licensing == | ||
| - | Creative Commons Attribution 3.0 is the | + | Creative Commons Attribution 3.0 is the license for the wiki. Documentation uses the same license. |
| + | |||
| + | [[Category:SDK]] | ||
A set of documentation principles describing the documentation process and the different licenses for different documents.
Contents |
The intention behind the Developer Guide is to sign-post the most-accurate information available to MeeGo developers. As such, it should not be added to in an ad hoc fashion or subjected to massive restructurings without community involvement. Usual MeeGo SDK community channels can be used to discuss changes.
If you notice an improvement which could be made to the Developer Guide, you have a few options:
Bugs and enhancement requests are logged on http://bugs.meego.com/, inside the Documentation product, SDK docs component.
Documentation issues should also be attached to the appropriate version of the Developer Guide (corresponding to MeeGo versions): check the version of the Developer Guide you're viewing and select the appropriate version when making your request.
Note that none of the above stops you adding new material to the wiki as you see fit: the guidelines are just there to help improve the quality of the "official" developer guides and prevent duplication of effort. If you want to create your own developer guide in the wiki, separate from the "official" guide, there is nothing to stop you doing this.
Documentation bugs can be taken on by any MeeGo SDK community member. Please review the SDK/Tutorial content page when authoring new content.
Bugs are closed at the discretion of the MeeGo SDK community; for example:
See Developer guide content organization for some suggestions about how to categorise developer guide pages.
Creative Commons Attribution 3.0 is the license for the wiki. Documentation uses the same license.