Re: [gNewSense-users] Documentation

[Mark William Darbyshire]

Hello all!

Thanks for the suggestions, Chris. I've put them all in.

Some of Chris' suggestions are quite specific topics. If we're going to
be that specific in a few areas we need to specific in quite a few more.
I'm hardly a gNewSense expert, so please pipe up if you have anything
you feel should be included in the documentation.

Something else quite important: Since gNewSense is fairly unique in its
approach to the four freedoms I think the documentation should not only
walk people through installing and using gNewSense, but also say lots
about the issues of freedom/ethics involved (for example, I've proposed
an article in the Entertainment section introducing free formats and
explaining why proprietary formats should be avoided).

Here's the proposed structure in its current state. Remember you can
always view the latest version at
http://wiki.gnewsense.org/Documentation/ and your suggestions on what
else to include or how better to arrange the documentation are always
welcome.

     1. Installing gNewSense 
             1. Basic installation
             2. Multi boot installation (installing gNewSense alongside
                another operating sytem)
             3. Advanced installations
     2. Introduction to the desktop environment 
             1. GNOME
             2. KDE
             3. Other desktop environments
     3. Basic Settings 
             1. Users
             2. Networking and Internet 
                     1. Dialup
                     2. LAN and Broadband
                     3. WAN ?
     4. Using gNewSense 
             1. The Internet 
                     1. Browsing the Internet
                     2. Emails
                     3. Instant Messaging
             2. Productivity 
                     1. Commonly used programs 
                             1. OpenOffice.org
                             2. The GIMP
                     2. Common tasks 
                             1. Importing photos from a digital camera
                     3. Entertainment 
                             1. Introduction to free formats
                             2. Programs...
             3. Adding and Removing Programs 
                     1. Introduction
                     2. Synaptic Package Manager (GNOME)
                     3. Adept (KDE)
                     4. Managing installed programs with the command
                        line
             4. Changing the Appearance of gNewSense 
                     1. Desktop
                     2. Screensavers
                     3. Themes
     5. Advanced 
             1. Security tools (Bastille & Tiger...)

Regards,
Mark.

On Wed, 2007-12-19 at 21:28 +0000, Chris Andrew wrote:
> Mark,
> 
> This looks like a good structure to start with.
> 
> Personally, I would like coverage of the following, but this is just me :-):
> 
> 1. Installing gNewSense
> >>>  Partitioning using multiple disks (Advanced section?)
>     2. Introduction to the desktop environment
>             1. GNOME
>             2. KDE
> >>>   3.  Othe desktops/ window managers, for lower spec machines
> (fvwm/ wmaker/etc)
>     3. Basic Settings
>             1. Users
>             2. Networking and Internet
>                     1. Dialup
>                     2. LAN and Broadband
>                     3. WAN ?
>     4. Using gNewSense
>             1. The Internet
>                     1. Browsing the Internet
>                     2. Emails
>                     3. Instant Messaging
>             2. Productivity
>                     1. OpenOffice.org
>                     2. The GIMP
> >>>            3.  Importing photos from a USB attached camera?
>             3. Adding and Removing Programs
> >>>            1.  Using dselect. apt-get and then GUI add/remove apps
>             4. Changing the Appearance of gNewSense
>                     1. Desktop
>                     2. Screensavers
>                     3. Themes
>     5. Advanced
> >>> Security hardening....use of Bastille and then Tiger.
> 
> They are things off the top of my head.  As it's a wiki, we can always
> come up with more later, but it's a good idea to map as much as we
> can, to start with.
> 
> Cheers,
> 
> Chris.
> 
> On 19/12/2007, Mark William Darbyshire <address@hidden> wrote:
> > Hello everyone,
> >
> > It's time to get the gNewSense documentation back on track! I'm more
> > guilty then anyone else of neglecting to work on the documentation, but
> > I'm back with a fresh bout of enthusiasm and no study commitments for a
> > couple of months (having finished high school).
> >
> > I've completely changed the layout of the Documentation page. The
> > Proposed Structure has been incorporated into the main documentation
> > page, and links to documentation that doesn't exist yet that were used
> > to populate the old table have been removed, so that we're left with a
> > list of available documentation for those who need it, and a
> > work-in-progress structure for those who wish to contribute. See
> > http://wiki.gnewsense.org/Documentation/Documentation
> >
> > Currently the Proposed Structure is as follows. Most sections need many
> > more categories or articles, so suggestions are welcome. Of course
> > suggestions for overall changes and improvements to the structure are
> > also welcome.
> >
> > Let's see if we can hammer out a final structure before Christmas, ready
> > to actually start writing documentation early next year!
> >
> >      1. Installing gNewSense
> >      2. Introduction to the desktop environment
> >              1. GNOME
> >              2. KDE
> >      3. Basic Settings
> >              1. Users
> >              2. Networking and Internet
> >                      1. Dialup
> >                      2. LAN and Broadband
> >                      3. WAN ?
> >      4. Using gNewSense
> >              1. The Internet
> >                      1. Browsing the Internet
> >                      2. Emails
> >                      3. Instant Messaging
> >              2. Productivity
> >                      1. OpenOffice.org
> >                      2. The GIMP
> >              3. Adding and Removing Programs
> >              4. Changing the Appearance of gNewSense
> >                      1. Desktop
> >                      2. Screensavers
> >                      3. Themes
> >      5. Advanced
> >
> > Regards,
> > Mark.
> >
> > --
> > Mark William Darbyshire
> >
> > www.markdarb.com
> >
> > NOTE: I have recently changed my primary email address from address@hidden 
> > to address@hidden
> >
> > Jabber/Google Talk: address@hidden
> > Ekiga: address@hidden
> >
> > "Verily, verily, I say unto thee, Except a man be born of water and of the 
> > Spirit, he cannot enter into the kingdom of God." - John 3:5
> >
> > God can prove himself to you - www.revivalfellowship.org
> >
> > Please don't send me Microsoft Office files - 
> > www.gnu.org/philosophy/no-word-attachments.html
> >
> > Don't get Windows or Mac, get GNU/Linux - www.getgnulinux.org www.fsf.org 
> > www.gnu.org
> >
> >
> >
> > _______________________________________________
> > gNewSense-users mailing list
> > address@hidden
> > http://lists.nongnu.org/mailman/listinfo/gnewsense-users
> >
> 
>