Task:Improving maemo.org

m (Reverted edits by 185.86.13.210 (Talk) to last revision by sixwheeledbeast)
 
(74 intermediate revisions not shown)
Line 1: Line 1:
{{100Days agenda}}
{{100Days agenda}}
 +
{{task|completed}}
 +
 +
Connected to [[Task:Content Cleanup]]
 +
 +
== Goals ==
 +
 +
We will:
 +
 +
* Reorganise existing content to allow most common use-cases to be fulfilled    easily
 +
* Create new content where appropriate to fulfill use-cases
 +
* Remove or move information which does not contribute to the most common  use-cases
 +
* Make the site visually attractive and fresh, to match the maemo.org visuals
 +
* Make different maemo.org sites visually consistent
 +
* Ensure the site works well on the tablets
 +
 +
== Non-goals ==
 +
 +
We will not:
 +
* Re-write all content
 +
* Move away from Midgard
 +
* Load the site with heavy content such as flash (see tablet goal).
 +
 +
== Use cases ==
 +
 +
The following are the core use-cases to be addressed by the website rework:
 +
 +
# A new tablet owner wants to install some software on his tablet.
 +
# An interested application developer comes to maemo.org to learn how to write a new application for the tablet.
 +
# An existing application developer comes to maemo.org looking for information on modifying his application for Maemo.
 +
# A Maemo Community member is looking for the latest news from around the world of Maemo
 +
# An interested user wants to know how he can help make Maemo better or give feedback
 +
# A tablet user has a problem which they would like to resolve.
== Content ==
== Content ==
-
* Website information does not suit the needs of newcomers: How to install or do xy on the IT? Where is recent information about OS2008? Is this page, which I am looking at, an outdated or a recent page on maemo.org? What resources are available for me (alias I am confused by unconnected information sources: gronmayer, internettablettalk, planet.maemo, official Nokia site, internettabletschool, maemo ...) Where is a detailed roadmap for Maemo? Is there an application wishlist for OS2008? Where can I give input/ideas as end-user?
 
-
:''All good points, agreed.--[[User:qgil|qgil]] 07:38, 2 June 2008 (UTC)''
 
