launchpad-dev team mailing list archive

[Matthew Paul Thomas <mpt@xxxxxxxxxxxxx>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Karl Fogel wrote on 11/08/09 22:07:
>
> Max Bowsher <maxb@xxxxxxx> writes:
>...
>> If we really want a link to Help on every information-disseminating
>> page, I think it needs to be phrased more in keeping with the
>> character of the page (e.g. "If you have questions about the content
>> of this page, please [[Help|ask us!]]") and would preferably be in a separate style to
>> the per-page content such that people can easily start to ignore the
>> boilerplate once they're aware of it.
>
> I've adjusted the WikiConventions page accordingly.
>
> Please just hack away at any summary bar you think needs it, and same
> for the WikiConventions page.
>...

You're trying to address two very different issues in one element.

The first is reassuring the reader that they're at the right page. I
predict that a plain-text paragraph, one or two sentences, would do this
more noticably than the bar does. And if you're on the wrong page, the
bar has no space available for links to the right page.

The second is offering a way of asking for more information on the
current topic. But people usually won't know whether they need more
information until they've read the page and realized it doesn't cover
the detail they want. So that link would be more convenient at the end
of the page.

You may find <https://wiki.ubuntu.com/UbuntuHelp/PageStructure> helpful
in revising the wiki conventions.

Cheers
- --
Matthew Paul Thomas
http://mpt.net.nz/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkqMCigACgkQ6PUxNfU6ecrvlQCdHzE9+TaLnE+Evshj1RQe9/HR
uqcAnRib0JkGuAjhb7ocUzcnMGapdlt6
=3Ocp
-----END PGP SIGNATURE-----