Maemo Wiki Mirror - User contributions [en]

Maemo-Barcelona Long Weekend/Documentation

2009-12-02T06:51:47Z

62.61.94.1: /* Schedule */

= Documentation workshop =

'''This wiki page is complemented by [http://talk.maemo.org/showthread.php?t=34605 this discussion thread]'''

There will be a Documentation workshop in Barcelona, where we will discuss the needs of user and developer documentation during a half day, and have a "docfest" to work on a specific wiki task for another half day.

Just now our minds are being boggled by questions on Maemo documentation. Things like: what kind of info is needed, by what kinds of users, how should it be structured so that everyone finds what they need, what's the easiest way for you to add information, questions, answers, etc? How can we get more and better info onto maemo.org, how can we get beginners up and running in the quickest way possible? What questions are boggling your mind? Where do you look for answers?

And most of all: how should Maemo documentation be produced in the future? How can we ensure that community participation in documentation writing and maintenance continues to be possible?

Join us to brainstorm on this important area!

In addition, we are asking people for short interviews on their exepriences with Maemo documentation throughout the weekend. This involves chocolate!

== Schedule ==

; Friday 4th December
: Attend UX meets Code sessions, and find out expectations developers have of Maemo developer documentation
: Participate in discussions of UX documentation

; Saturday 5th December
: '''Morning:'''
: Brainstorming session, around the following core goal - how can we structure Maemo documentation and infrastructure to best facilitate work on Maemo? This question leads to others:
:* What do Maemo developers expect from documentation on maemo.org?
:* What do community documentation contributors expect from infrastructure?
:* What are the various roles of maemo.org and wiki.maemo.org?
:* How can we ensure that the Maemo wiki grows in a healthy way?
:* Should the focus of efforts be on writing new material or on cleaning up existing material?
:* What are the main places where newcomers look for information?
:* Where do more experienced Maemo community members go for information?

: '''Afternoon:'''
: Working session to improve some content in the wiki and on maemo.org.
:* Consolidate and improve FAQs
:* Improve navigation to wiki from maemo.org & within wiki
:* Work on maemo.org/intro as an introduction & filter page for new Maemo visitors
; Sunday 6th December
: '''Morning:'''
: Continue workshop from Saturday, or participate in [[../UX meets Code | UX meets Code]] workshop (to be decided)

== Participants ==

Maemo-Barcelona Long Weekend/Agenda

2009-11-27T14:47:00Z

62.61.94.1: /* Agenda */

This is a draft agenda, work in progress.

== Friday 4 ==

=== Agenda ===

