Meego Wiki
Views

SDK/Documentation guidelines

From MeeGo wiki
< SDK
Revision as of 14:57, 8 June 2010 by Elliot (Talk | contribs)
Jump to: navigation, search

A set of documentation principles describing the documentation process and the different licenses for different documents.

Contents

Developer Guide process

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:

  • Fix it yourself (if it's already in the guide); let the meego-sdk mailing list know if it's anything significant (e.g. 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
  • 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 a bug if you spot a problem on a page (something wrong, something missing) and can't or won't fix it yourself; requests to remove a page, move a page out of the guide etc. can also be made this way

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.

Picking up documentation tasks

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:

  • A request for a new page can be closed when a page is in place which satisifies the requirements specified in the bug.
  • A request to include a new page in the Developer Guide can be closed when the page is linked from the Developer Guide table of contents.

Content categorization

See Developer guide content organisation for some suggestions about how to categorise developer guide pages.

Licensing

Creative Commons Attribution 3.0 is the licence for the wiki; documentation uses the same licence

Personal tools
{"cc_re__cc_re__cc_by_3_0_le": ["ls</h5>\n\t\t<div class=\"pBody\">\n\t\t\t<ul>\n\t\t\t\t<li id=\"pt-login\"><a href=\"http://meego.com/user?destination=wiki_home\" title=\"You are encouraged to log in; however, it is not mandatory [o]\" accesskey=\"o\">Log in / create account</a></li>\n\t\t\t</ul>\n\t\t</div>\n\t</div>\n\n\n\t<!-- footer --> \n\t<div id=\"footer\">\n  \t\t<a href=\"http://linuxfoundation.org\"><div id=\"sponsor\"><strong>Linux Foundation</strong></div></a>\n\t\t\t<ul id=\"f-list\">\n\t\t\t</ul>\n \t\t\t<ul id=\"f-list\">\n\t\t\t\t<li id=\"copyright\">Content is available under <a href=\"http://creativecommons.org/licenses/by/3.0/legalcode\" class=\"external \">Creative Commons Attribution 3.0 License</a>.</li>\n\t\t\t\t<li id=\"privacy\"><a href=\"/MeeGo_wiki:Privacy_policy\" title=\"MeeGo wiki:Privacy policy\">Privacy policy</a></li>\n\t\t\t\t<li id=\"about\"><a href=\"/MeeGo_wiki:About\" title=\"MeeGo wiki:About\">About MeeGo wiki</a></li>\n\t\t\t</ul>     \n\t\t<div class='mw_poweredby'>Powered by MediaWiki 1.16.2</div>\t</div>\n\n\t\n<script>if (window.runOnloadHook) runOnloadHook();</script>\n<script type=\"text/javascript\">\nvar gaJsHost = ((\"https:\" == document.location.protocol) "], "copyright__copyright__copyright": ["", " page can be closed when a page is in place which satisifies the requirements specified in the bug.\n  \u2022 A request to include a new page in the Developer Guide can be closed when the page is linked from the Developer Guide table of contents.\n\nContent categorization\n\nSee Developer guide content organisation for some suggestions about how to categorise developer guide pages.\n\nLicensing\n\nCreative Commons Attribution 3.0 is the licence for the wiki; documentation uses the same licence\n\nPersonal tools"]}