Robbie, I think your comment, and especially the caps, is a bit over the
top. From this page (https://help.ubuntu.com/11.04/index.html) it is
extremely clear that the documentation is for 11.04 and is up to date.
On each page of the serverguide it shows clearly at the top that the
page is for 11.04 (https://help.ubuntu.com/11.04/serverguide/C
/introduction-chap.html). The branding doesn't really imply that the
information is outdated. There is similar branding on the Ubuntu Forum.

Obviously it is important to update the branding, which is why we have
the bug report. But it will take someone with a fair bit of free time
who is familiar (or willing to get familiar) with the documentation
toolchains and processes.

Here is some information on how help.ubuntu.com works and what would be
needed to fix this bug, in case someone is interested in working on it.
If not, I will be looking to work on this bug at some stage over this
release cycle with a view to fixing it by Ubuntu 11.10. If someone wants
to work on this before then, I am happy to mentor it.

There is some information here
(https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/BuildingDocumentation)
but it is probably incomplete and this should help.

*One thing that would be really helpful* would be if someone with
graphic software skills could implement a logo for the top right hand
corner of the site. So, similar to the "Ubuntu wiki" logo on
wiki.ubuntu.com, but enough to make it clear that the site is for
documentation. I guess substituting the word "documentation" for the
word "wiki" in the appropriate font would be sufficient.

help.ubuntu.com has two components, the wiki (help.ubuntu.com/community)
and the static html (help.ubuntu.com/). For consistency both parts
should be updated at the same time. The themes for each component must
be consistent and there should be a way for the user to distinguish
between the two (as there is now).

= Static html =

This is generated from our xml documentation which is found in our bzr
branches. Generally in each bzr branch there is a Makefile which
contains the instructions and commands needed to build the html. The
html is produced by xslt stylesheets which are used in conjunction with
processing tools to build html. Part of the theme is in the xslt files,
and part of the theme is in css files.

For all versions prior to Ubuntu 11.04, the relevant code and theming is
in the ubuntu-doc branches (see the main series here:
https://code.launchpad.net/ubuntu-docs). For Ubuntu 11.04, the relevant
code and themeing is in the gnome-user-doc branch. The xslt files are
different for Ubuntu 11.04, because we changed the documentation format
used for Ubuntu documentation, using Mallard instead of Docbook. This
required some new theming to be written.

There are certain pages which are generated manually by copying them
over from one release to the next. These include:

 * the index page for each release;
 * the index page for the installation guide;
 * the main index page for the site gets updated manually.

Apart from these, all other pages in the site are generated using the
build tools described above (unless I'm missing something).

Updating this part of the website will involve designing new xslt
stylesheets for the Docbook and Mallard files, and regenerating the html
for each version of Ubuntu carried on the website. We can probably use
one of the themes on the ubuntu-website project
(https://code.launchpad.net/ubuntu-website), probably the light-base-
theme. But the xslt will require some work.

The eventual product can be pushed to our bzr branch for help.ubuntu.com
(https://code.launchpad.net/~ubuntu-core-doc/ubuntu-
docs/help.ubuntu.com), which is automatically synched once a day.

In the future, I think there is an interesting discussion we should have
about whether we should carry so many versions on the website. Having so
many versions makes it quite time consuming and difficult to update.

= Wiki =

The wiki runs on MoinMoin software and the theme is here:

https://code.launchpad.net/~mdke/ubuntu-docs/helpwiki-newtheme

This is pretty much simply taking the moin theme for the new brand
(there is a base here: https://code.launchpad.net/~ubuntu-website-
community/ubuntu-website/light-wiki) and customising it for the
help.ubuntu.com site.

There is no staging server but a good way to test the theme as it is
being developed is to download a desktop version of moin (instructions
here: http://moinmo.in/DesktopEdition) - but make sure you get the same
version as the one used on help.ubuntu.com (1.6.3).

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/589057

Title:
  help.ubuntu.com still uses old logo/branding

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu-branding/+bug/589057/+subscriptions

-- 
ubuntu-bugs mailing list
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to