Description Jarmo Tikka (reporter) 2008-12-30 11:31:18 UTC

STEPS TO REPRODUCE THE PROBLEM:

Go to maemo.org and try to find out what documents and examples are available
for certain tehnology area or to have an overview of the whole documentation
available.

EXPECTED OUTCOME:

From maemo.org front page it is clear what is the latest maemo release and
where it is documented. No need to go through the whole menu structure to find
out that. For latest (and older) maemo releases available documentatin can be
found also based on technology are it covers (in addition to maemo release).

ACTUAL OUTCOME:

To find out what is the latest maemo release you have to go through
annuncements or site menu structure. To find out documentation to latest maemo
release you have to go through all submenu items from Development menu (that
include documentation for all releases)

OTHER COMMENTS:

See bug 3803 for earlier discussions. Some key comments copied below.
****
Changed Severity to enhancement and target milestone to Fremantle. Current
maemo.org has usability problems that it is very difficult to find anything
from the site :). 

I just copy this item below from my todo list for maemo.org as proposal for new
spec:

mameo.org usability issues
- current structure of site does not allow user to see what maemo release
specific documentation is available in maemo.org without going through the
whole menu structure 
- enable easy access to all maemo release specific documentation with new
release specific summary pages 
- release info pages include basic release info and links to all release
specific documentation 
- get rid of current site structure where user has to first choose (or quess)
what type of document he needs to read (API doc, how-to, training material,
...) and then choose for which maemo release that needs to be done (2.2, 3.x,
4.0.x 4.1.x, ..) 
- instead change maemo.org site structure to support easy access for maemo
release specific documentation (maemo release summary pages) 
- instead change maemo.org site structure to support easy access for maemo
technology area specific documentation (maemo technology summary pages) 
- review maemo.org front page to better support easy access to maemo.org
services and site sections for the latest maemo version (e.g. to the latest SDK
release, documents, search, wiki, bugzilla, planet, garage, mailing lists,
repositories, lxr, ...) 
- add site map page (information and links to maemo.org pages and sections on
one page) 
  - maemo mailing lists 
  - IRC channels 
  - RSS feeds 
  - repositories available and their usage 
  - bugzilla, wiki, planet, etc 
  - external maemo related sites 
  - most important open source projects maemo uses/hosts 
--------------------------------------------------------------------------------
Comment #5 from luarvique@gmail.com   2008-12-08 16:36:26 GMT+3 [reply] 
I would suggest setting lower, more practical, short range goals:

1. Survey available documentation/howto/reference pages.
2. Create a SINGLE easily navigated page with all the documentation
   for the latest release (4.1 and whatever parts of 4.0 still apply).
3. Create similar SINGULAR pages for each older release we have got the
   documentation for.

These goals are easier to achieve, do not really rely on Fremantle, and will be
of immediate help to developers.

Please, refer to the "Development" section of the mockup at

http://fms.komkon.org/MaemoMain.html

This is how I see the single-point documentation page.
--------------------------------------------------------------------------------