Wiki pages for review

Matt Galvin matt.t.galvin at gmail.com
Sat Apr 29 23:36:59 UTC 2006


On 4/28/06, Phil Bull <philbull at gmail.com> wrote:
> [1] https://wiki.ubuntu.com/InstallingSoftware
> [2] https://wiki.ubuntu.com/GraphicsApplications
> [3] https://wiki.ubuntu.com/SwitchingFromWindows
> [4] https://wiki.ubuntu.com/WifiDocs/Driver/Ndiswrapper

Hi Phil,

Great stuff! :) One quick suggestion...

Every heading should be followed by content. If the heading is a level
1/2 heading (typically describing a broad topic leading to more topic
specific level 2/3/etc headings) that is currently blank it should
contain a description of what is to come. This description should be
an overview of the level 2/3/etc heading under it. So for example on:

https://wiki.ubuntu.com/InstallingSoftware

2 Packages and Package Management (currently blank) should contain a
description of what is to come in 2.1, 2.2, 2.3, etc.... Something
like:

In this section we will cover the basics of packages and package
management. You will learn about what packages are, where they live
and how most packages rely on other packages to do there jobs. And so
on and so forth...

Not to say you need to use the above example. But these types of
introduction/transitional sections can help improve the flow of the
document and keep the readers eyes moving smoothly through the doc as
opposed to just seeing a big blank space.

Other than that, they read very well and are very informative. Great work! :)

Matt

--
Matt T. Galvin
mgalvin on irc.freenode.net
http://people.simplifiedcomplexity.com/~mgalvin/
Ubuntu Documentation Team Member




More information about the ubuntu-doc mailing list