-
* [http://maemo.org/news/planet-maemo/ planet-maemo] in other languages: For me planet maemo is a very nice aggregation service. This should be available in other languages too. Maybe there should be two versions (per language) of planet maemo: one for developers and one for end users.
 
-
:''We can do multiple languages by creating a folder for each language and adding the proper feeds to those folders. There is also a possibility to display news based on what you have thumbed up and down in the past, but that would be something that can only be done after the planned server upgrade. --[[User:xfade|xfade]] 13:49, 2 June 2008 (UTC)''
 
-
* I'd like to see something like library.gnome.org - searchable content, generated from latest documentation in packages where possible, and updated regularly. --[[User:dneary|dneary]] 10:39, 3 June 2008 (UTC)
 
-
:''Interesting. Currently the API documentation is published in a suboptimal way. If this is feasible to do with our current setting then I guess it would be really useful. Worth being a 100 Days proposal by its own.''--[[User:qgil|qgil]] 10:33, 4 June 2008 (UTC)
 
-
=== Introduction ===
+
We need to change some of the content substantially:
-
* Re-write and expand Introduction to better serve as a useful introduction for newcomers to the platform.
+
 
-
** Intro section should include "Who is the maemo community?, What is the maemo platform? The maemo software architecture, How does maemo.org work? Quick start guide to develop on maemo software, and presentations".
+
* Front page - see [[Task:Improving_maemo.org#Maemo.org_Homepage_refresh]] and [http://lists.maemo.org/pipermail/maemo-community/2008-September/000955.html this mailing list discussion].
-
:''The whole intro section should to be redesigned and turned into a proper starting point for new visitors. --[[User:xfade|xfade]] 13:49, 2 June 2008 (UTC)''
+
* Development - see [[Task:Improving_maemo.org/Development]]
-
::''Agreed, and I even got a volunteer in Nokia for the next sprint (Peter).''--[[User:qgil|qgil]] 10:33, 4 June 2008 (UTC)
+
* Community - see [[Task:Improving_maemo.org/community]]
 +
 
 +
We don't need to substantially revise the Intro, News or Downloads pages.
 +
 
 +
The front page will primarily be portal pages to help get people where they want to go, but also to let people get a flavour of the Maemo community.
 +
 
 +
The community page will show the Maemo community in all its glory - covering communication, people, projects, what's new, what's cool, what we're up to. The page will be almost entirely dynamic and will reflect the current state of Maemo.
 +
 
 +
The Development page should respond to four different needs - getting software development kits and images for development, getting general introductions, tutorials, overviews of the platform and other general information, exposing searchable reference documents for the Maemo platform APIs, and finally (but very importantly, giving a visitor a map of the developer-focused communication forums that exist in Maemo, including itT, mailing lists, IRC and the wiki.
 +
 
 +
=== Maemo.org Homepage refresh ===
 +
 
 +
The concept of the existing maemo.org homepage is good and we should keep it.
 +
 
 +
 
 +
The final make-up of the maemo.org front-page will be based on [http://samoff.maemobox.org/maemo_redesign/samoff-maemo.org-redesign_idea_0008e.png Tim Samoff's final proposal]:
 +
* A title bar with the new maemo.org logo
 +
* A menu containing:
 +
** "About" - points to current http://maemo.org/intro
 +
** "Downloads" - points to current http://maemo.org/downloads
 +
** "News" - points to current http://maemo.org/news
 +
** "Get help" - points to (new page) http://maemo.org/support - see [[Task:Improving_maemo.org/Support]]
 +
** "Development" - points to (updated page) http://maemo.org/development - see [[Task:Improving_maemo.org/Development]]
 +
* A search box which will search the website. Ideally, the search results page will allow the user to filter parts of the site only.
 +
* Discrete "Log in / Register" links (or, when logged in, a link to the user's profile page, with "Welcome back, [http://maemo.org/profile/view/dneary Dave Neary]" or something similar)
 +
* Prominently featured at the top of the page, the current "Fresh" and "Hot" downloads, which should point to the latest updated application, and one of the featured application ("the pearl"), the most popular application or the best rated application (to be decided) on the downloads page.
 +
* News - the front page should feature a section with the 5 most recent headlines from http://maemo.org/news/, including the lead paragraph for the most recent news item
 +
* Sidebar - other elements in the page will be less prominently placed, in a side-bar
 +
** "Get involved" - points to the (updated page) http://maemo.org/community - see [[Task:Improving_maemo.org/Community]]
 +
** The "Get involved" block should also include a link to a featured community member (including icon/photo), and could also include a link to the mewest maemo.org account creator ("Welcome [http://maemo.org/profile/view/dneary Dave Neary]!")
 +
** Links (with web banner) to [http://maemo.nokia.com Nokia's Maemo site], [http://www.internettablettalk.com/ Internet Tablet Talk] and [http://www.forum.nokia.com/ Forum Nokia]
 +
* Page footer
 +
** Copyright notice (note content will be copyright Nokia and respective authors - wording to be clarified)
 +
** Legal notices - points to http://maemo.org/legal which will contain copyright & trademark notices and trademark style guide, terms of use and privacy policy
 +
** "Midgard CMS" - a link to http://www.midgard-project.org/
 +
** A notice that the site is "Sponsored by Nokia"
 +
 
 +
=== Design drafts ===
 +
 
 +
* [http://samoff.maemobox.org/maemo_redesign/samoff-maemo.org-redesign_idea_0009b-loggedout.png Tim's mock-up]
 +
* [[:Image:HOME_03_MOD.png | Andre Cunha's redraft]] based on Tim's design and mailing list comments (including a [http://openbossa.andrecunha.com/LEVEL2.jpg second level page])
 +
* [http://samoff.maemobox.org/maemo_redesign/samoff-variation_of_HOME_03_MOD.png Tim Samoff proposed variation on Andre's HOME_03_MOD idea]
 +
* [[:Image:HOME_04.png|(Glaubert) A proposal for a horizontal content structure more compact]]
 +
* [[:Image:HOME_05.png|(Glaubert) A Dark grey version, for the new layout horizontally structured]]
 +
* [[:Image:HOME_7.png|(Glaubert) lighter site proposal]]
 +
* [[:Image:HOME_8.png|(Glaubert) lighter site proposal with some adjustments proposed by Tim and Henri B.]]
 +
 
 +
=== Tracking progress ===
 +
 
 +
Progress on the implementation of this new maemo.org style is being tracked on the page [[Task:Implement new maemo.org layout and style]].
 +
 
 +
=== Community ===
 +
 
 +
''Main Article: [[Task:Improving_maemo.org/Community]]''
 +
* In reference to maemo.org [http://maemo.org/community/ Community page].
== Functionality and navigation ==
== Functionality and navigation ==
-
* Single sign on for maemo.org/garage.maemo.org/wiki/bugzilla -> would make community participation easier and the 'karma' calculation (if needed) too.
+
* Single sign on for maemo.org/garage.maemo.org/wiki/bugzilla -> would make community participation easier and the '[[karma]]' calculation (if needed) too.
:''Ferenc is working on bugzilla, IIRC. The others already have one account for all. --[[User:xfade|xfade]] 13:49, 2 June 2008 (UTC)''
:''Ferenc is working on bugzilla, IIRC. The others already have one account for all. --[[User:xfade|xfade]] 13:49, 2 June 2008 (UTC)''
::''The "one account for all" is not the same as Single Sign-On (SSO). SSO would need additional software and integration. The one account for all feature will be completed when bugzilla will use garage for authentication. This is work in progress and will be completed in the June sprint. --[[User:feri|feri]] 14:08, 2 June 2008 (UTC)''
::''The "one account for all" is not the same as Single Sign-On (SSO). SSO would need additional software and integration. The one account for all feature will be completed when bugzilla will use garage for authentication. This is work in progress and will be completed in the June sprint. --[[User:feri|feri]] 14:08, 2 June 2008 (UTC)''
-
:::I'd just like the log-in to actually work properly. Or should I expect to wait over an hour for my second email confirmation?
+
*The user login process really is broken. Secondly, the login for the wiki has terrible user interface design, as it does not point to a page where one can register, despite the fact that it is called the "Log in / create account" page. ''--mee 13:54, 7 June 2008 (UTC)''
== Style and format ==
== Style and format ==
-
* Maemo.org can benefit from some face lifting - right now on 1280x1024 (this resolution seems to be very common to developers) only half of the real screen estate is used. With some loose block positioning both 800x480 and bigger resolutions can be supported. Maybe even specialized tablet finger-friendly look for those preferring it.
 
-
:''Agreed, we have a lot of size and font problems that need to be addressed. Some example stylesheets would be welcome though. --[[User:xfade|xfade]] 13:49, 2 June 2008 (UTC)''
 
-
:: ''I'll see to that [[User:bundyo|bundyo]] 20:41, 2 June 2008 (UTC)''
 
-
:''Resolution seems fine to me at the moment, and it works fine on the tablet without requiring the extra effort of maintaining a separate tablet style. Perhaps reducing the min-width to not require horizontal scrolling with the tablet browser windowed would be useful, though. [[User:generalantilles|generalantilles]] 21:02, 29 May 2008 (UTC)''
 
-
::''There won't be any extra effort on the resolution maintainment - this can be done with minor CSS modifications. As for the separate tablet style - this really requires extra effort and if done should be entirely optional. [[User:bundyo|bundyo]] 21:26, 29 May 2008 (UTC)''
 
-
* More relevant information displayed on front page, preferably customizable blocks like Netvibes and iGoogle. Since the content is gzipped, that won't be too harming to the traffic. Blocks can be optionally auto updated for those that like to keep their browser pages open (and if Prizm is ported - even in the tray). For instance, a "new bugs" section with voting on the fly will boost bugzilla usage.
 
-
* Make links more standardized.  New users often expect links would be underlined, even subtly, or appear to be a button of some kind.  Don't rely on hover effects because the tablet can't practically use them.  See [http://en.wikipedia.org/wiki/Mystery_Meat_Navigation Wikipedia on 'Mystery Meat Navigation']
 
-
:''This is much less of an issue for a lot of people —[[User:generalantilles|generalantilles]] 19:49, 31 May 2008 (UTC)''
 
-
:''Please stop expecting your advanced experience of new users. Read up on web accessibility, be inviting to the new users.--[[User:boxofsnoo|boxofsnoo]] 23:08, 31 May 2008 (UTC)''
 
-
::''I really don't see the issue (and never particularly have with this much-abused "Mystery Meat" nonsense), and I don't think it has anything to do with my experience, wikipedia (your source) uses the exact same system for link identification. . . . Some specific examples would probably help your case. Anyway, this should probably be taken to the talk page. —[[User:generalantilles|generalantilles]] 23:20, 31 May 2008 (UTC)''
 
-
* Format and style need to be unified across as much of the site as possible (excluding things like Garage and Bugzilla). Take, for instance [http://maemo.org/news/planet-maemo/ Planet] and [http://maemo.org/news/ News], two pages that should be very similar, if not the same. Perhaps take News' style and format and apply it to Planet (add the contributor's avatar to the upper right of each article? Much like [http://slashdot.org slashdot] does with their article category images.), as the News style seems to offer a cleaner look that better utilizes the available space.
 
-
:''There is a difference between News and Planet, because they both serve a different role. The planet aggregates every blog feed that is added. The News page only shows the news items that the community rates as being important/interesting. --[[User:xfade|xfade]] 08:00, 3 June 2008 (UTC)''
 
-
:: ''Yes, but they should at least share common style, they're quite different right now. [[User:bundyo|bundyo]] 09:40, 3 June 2008 (UTC)''
 
-
* For the outliers like Garage and Bugzilla, at least the style should largely be unified with the main site—using the same fonts, same colors, etc.
 
-
:''OK to have a well integrated, efficient and nice-looking layout across maemo.org. Ok to discuss in detail in  a page apart and ok to have a basic plan agreed in 100 Days. The execution will take longer, though.--[[User:qgil|qgil]] 07:38, 2 June 2008 (UTC)''
 
-
 
-
 
 +
Proposal: Open proposal for community generated mock-ups, and one or two Nokia
 +
sponsored mock-ups from INdT.
-
== Smoothing the introduction of new users to maemo.org ==
+
{{main|Task:Maemo.org facelift}}
-
* The development section should be organized in a simple, clear and centralized way to beginners. The following information is important and should be presented to the newcomers immediately they enter the development section.
+
See also [[Task:Improving maemo.org/Graphics]]
-
# Simple steps of getting started should be presented in a clear and definite way ,on a conspicuous area with color. for example:
+
-
## Sign up a maemo account (link to register page)
+
-
## Download and set up development environment.(link to detailed method page)
+
-
## Create hello world application, Package and Test(link to several typical and simple examples,and useful links to advanced docs should be included)
+
-
## Collaboration on maemo.org and Launch app on the download section (link to pages including usage of project homepage)
+
-
# Key features of maemo platform should be presented on the section page explicitly.
+
-
## Free to develop and launch applications.
+
-
## Powerful enough to create advanced applications.
+
-
## Flexibility in programming (Gtk+/C,Python,Qt and etc)
+
-
## Easy to port existing application.
+
-
# Wiki on frequent technical problems in programming(the how-tos part),and entry to developer's disscusion board(link to ITT's or a new one) to help newcomers to find solutions to difficulty and ask for help.
+
-
# All docs in a catalog with good classification for look up.
+
-
# Maemo's roadmap and history, technical news and announcement about maemo.
+
-
# Maemo app gallery and entry to experienced and recently active developers' tech blogs.
+

Latest revision as of 22:09, 28 March 2017

Image:Ambox_notice.png
This article is continued discussion from the maemo.org brainstorm
Please see the 100 Days agenda for more.
Image:Ambox_notice.png
This task is completed and this page stays here for documentation purposes only. Please file bugs or propose a new, related task if you want to push this forward.
Please see the talk page for discussion.

Connected to Task:Content Cleanup

Contents

[edit] Goals

We will:

  • Reorganise existing content to allow most common use-cases to be fulfilled easily
  • Create new content where appropriate to fulfill use-cases
  • Remove or move information which does not contribute to the most common use-cases
  • Make the site visually attractive and fresh, to match the maemo.org visuals
  • Make different maemo.org sites visually consistent
  • Ensure the site works well on the tablets

[edit] Non-goals

We will not:

  • Re-write all content
  • Move away from Midgard
  • Load the site with heavy content such as flash (see tablet goal).

[edit] Use cases

The following are the core use-cases to be addressed by the website rework:

  1. A new tablet owner wants to install some software on his tablet.
  2. An interested application developer comes to maemo.org to learn how to write a new application for the tablet.
  3. An existing application developer comes to maemo.org looking for information on modifying his application for Maemo.
  4. A Maemo Community member is looking for the latest news from around the world of Maemo
  5. An interested user wants to know how he can help make Maemo better or give feedback
  6. A tablet user has a problem which they would like to resolve.

[edit] Content

We need to change some of the content substantially:

We don't need to substantially revise the Intro, News or Downloads pages.

The front page will primarily be portal pages to help get people where they want to go, but also to let people get a flavour of the Maemo community.

The community page will show the Maemo community in all its glory - covering communication, people, projects, what's new, what's cool, what we're up to. The page will be almost entirely dynamic and will reflect the current state of Maemo.

The Development page should respond to four different needs - getting software development kits and images for development, getting general introductions, tutorials, overviews of the platform and other general information, exposing searchable reference documents for the Maemo platform APIs, and finally (but very importantly, giving a visitor a map of the developer-focused communication forums that exist in Maemo, including itT, mailing lists, IRC and the wiki.

[edit] Maemo.org Homepage refresh

The concept of the existing maemo.org homepage is good and we should keep it.


The final make-up of the maemo.org front-page will be based on Tim Samoff's final proposal:

  • A title bar with the new maemo.org logo
  • A menu containing:
  • A search box which will search the website. Ideally, the search results page will allow the user to filter parts of the site only.
  • Discrete "Log in / Register" links (or, when logged in, a link to the user's profile page, with "Welcome back, Dave Neary" or something similar)
  • Prominently featured at the top of the page, the current "Fresh" and "Hot" downloads, which should point to the latest updated application, and one of the featured application ("the pearl"), the most popular application or the best rated application (to be decided) on the downloads page.
  • News - the front page should feature a section with the 5 most recent headlines from http://maemo.org/news/, including the lead paragraph for the most recent news item
  • Sidebar - other elements in the page will be less prominently placed, in a side-bar
  • Page footer
    • Copyright notice (note content will be copyright Nokia and respective authors - wording to be clarified)
    • Legal notices - points to http://maemo.org/legal which will contain copyright & trademark notices and trademark style guide, terms of use and privacy policy
    • "Midgard CMS" - a link to http://www.midgard-project.org/
    • A notice that the site is "Sponsored by Nokia"

[edit] Design drafts

[edit] Tracking progress

Progress on the implementation of this new maemo.org style is being tracked on the page Task:Implement new maemo.org layout and style.

[edit] Community

Main Article: Task:Improving_maemo.org/Community

[edit] Functionality and navigation

  • Single sign on for maemo.org/garage.maemo.org/wiki/bugzilla -> would make community participation easier and the 'karma' calculation (if needed) too.
Ferenc is working on bugzilla, IIRC. The others already have one account for all. --xfade 13:49, 2 June 2008 (UTC)
The "one account for all" is not the same as Single Sign-On (SSO). SSO would need additional software and integration. The one account for all feature will be completed when bugzilla will use garage for authentication. This is work in progress and will be completed in the June sprint. --feri 14:08, 2 June 2008 (UTC)
  • The user login process really is broken. Secondly, the login for the wiki has terrible user interface design, as it does not point to a page where one can register, despite the fact that it is called the "Log in / create account" page. --mee 13:54, 7 June 2008 (UTC)

[edit] Style and format

Proposal: Open proposal for community generated mock-ups, and one or two Nokia sponsored mock-ups from INdT.

Main article: Task:Maemo.org facelift


See also Task:Improving maemo.org/Graphics