[super] Major Overhaul and Extension of CKAN Documentation

[rgrp]

Child tickets:

• #1041 Start Using the CKAN Wiki for Tutorial-style documentation
• #1192 Convert CKAN Sphinx docs into admin/reference manual

Previous super ticket (from 3m ago): ​http://trac.ckan.org/ticket/927

• CKAN 1-page overview (for enterprise and for data hackers)
• Administrator's Guide (including install)
• Extensions Guide
• Separate CKAN.net info from Software Documentation (?)

Also now a wiki page with more detail: ​http://wiki.ckan.net/Documentation_Plans

Minor Items

[sebbacon]

The guys at Wikimedia also produced this spreadsheet including notable users and features of other software. Could be useful.: ​https://spreadsheets2.google.com/ccc?authkey=CLWu1cgP&hl=en&key=tYiwc9kUVLLlALOQEzFqujw&hl=en&authkey=CLWu1cgP#gid=0

[lucychambers]

Replying to rgrp:

Previous super ticket (from 3m ago): ​http://trac.ckan.org/ticket/927

• CKAN 1-page overview (for enterprise and for data hackers)
• Administrator's Guide (including install)
• Extensions Guide
• Separate CKAN.net info from Software Documentation (?)

Minor Items

• Include guide on how to configure local filesystem storage, instead of Google storage. (​http://lists.okfn.org/pipermail/ckan-discuss/2011-May/001235.html)

[annapowellsmith]

List of new docs tasks agreed by APS and RGRP:

• Tutorial on the wiki (long-term): Integration with Wordpress and Drupal and Javascript
• Overview of domain model both for average users and for devs
• 2-page glossy brochure
• Vision for CKAN ​http://notebook.okfn.org/2011/04/27/data-hubs-data-management-systems-and-ckan/
• Comparison : use ​http://wiki.ckan.net/Related_Software as starting point - build on wiki - Socrata and OGDI
• Renaming: separation between ckan.org and ckan.net
• More documentation in the code ...
• Config options generated from code or move this to WUI ...

See also proposed overhaul at ​http://wiki.ckan.net/Documentation_Plans

[rgrp]

This was completed 4 weeks ago and can now be marked as complete. See ​http://docs.ckan.org/ and ​http://wiki.ckan.net/ and http://ckan.org/