This site has been retired. For up to date information, see handbook.gnome.org or gitlab.gnome.org.


[Home] [TitleIndex] [WordIndex

1. Web policies

Here we define the policies of www.gnome.org. This is a key planning document that depends only from the GnomeWeb/WgoScope and affects any implementation.

Changes in this document might imply a revision of the GnomeWeb/LayoutPlanning, the GnomeWeb/LooknFeel, the GnomeWeb/CmsRequirements and the GnomeWeb/Localization.

1.1. Address and naming policies

URIs should be simple and easy to understand, remember and type for our users. They should also build up a logical document hierarchy where there the documents can be placed and found without much cognitive work by the users. The path and query part should not be like: /index.php?pageid=1545353 or /portal/page?_pageid=33,31321&_dad=portal&_schema=PORTAL. More like /support/tutorials/guide_to_garnome or /news/2006/large_deployment_to_local_schools.

URIs should be:

Related reading:

1.2. Format policies

The website should conform to certain standards, to enforce consistency among browsers and accessibility for users and search engines. It is obvious for the GNOME web site to conform to the XHTML and CSS standards, and it is important that all parts of the site will do this, also the parts made by content management systems or wikis. We should support all major browsers and versions, and not avoid the standards if there are workarounds that we will use for the major browsers not complying to the standards. The content and design should be completely separated, in ways that we use semantic web elements (such as em, strong and code) instead of styling elements (such as i, b or tables for layout). It is also a good habit to encode meta information (such as author, copyright), preferably in Dublin Core tags. Where documents consist of multiple pages, the pages should be linked together (with previous, next and toc links). The site should also strive to conform to the Web Content Accessibility Guidelines, that focuses on usability for people with some sorts of functional disabilities. It must work for people and devices with small screen resolution, such as handheld devices. The documents should also be made available in alternate versions for printing or feeds etc.

The documents should

Related reading:

1.3. Content policies

The user pages should be easy to read, and your children or grandma should be able to understand the vocabulary. Our message should be clear, both in terms of readability and marketing. The text should be made understandable for people not having the particular language as their primary language. Even the translated languages, as many of those are easier to understand than english for many users throughout the world. We cannot make such restrictions on the developer pages. If we will ever have business pages or pages for other groups, write for those users. Always keep your users in mind when writing.

The pages should be direct and informative, not telling too much about what you will find on every page or the subpages, but contain more of the information directly. The design of the pages should be made simple, so that the users does not get overloaded with lots of unrelated information.

User pages should be easy to read, by

Related reading:

1.4. Authoring policies

Pages should have responsible maintainers that have the time to update the information, and the pages should contain contact information. Generic lists addresses are more reliable than personal addresses, and those should be used. The pages should also contain information about their status (draft, current, deprecated, obsolete), and this status should be made more visible by using graphical elements such as symbols or colors. Also the pages should contain information about their last change, as a last resort for people wanting to know if the page is outdated. Some information about the last editor should be maintained, as that person possibly is the one to make new updates as well.

On www.gnome.org, only updated pages should be visible for users. If a page is outdated either we update it or we unpublish it. Deprecated subsites should be made unavailable to search engine crawlers. Drafts should only be accessible to users with permissions, such as editors, reviewers or translators.

Pages should

1.5. i18n policies

Pages on www.gnome.org should be available in multiple languages, and the users should easily be able to view the page in another translated language. The language should default to language settings in the browser, and if a user chooses another language in the web interface, this language setting should be made persistent. It should be easy for existing translators to translate the site, and the translators should be able to view the last changes done in a page, to see what updates are needed. To get as many existing translators as possible to translate the site, it should have translation mechanisms integrated with the existing GNOME translation tools.

Pages should:

1.6. Design and theme policies

The styling and theming should use logos that are compliant with the logo guidelines and should be inspired by and use colors from the default desktop theme, Clearlooks. When the brandbook reaches some final state and is accepted by the board, www.gnome.org should strive to comply to this. If the default desktop theme later uses Tango colors, the web interface should also convert. The design should have a fluid layout to fit different window and font sizes, to support mobile devices and old monitors.

The style should

Related reading:

2. Improve this document

This is an approved document. We invite you to improve it by adding your comments below. Note that this is a key planning document, we might not touch it during the production phase of each release. Only the maintainers of this document can approve changes to it.

2.1. Comments


2024-10-23 11:10