doc-strategy-notes

Differences between revisions 1 and 2
Revision 1 as of 2011-05-20 20:12:29
Size: 3842
Editor: 64
Comment: initial pasting of text
Revision 2 as of 2011-05-20 20:15:31
Size: 3896
Editor: 64
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
Line 4: Line 5:
Line 5: Line 7:
Line 6: Line 9:
Line 9: Line 13:
Line 10: Line 15:
Line 12: Line 18:
Line 13: Line 20:
Line 14: Line 22:
Line 15: Line 24:
Line 17: Line 27:
Line 18: Line 29:
Line 20: Line 32:
Line 22: Line 35:
Line 25: Line 39:
Line 26: Line 41:
Line 27: Line 43:
Line 28: Line 45:
Line 29: Line 47:
Line 30: Line 49:
Line 31: Line 51:
Line 32: Line 53:
Line 33: Line 55:
Line 34: Line 57:
Line 35: Line 59:
Line 37: Line 62:
Line 38: Line 64:

This page contains the notes that were originally posted on the doc-team strategy blueprint page: ==================================

Maybe a sort of "Desktop Integrated Forum", based (maybe) on IRC. It would be a Very accessible button on the desktop, you clic, and you have an IRC window opened with people to answer you.

These people could be : Every Ubuntu user who feel able to help on specials topics.

When the user ask his question, subject is detected, tagged (ubuntu one, libre office....), and some of the peoples who can help with this, get a notification on there desktop, if they are logged. This could be only for very easy tasks. Maybe this "askbox" could be accessible on the Web too.

All of this could be a desktop integrated (and language integrated) version of AskUbuntu. What do you think? It very ambitious, but it would be a big plus in front of others OS.

* The intention of this session is to gather a set of ideas for the docs team to lay out a strategy for next cycle.

* Kyle Nitzsche: great work from the docs team this cycle. Changed from docbook to mallard and gnome3 topics. Quick turnaround at the end to modify that content for ubuntu/unity. Kudos to Jim and the rest of the team for the current momentum in the Ubuntu Documentation Project. Best docs yet (even though not ranslated on release)

  • +1 on working to create a much more public strategic plan that can guide decisions, balance tradeoffs

Translations

  • - Even before beta release

* User assistance: remote desktop is another way of providing assistance, which hasn't been used so far, but it's non trivial to set up. We've got an opportunity with Ubuntu One to act as the middle man as a remote server

* Some things we could see in the future: runtime detection of desktop type through dbus, so that conditional help can be presented

OMG Ubuntu, webupd8 & AskUbuntu - Almost all of OMG!Ubuntu is copyrighted **

- Even AskUbuntu has CC-BY-SA 3 but has very specific attribution requirements

** Hey, the Natty guide (at http://omgubuntu.co.uk/natty ) is free for the docs team / Ubuntu Manual Project to reuse and modify. It should be licensed under creative commons attribution. If there are any issues with licensing, please email me at humphreybc@ubuntu.com and I'll sort it out (we don't know much about licensing) It needs to be CC-BY-SA 3.0 please

Ah righto, I'll change that ASAP then. I actually thought it was already changed. cool, thanks for sharing it no probs! hope it helps

- xslt validation of style (for example topic must/or must not have description)

Proposed goals


* Make help.ubuntu.com the Ubuntu Documentation Portal

- should become THE portal for access to all help and thriving community with links to other web pages/portals, and needs to be localized or link to the loco's localizations

- locos needs transformation help from their own documentation

* Decide what are the required output formats and what souce format is best to support them via what toolchain

* More automated translation integration workflow

* docs team shall write a style guide that will specify the format/content of each Ubuntu Help Center topic

  • - Gnome Docs hasn't figured out a style guide yet for Gnome 3

- user submitted topics with low technical barrier with ubuntu docs editorial board to review and promote the best (ratings?) to core ubuntu help center (on-disk and online)

* Decide upon a strategy about which topics should be on disk, what should be online

* Update Documentation Team wiki documentation to describe mallard and how to get fixes in to the docs webbased mallard editor / doc writing tool ?

* Provide Modularization

- modularization of topics (desktop help? other generic help? remix modules as desired into "books") Localization of text and images at module level

j1mc/doc-strategy-notes (last edited 2011-05-20 20:21:26 by 64)