[wiki] PAE page: formatting and flavor-agnosticism

[David Pires]

On 28 March 2015 at 19:09, Pasi Lallinaho <pasi at shimmerproject.org> wrote:

> Hello Ubuntu Documentation team (CC: Moergaes),
>
> as some of you have noticed, there has been discussion about the PAE
> page [1] on the community wiki previously this year outside the mailing
> list. I'm bringing this issue up again as a community wiki administrator.
>
> Please bear with me while I briefly go through the history of the story
> so far.
>
>
> Early this year, I edited the PAE landing page to make it less of a wall
> of text. The updated version is revision 43 [2]. This landing page
> shortly explains what PAE is and then proceeds to point to the pages
> that explain how to enable PAE on Pentium M's and/or older releases. In
> addition, I changed the text to be flavor-agnostic instead of the
> Lubuntu-centric approach the page used to have before.
>
> To keep the structure consistent, I moved the actual "guide" pages under
> the PAE page; the instructions on how to enable PAE on Pentium M
> processors (with (or without) the forcepae flag) is at PAE/PentiumM [3]
> (at least in revision 10 [4]) and the guide to enabling PAE on older
> releases is at PAE/Enabling [4].
>
>
> However, after these changes, the page was quickly reverted back to the
> old revision with some minor changes to make it less Lubuntu-centric.
>
> After discussing the matter with the original page author, it seemed
> obvious that he disagreed on what was useful and what not. Since then
> I've talked with some wiki administrators and active people - who have
> supported my revision - and he has created a forums thread [6] where
> some people supports his, and some aren't completely sure which one is
> better.
>
> The page was left looking like the old version, since the original
> author showed no signs of willingness to cooperate and improve the page
> to reach a compromise that satisfied both parties.
>
>
> Yesterday I got a notification of a page change - the PAE page has very
> Lubuntu-centric wording again. I the Lubuntu-centric approach is a wrong
> call and that the page would be much more accessible if it wasn't the
> wall of text it currently is.
>
> That's the story; everybody, but especially other wiki administrators -
> what do you think?
>     Which page layout do you prefer more?
>     If appropriate, how would you improve the layout you prefer?
>
>
> Cheers,
> Pasi
>
> [1] https://help.ubuntu.com/community/PAE
> [2] https://help.ubuntu.com/community/PAE?action=recall&rev=43
> [3] https://help.ubuntu.com/community/PAE/PentiumM
> [4] https://help.ubuntu.com/community/PAE/PentiumM?action=recall&rev=10
> [5] https://help.ubuntu.com/community/PAE/Enabling
> [6] http://ubuntuforums.org/showthread.php?t=2263647&p=13254310&viewfull=1
>
> --
> Pasi Lallinaho (knome)                » http://open.knome.fi/
> Leader of the Shimmer Project         » http://shimmerproject.org/
> Ubuntu member, Xubuntu Website lead   » http://xubuntu.org/
>
>
In my opinion the principle should be to make wiki pages flavor agnostic,
as much as possible.
There are of course, exceptions for this, but I don't think this is one of
those cases.

Yes it's true that a large number of PAE installs are associated to the
Lubuntu flavor, but there are still a considerable number of Xubuntu
installs, for instance.

Also the proposed scheme of having a landing page for PAE, that briefly
explains what it is and linking to pages where it's then explained how to
enable it, seems to me to be a more rational approach.

Just my two cents.

Cheers,
David Pires (slickymaster)
https://wiki.ubuntu.com/slickymaster
Xubuntu Documentation Lead
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20150330/bec31383/attachment.html>