{| class="wikitable" border="2"
|-
! Time
! Auditorium
! Formación
! UX meets Code
! Documentation
! Localization
|-
| align="right" | 9.00
| colspan="5" align="center" | Acreditación con buen café (o té etc)
|-
| 10.00 - 10.30
| align="center" | '''Benvinguts, Bienvenidos, Welcome'''<br/>''Quim Gil, Maemo Devices @ Nokia''<br/>
| rowspan="2" colspan="4" align="center" |
|-
| 10.30 - 11.30
| align="center" | '''Keynote: José Luis Martínez, VP, Marketing @ Nokia'''
| colspan="4" align="center" |
|-
| 11.30 - 12.00
| colspan="5" align="center" | Más café (o té etc)
|-
| 12.00 - 12.30
| colspan="2" align="center" | [http://open.movilforum.com/ Open movilforum] & Maemo <br/>''Jose A. Vallés'', Head of Open Telefonica
| Start
| Start
| Start
|-
| 12.30 - 13.00
| colspan="2" align="center" | [http://mozilla.org Mozilla] & Maemo''<br/>[https://wiki.mozilla.org/User:Toniher Toni Hermoso], Mozilla project.
|
|
|
|-
| 13.00 - 13.30
| colspan="2" align="center" | Qué ofrece [http://maemo.org maemo.org]
|
|
|
|-
| 13.30 - 14.00
| colspan="2" align="center" | Qué ofrece [http://forum.nokia.com/maemo Forum Nokia]
|
|
|
|-
| 14.00 - 15.00
| colspan="5" align="center" | '''La Hora de Comer''' Citilab Catering
|-
| 15.00 - 15.30
| rowspan="6" valign="middle" align="center" | '''Estrénate con la N900'''<br>Presentación, demos y un buen rato para familiarizarse con ella.
| La plataforma Maemo: arquitectura y conceptos básicos

''Daniel Wilms''
|
|
|
|-
| 15.30 - 16.00
| Interfaz de usuario en Maemo 5

''?''
|
|
|
|-
| 16.00 - 16.30
| rowspan="2" | Introducciones básicas a varias tecnologías:

GTK+/Hildon (''[http://maemo.org/profile/view/agarcia/ Alberto Garcia]'')

Qt (''Jesus'' "Jeez")

Python(''Daniel'')
|
|
|
|-
| 16.30 - 17.00
|
|
|
|-
| 17.00 - 17.30
| Demo: mi primer desktop widget

''[http://maemo.org/profile/view/marcoil/ Marc Ordinas i Llopis]''
|
|
|
|-
| 17.30 - 18.00
| UI from a broken home: The relationship between developers and designers

''Patricia Montenegro''
|
|
|-
| 18.00 - ??.??
| colspan="2" | Setting up the development environment in preparation for the weeken's training
|
|
|-
| ??.??:-
| colspan="5" align="center" | '''Festa Fiesta Party''' (On?)
|}

== Saturday 5 ==
=== Trainings Overview ===
'''Qt on Maemo Training:''' Qt is a cross-platform application framework from Nokia. It is the framework from KDE and will be the future of Maemo and all Nokia Symbian devices.
On this training we will cover both sides of Qt: the QWidget family and the QGraphicsView family (its canvas), besides some of the new Qt 4.6 API's.
The whole training will be fully hands-on, covered by examples, and in the end the audience will have 2hrs to develop their first Qt (fancy) application for Maemo, based on a preset of images, concepts and ideas from the openBossa designers.
Let's hack!

'''First steps to GTK (Hildon):'''

Introduction to GTK for C programmers, how to write a "Hello world" app, how to create a window, add some buttons, ... and how the GTK/Hildon toolkit works overall.

=== Agenda ===
{| class="wikitable" border="2"
|-
! Time
! Formación
! UX meets Code
! Documentation
! Localization
|-
| align="right" | 8.30 - 9.00
| colspan="3" align="center" | '''Acreditación con buen café (o té etc)'''
|-
| 9.00 - 11.00
| align="center" width="300" | '''Qt on Maemo'''<br/>''Jesus Sanchez-Palencia (OpenBossa)<br/> Aleix Pol (KDE)''

'''Introduction and What is Qt?'''<br/>
'''Hands-on Examples''': a more complete hello world, phonon, extending Qt

'''QGraphicsView''': introduction, <br/> QGraphicsScene, items, widgets, very simple example

| Start
| Maemo documentation brainstorming session. ''Mary Nurminen, Titta Väyrynen''
| Start
|-
| 11.00 - 11.15
| colspan="4" align="center" | '''Más café (o té etc)'''
|-
| 11.15 - 13.00
|''' GTK first steps'''

''[http://maemo.org/profile/view/agarcia/ Alberto Garcia]''
| align="center" | Continuación
| align="center" | Continuación Maemo documentation brainstorming session. ''Mary Nurminen, Titta Väyrynen''
| align="center" | Continuación
|-
| 13.00 - 14.00
| colspan="4" align="center" | '''La Hora de Comer'''
|-
| 14.00 - 16.00
| '''QGraphicsLayouts''': Grid, Linear and the <br/>
brand new AnchorLayout

'''Webkit''': introduction to webkit, an
example using webkit (webview, webelement) and anchorlayout + Hands-on

'''State Machine and Animation API's''': intro to State Machine, intro to Animations (vs QTimeLine), an example + Hands-on
| align="center" | Continuación
| align="center" | Continuación
| align="center" | Continuación
|-
| 16.00 - 16.15
| colspan="4" align="center" | '''Más café (o té etc)'''
|-
| 16.15 - 18.00
| '''Porting GNOME applications to Maemo 5'''<br/>''Felipe Erias''
<br/>

+ more
| align="center" | Continuación
| align="center" | Continuación
| align="center" | Continuación
|-
| ??.??:-
| colspan="4" align="center" | '''Tapas!'''
|}

== Sunday 6 ==
=== Trainings Overview ===
Continuation of the courses started on Saturday

=== Agenda ===

{| class="wikitable" border="2"
|-
! Time
! Formación
! UX meets Code
! Documentation
! Localization
|-
| align="right" | 8.30 - 9.00
| colspan="3" align="center" | '''Acreditación con buen café (o té etc)'''
|-
| 9.00 - 11.00
| width="300" | '''Qt Hands-on hacking session:''' developing a more complex example (or your first app) using some of the new Qt 4.6 API's

| Start
| Start
| Start
|-
| 11.00 - 11.15
| colspan="4" align="center" | '''Más café (o té etc)'''
|-
| 11.15 - 12.00
|'''Hacking with the experts'''
| align="center" | Continuación
| align="center" | Continuación
| align="center" | Continuación
|-
| 12.00 - 13.00
|'''Hacking with the experts'''
| align="center" | Continuación
| align="center" | Continuación
| align="center" | Continuación
|-
| 13.00 - 14.00
| colspan="4" align="center" | '''La Hora de Comer'''
|-
| 14.00 - 15.00
| '''Hacking with the experts'''
| align="center" | Continuación
| align="center" | Continuación
| align="center" | Continuación
|-
| 15.00 - 16.00
|'''Hacking with the experts'''
| align="center" | Continuación
| align="center" | Continuación
| align="center" | Continuación
|-
| 16.00 - 16.15
| colspan="4" align="center" | '''Más café (o té etc)'''
|-
| 16.15 - 18.00
| '''Hacking with the experts'''
| align="center" | Continuación
| align="center" | Continuación
| align="center" | Continuación
|-
| ??.??:-
| colspan="4" align="center" | '''Tapas!'''
|}

Maemo-Barcelona Long Weekend

2009-11-26T09:25:31Z

62.61.94.1: /* Documentation */

<center>[[Image:MaemoBCN_back_white.png]]</center>

A call to all Maemo, Linux and open source lovers:

Maemo-Barcelona Long Weekend
December 4-6 @ http://citilab.eu - Check [http://maemo.org/news/events/maemo-barcelona_long_weekend/ who is coming]
Follow on Twitter: [http://twitter.com/#search?q=%23maebar #maebar]
Event @ [http://events.linkedin.com/Maemo-Barcelona-Long-Weekend/pub/163544 Linkedin], [http://www.facebook.com/event.php?eid=181221688634 Facebook]

<div style="font-size: 18px; background-color: #afa; padding: 18px; border: 1px #171 solid; text-align: center;">Registration is '''free''', but '''mandatory''' for planning purposes: '''[http://maemo.org/news/events/registrations/ REGISTER NOW]'''</div>

[http://talk.maemo.org/showthread.php?t=34390 We will raffle one N900 on a 1 year loan for every 50 participants registered]

Everything started willing to organize a '''UX meets Code''' hackfest. Then some local supporters asked about the possibility of having more activities around. Now the schedule is all yours / toda vuestra / tota vostra. See below.

Join the discussion: http://talk.maemo.org/showthread.php?p=364433

== Agenda ==
Work in progress @ [[Maemo-Barcelona Long Weekend/Agenda|Agenda]]

=== Presentación N900 & Maemo 5 ===
Estamos preparando una serie de actividades para usuarios, desarrolladores y medios interesados en Maemo 5 y la Nokia N900. Esperamos concretar la agenda en los próximos días pero lo que es seguro es que vamos a concentrarlo todo en el Viernes 4.

=== Formación para programadores ===
Trae tu portátil y ganas de aprender. Estamos preparando una agenda para los tres días combinando Hildon/GTK+ y Qt con niveles básico y medio. Todo bastante informal, flexible y coordinado por desarrolladores con experiencia práctica. '''[[Maemo-Barcelona_Long_Weekend/Formación|MÁS]]'''

=== UX meets Code ===

About 50 community developers and user experience professionals work together during 3 days. '''[[Maemo-Barcelona_Long_Weekend/UX_meets_Code|MORE]]'''

=== Documentation ===

There will be a Documentation workshop in Barcelona, where we will discuss the needs of user and developer documentation during a half day, and have a "docfest" to work on a specific wiki task for another half day.

Just now our minds are being boggled by questions on Maemo documentation. Things like: what kind of info is needed, by what kinds of users, how should it be structured so that everyone finds what they need, what's the easiest way for you to add information, questions, answers, etc? How can we get more and better info onto maemo.org, how can we get beginners up and running in the quickest way possible? What questions are boggling your mind? Where do you look for answers?

And most of all: how should Maemo documentation be produced in the future? How can we ensure that community participation in documentation writing and maintenance continues to be possible?

Join us to brainstorm on this important area!

In addition, we are asking people for short interviews on their experiences with Maemo documentation throughout the weekend. This involves chocolate!

[[/Documentation | MORE]]

=== Localization ===
Barcelona is a great place to discuss about localization, with a multilingual setting and an excellent track of free software L10n projects pushed by local communities.

Let's work towards the [http://wiki.maemo.org/Objective:Community_localization 2010 Objective Community localization].

If there is enough local interest we could organize practical L10n activities taking Catalan as a test case.

== Llamada a las organizaciones locales ==
Hacemos una llamada a todas las organizaciones locales interesadas en software libre con un interés potencial en Maemo. Mozilla, GNOME, KDE, Hispalinux, Softcatalà, Debian, LUGs, CreativeCommons... Lista no exhaustiva.

Tenemos un modesto presupuesto para esponsorizar viaje y alojamiento de destacados desarrolladores o representantes de proyectos de software libre. Si te interesa regístrate y solicita esponsorización.

== Sponsored participants ==
We have some budget to sponsor the travel and accommodation of selected maemo.org contributors. If you want to request sponsorship do it when registering.

Sponsored participants need to arrange their trip with the travel agency. You will receive the information in the email with the sponsorship approval.

=== Accomodation ===

We have booked 15 double rooms for the accommodation at [http://www.nh-hotels.com/nh/en/hotels/spain/barcelona/nh-cornella.html NH Cornellà].

If you're a sponsored participant please add your name to the [[/Accommodation | Shared Room Allocations]] table.

If you live in Barcelona and are willing to host people, feel free to add your name to the [[/Hosting_in_Barcelona | Hosting in Barcelona]] page.

'''How to get from the Hotel NH to Citilab.eu:''' http://is.gd/4UY7Y

=== Travel ===

It is good to know when people are arriving and departing. If you want to coordinate with other participants please add your name to the [[/Travel | Travel]] table. Please share also the best options to go from the airport to the hotel.

== Participants ==

<div style="font-size: 18px; background-color: #afa; padding: 20px; border: 1px #171 solid; text-align: center;">The wiki list of participants is now obsolete.<br>
'''Please register for this event at the [http://maemo.org/news/events/registrations/ registration page]!'''<br><span style="font-size: 14px;">(You need to register even if you have put your name in this list previously!)</span></div>

[[Category:Events]]

Maemo-Barcelona Long Weekend

2009-11-19T13:59:03Z

62.61.94.1: /* Documentation */

A call to all Maemo, Linux and open source lovers:

Maemo-Barcelona Long Weekend
December 4-6 @ http://citilab.eu - Check [http://maemo.org/news/events/maemo-barcelona_long_weekend/ who is coming]
Follow on Twitter: [http://twitter.com/#search?q=%23maebar #maebar]
Event @ [http://events.linkedin.com/Maemo-Barcelona-Long-Weekend/pub/163544 Linkedin]

<div style="font-size: 18px; background-color: #afa; padding: 18px; border: 1px #171 solid; text-align: center;">Registration is '''free''', but '''mandatory''' for planning purposes: '''[http://maemo.org/news/events/registrations/ REGISTER NOW]'''</div>

[http://talk.maemo.org/showthread.php?t=34390 We will raffle one N900 on a 1 year loan for every 50 participants registered]

Everything started willing to organize a '''UX meets Code''' hackfest. Then some local supporters asked about the possibility of having more activities around. Now the schedule is all yours / toda vuestra / tota vostra. See below.

Join the discussion: http://talk.maemo.org/showthread.php?p=364433

== Agenda ==
Work in progress @ [[Maemo-Barcelona Long Weekend/Agenda|Agenda]]

=== Presentación N900 & Maemo 5 ===
Estamos preparando una serie de actividades para usuarios, desarrolladores y medios interesados en Maemo 5 y la Nokia N900. Esperamos concretar la agenda en los próximos días pero lo que es seguro es que vamos a concentrarlo todo en el Viernes 4.

=== Formación para programadores ===
Trae tu portátil y ganas de aprender. Estamos preparando una agenda para los tres días combinando Hildon/GTK+ y Qt con niveles básico y medio. Todo bastante informal, flexible y coordinado por desarrolladores con experiencia práctica. '''[[Maemo-Barcelona_Long_Weekend/Formación|MÁS]]'''

=== UX meets Code ===

About 50 community developers and user experience professionals work together during 3 days. '''[[Maemo-Barcelona_Long_Weekend/UX_meets_Code|MORE]]'''

=== Documentation ===

There will be a Documentation workshop in Barcelona, where we will discuss the needs of user and developer documentation during a half day, and have a "docfest" to work on a specific wiki task for another half day.

Just now our minds are being boggled by questions on Maemo documentation. Things like: what kind of info is needed, by what kinds of users, how should it be structured so that everyone finds what they need, what's the easiest way for you to add information, questions, answers, etc? How can we get more and better info onto maemo.org, how can we get beginners up and running in the quickest way possible? What questions are boggling your mind? Where do you look for answers?

And most of all: how should Maemo documentation be produced in the future? How can we ensure that community participation in documentation writing and maintenance continues to be possible?

Join us to brainstorm on this important area!

In addition, we are asking people for short interviews on their exepriences with Maemo documentation throughout the weekend. This involves chocolate!

[[/Documentation | MORE]]

=== Localization ===
Barcelona is a great place to discuss about localization, with a multilingual setting and an excellent track of free software L10n projects pushed by local communities.

Let's work towards the [http://wiki.maemo.org/Objective:Community_localization 2010 Objective Community localization].

If there is enough local interest we could organize practical L10n activities taking Catalan as a test case.

== Llamada a las organizaciones locales ==
Hacemos una llamada a todas las organizaciones locales interesadas en software libre con un interés potencial en Maemo. Mozilla, GNOME, KDE, Hispalinux, Softcatalà, Debian, LUGs, CreativeCommons... Lista no exhaustiva.

Tenemos un modesto presupuesto para esponsorizar viaje y alojamiento de destacados desarrolladores o representantes de proyectos de software libre. Si te interesa regístrate y solicita esponsorización.

== Sponsored participants ==
We have some budget to sponsor the travel and accommodation of selected maemo.org contributors. If you want to request sponsorship do it when registering.

Sponsored participants need to arrange their trip with the travel agency. You will receive the information in the email with the sponsorship approval.

=== Accomodation ===

We have booked 15 double rooms for the accommodation at [http://www.nh-hotels.com/nh/en/hotels/spain/barcelona/nh-cornella.html NH Cornellà].

If you're a sponsored participant please add your name to the [[/Accommodation | Shared Room Allocations]] table.

If you live in Barcelona and are willing to host people, feel free to add your name to the [[/Hosting_in_Barcelona | Hosting in Barcelona]] page.

'''How to get from the Hotel NH to Citilab.eu:''' http://is.gd/4UY7Y

=== Travel ===

It is good to know when people are arriving and departing. If you want to coordinate with other participants please add your name to the [[/Travel | Travel]] table. Please share also the best options to go from the airport to the hotel.

== Participants ==

<div style="font-size: 18px; background-color: #afa; padding: 20px; border: 1px #171 solid; text-align: center;">The wiki list of participants is now obsolete.<br>
'''Please register for this event at the [http://maemo.org/news/events/registrations/ registration page]!'''<br><span style="font-size: 14px;">(You need to register even if you have put your name in this list previously!)</span></div>

[[Category:Events]]

Maemo-Barcelona Long Weekend/Documentation

2009-11-19T13:57:19Z

62.61.94.1: /* Documentation workshop */

= Documentation workshop =

There will be a Documentation workshop in Barcelona, where we will discuss the needs of user and developer documentation during a half day, and have a "docfest" to work on a specific wiki task for another half day.

Just now our minds are being boggled by questions on Maemo documentation. Things like: what kind of info is needed, by what kinds of users, how should it be structured so that everyone finds what they need, what's the easiest way for you to add information, questions, answers, etc? How can we get more and better info onto maemo.org, how can we get beginners up and running in the quickest way possible? What questions are boggling your mind? Where do you look for answers?

And most of all: how should Maemo documentation be produced in the future? How can we ensure that community participation in documentation writing and maintenance continues to be possible?

Join us to brainstorm on this important area!

In addition, we are asking people for short interviews on their exepriences with Maemo documentation throughout the weekend. This involves chocolate!

== Schedule ==

; Friday 4th December
: Attend UX meets Code sessions, and find out expectations developers have of Maemo developer documentation
: Participate in discussions of UX documentation

; Saturday 5th December
: '''Morning:'''
: Brainstorming session, around the following core goal - how can we structure Maemo documentation and infrastructure to best facilitate work on Maemo? This question leads to others:
:* What do Maemo developers expect from documentation on maemo.org?
:* What do community documentation contributors expect from infrastructure?
:* What are the various roles of maemo.org and wiki.maemo.org?
:* How can we ensure that the Maemo wiki grows in a healthy way?
:* Should the focus of efforts be on writing new material or on cleaning up existing material?
:* What are the main places where newcomers look for information?
:* Where do more experienced Maemo community members go for information?

: '''Afternoon:'''
: Working session to improve some content in the wiki and on maemo.org.
:* Consolidate and improve FAQs
:* Improve navigation to wiki from maemo.org & within wiki
:* Work on maemo.org/intro as an introduction & filter page for new Maemo visitors
; Sunday 6th December
: '''Morning:'''
: Continue workshop from Saturday, or participate in [[../UX meets Code | UX meets Code]] workshop (to be decided)

Maemo-Barcelona Long Weekend/Documentation

2009-11-19T13:54:51Z

62.61.94.1: /* Schedule */

= Documentation workshop =

There will be a Documentation workshop in Barcelona, where we will discuss the needs of user and developer documentation during a half day, and have a "docfest" to work on a specific wiki task for another half day.

Just now our minds are being boggled by questions on Maemo documentation. Things like: what kind of info is needed, by what kinds of users, how should it be structured so that everyone finds what they need, what's the easiest way for you to add information, questions, answers, etc? How can we get more and better info onto maemo.org, how can we get beginners up and running in the quickest way possible? What questions are boggling your mind? Where do you look for answers?

And most of all: how should Maemo documentation be produced in the future? How can we ensure that community participation in documentation writing and maintenance continues to be possible?

Join us to brainstorm on this important area!

== Schedule ==

; Friday 4th December
: Attend UX meets Code sessions, and find out expectations developers have of Maemo developer documentation
: Participate in discussions of UX documentation

; Saturday 5th December
: '''Morning:'''
: Brainstorming session, around the following core goal - how can we structure Maemo documentation and infrastructure to best facilitate work on Maemo? This question leads to others:
:* What do Maemo developers expect from documentation on maemo.org?
:* What do community documentation contributors expect from infrastructure?
:* What are the various roles of maemo.org and wiki.maemo.org?
:* How can we ensure that the Maemo wiki grows in a healthy way?
:* Should the focus of efforts be on writing new material or on cleaning up existing material?
:* What are the main places where newcomers look for information?
:* Where do more experienced Maemo community members go for information?

: '''Afternoon:'''
: Working session to improve some content in the wiki and on maemo.org.
:* Consolidate and improve FAQs
:* Improve navigation to wiki from maemo.org & within wiki
:* Work on maemo.org/intro as an introduction & filter page for new Maemo visitors
; Sunday 6th December
: '''Morning:'''
: Continue workshop from Saturday, or participate in [[../UX meets Code | UX meets Code]] workshop (to be decided)

Legacy Maemo 5 Documentation/Human Interface Guidelines/Hildonizing an Interface

2009-09-22T07:17:43Z

62.61.94.1: /* Hildonizing an Interface */

=Hildonizing an Interface=
Although HIG is not a guide about migrating a desktop application to its mobile version, this section talks a little about this because often people think about desktop applications when designing interfaces for mobile devices. This leads to common mistakes that compromise the usability of an application. With a limited working area, mobile devices' screens cannot support all the types of widgets that a desktop computer application normally supports.

When developing an application for a mobile device, you must not think of it as a direct translation of one platform to another but rather as an adaption of ways to accomplish the same tasks. Cases that express this adaption are present all over this document but this section takes a special look at them.

By following the principles covered in this section, your application will end up simpler to use and easier to learn.

==Divide and Conquer==
Divide the content to simplify the interface but still have full functionality in a Hildon application. The limited screen size makes it difficult to include and use a large number of controls on the screen at the same time, so, the solution is not to have them together.

For example, consider an email client application that usually has a split view containing on one side a tree view with a list of accounts and respective folders and on the other side a view of a list of messages within the currently selected folder. This is obviously too much for a small size screen and the solution is to divide the contents. So, the first view should display the available accounts for the user to choose one. After the account is chosen, a new view should display the different folders ("Inbox", "Outbox", "Drafts", etc.). Choosing a folder brings up a new view with the list of messages in it.

Keep in mind that the division must be well balanced in the way that things must not be divided to a point where the user needs to navigate a number of views to do obvious things. For example, in the list of messages in the "Inbox" it is likely that next steps for the user are to open a message, delete a message, or create a new one. Hence, a button "Create Message" can be added to the same view where the message list is.

==Do Not Repeat Yourself==
Several desktop applications have repeated functionality for many tasks. For example, you can edit a message from a message list by using the Edit menu from the menubar, by using the popup menu from the mouse right button or even by using the toolbar. In Hildon, in order to simplify and save space for the sake of usability, a task must not be repeated. If the user can create a new message by pressing a button in the interface, then do not add a "Create New Message" menu item.

Legacy Maemo 5 Documentation/Human Interface Guidelines/View Menu

2009-09-22T06:59:27Z

62.61.94.1: /* View Menu */

=View Menu=
The View Menu does not have a traditional menu bar like desktop application menus have. The user activates the View Menu by pressing the application's title area.

The View Menu can hold up to ten menu items and can be divided into two columns -- or one column when in portrait orientation. The View Menu can also include filters. As with selectable items within window views, menu items are in fact buttons, and have no submenus.

[[Image:view_menu.png|400px]]

''Figure 8: A view menu''

Place menu items that perform similar actions ("Previous" and "Next", for example) side by side within a View Menu, and place the most important menu items on the top of the view.

Do not repeat actions that are available from other locations within the application (either in the onscreen interface or via a hardware key) in a menu view.

The View Menu must differ depending on the current view in the application. For example, if users are viewing the "Inbox" subview of an email application, they should access the view menu of the "Inbox" and not the view menu of the root view.

==What if more menus are needed?==
Follow the principles stated in section 1.8, "Hildonizing an Interface," to keep the interface simple yet functional.

Avoid any use of submenus beyond what fits in the 10 menu item slots in the View menu. Even just removing those menu commands that do not fit, should be considered.

The fallback way to support additional menu items (in corner cases) is to have an menu item in the view menu that opens a dialog. That dialog has the action area removed, and contains a dialog wide grid of command buttons in two columns. Visually this is quite similar to the view menu itself.

The less menu items, the better. This is important not only because there are a limited number of items allowed within Hildon, but also because it is good practice to limit the amount of menu items a user is forced to navigate through to achieve a particular action. Again, if some other widget can perform an action within the application's interface, do not include a menu item for it.

==Filters==
Along with typical menu items, you can also use filters within a View Menu. Filters are toggle buttons that can be used for presentation/sorting purposes. For example, sorting a list of contacts alphabetically, or changing the size of icons in a list.

As a general rule, these actions should not change the amount of data displayed, just how that data is displayed.

Always present filters in groups. There should always be at least two menu filters (for example, a menu filter that sorts a list of email messages alphabetically and one that sorts them by date -- not just one filter for alphabetical sorting).

==Menu Keyboard Shortcuts==
Sometimes it makes sense to add keyboard shortcuts to some actions that can also be performed via the View Menu.

If the shortcut performs a common action like creating something new, formatting the text as bold, or undoing a previous action, take care in utilizing common shortcuts that are generally used in other applications. For example, the previous mentioned actions are Ctrl+n, Ctrl+b, and Ctrl+z, respectively.

==Unavailable Menu Items==
Even though it is a common and useful practice in desktop applications to make certain menu items unavailable (for example, "dimmed"), when their actions are not available, Hildon takes a different approach: the menu items must not be visible at all. Although dimmed menu items suggest actions that are unavailable, they can cramp menu space on the small screen and make interaction with available menu items more confusing.

[[Image:view_menu_wrong.png|400px]]

''Figure 9: An incorrect view menu''