Wiki pages for review - https://wiki.ubuntu.com/InstallingSoftware
Matthew East
mdke at ubuntu.com
Sun Apr 30 01:02:36 UTC 2006
On Sun, 2006-04-30 at 10:52 +1000, David Tangye wrote:
> On Sat, 2006-04-29 at 19:11 +0100, Phil Bull wrote:
> > I originally put the sections in this order because it seemed more
> > logical - first give the background information required to understand
> > the installation process, and then put the 'howto' part after.
> I agree that this is the way I would put it for MYSELF. However see my
> earlier posts. I would reverse that order for the reasons given about
> who the reader is.
I disagree: I think the way Phil has structured the page works very
well, and this is how we have structured the onboard help too. Basic
(and fundamentally important) concepts are explained first, and the page
goes down in a logical progression. Showing the reader how to run before
they can walk is generally not the aim of our documentation. Those that
can walk already are perfectly able to navigate the table of contents
and find what they need.
> Plus, we were taught even in primary school (PLEASE do not take offence
> at that anybody) {SNIP}
If you don't want people to take offence at a phrase like this, just
omit it from your emails. It doesn't add anything.
Matt
--
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 191 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060430/9c089e5d/attachment.pgp>
More information about the ubuntu-doc
mailing list