launchpad-dev team mailing list archive
-
launchpad-dev team
-
Mailing list archive
-
Message #00365
Re: Launchpad dev wiki conventions posted.
Max Bowsher <maxb@xxxxxxx> writes:
> The page currently says: "The summary bar should always end with a
> sentence encouraging the reader to ask for help whenever they need it,
> linking to the Help page."
>
> I have two problems with this:
>
> * It means there's a bit of boilerplate occupying the same visual space
> as the summary, making the per-page information less accessible at a glance.
>
> * I think it sets the wrong tone (treating users of the wiki as
> excessively stupid) to repeat this exhortation on every single page.
>
> Including the exhortation totally makes sense on pages like Getting or
> Running, but for me provokes a "huh? what? random out of context
> statement?" reaction from me on pages like https://dev.launchpad.net/Trunk.
>
> 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.
Follow ups
References