[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Challenge/Declaration - To all DebainEdu/Skolelinux users: The month after release is documantation month. (feb. 8 - march 8.)

This is the "FIXME notes" in the manual (feb 6.)  :

(1) Pinter management

If you connect the printer for the first time,
we suggest to run printconf  as root.
/!\FIXME: explain what to do when printconf does
not accomplish anything.

(2) Upgrading software

Instead of using the command line you can also
use kde-update-notifier.
/!\FIXME: Explain how to use kde-update-notifier,
best with screenshots.

(3) Backup management

/!\FIXME: continue description of slbackup-php usage,
maybe with screenshots

(4) JAVA fom Sun

/!\ FIXME: Should we recommend openjdk-6-* from main
instead documenting sun-java6-jre? Not sure if a plugin
is available...

(5) Access Skolelinux for outside a firewall

/!\FIXME: paragraph about access from outside need to
be completed and tested.

(6) Installing single service machines for spreading
the load from main-server

/!\FIXME: this is so generic its almost useless

(7) KDE Kiosk mode

Note:: modifications to the profiles can be done
using kiosktool. However, unless you follow the
step below, your changes will be overwritten by
upgrades. /!\FIXME: this is broken and a bug should
be filed: kiosktool upgrades restore default desktop icons

(8) Changing the PXE menu on an LTSP server

/!\ FIXME: Probably (I think its partly described
above already) add more info about how to boot diskless
workstations instead of thin clients on 192.168.x.x,
and that you have to add '3' to the kernel argument
list in /var/lib/tftproot/ltsp/....

(9) Load balancing LTSP servers

/!\ FIXME: This need to be changed as DHCP configuration is in LDAP.

(10) User groups in Windows

/!\ FIXME: should user groups in windows better be explained
with lwat first, and then with an example for the command line?

(11, 12) Redirecting parts of profile

/!\ FIXME explain how to use profiles from global policies
for windows machines in the skolelinux network
/!\ FIXME: describe roaming profile key for the global
policy editor here

(13) Monitoring pupils

/!\ FIXME: explain how to install and use italc - 511387
explains this quite well actually.

(14) Restricting pupils network access

Some schools use squidguard or dansguardian to restrict
internet access.
/!\ FIXME: explain how to install and use squidguard
and/or dansguardian

OleAnders Andreassen

Ole-Anders Andreassen skrev:
The Lenny manual (http://wiki.debian.org/DebianEdu/Documentation/Lenny) has +15 "FIXME" notes. These should have the highest priority when it comes to improving the documentation.


( The more we share, the more we have)

Den 04.02.10 23.38, skrev Ole-Anders Andreassen:
Challenge/Declaration - To all DebainEdu/Skolelinux users: The month after release is documantation month. (feb. 8 - march 8.)

I challenge every member of the community to step up and pitch in. Edit existing documentation and improving it, and adding new documentation, so we can have a shining example of user-friendly help. Even the newbiest of newbs can help by simply pointing out what they'd like to see, or even starting to write it themselves (it's a wiki, so others can correct any mistakes you make, don't be affraid to write english, most of us are not native english speakers). Our experienced users and admins could present usefull tools for administration, or cool features that could be implemented.

If the workload is spread evenly around , then it will take no time to document a lot of features i DebianEdu/Skolelinux. Good and easy understandable documentation is one of the most important things when it comes to spread the use of our fantastic distro more. After all DebianEdu/Skolelinux is the most important Linux distro when it comes to introduce Linux and free software in an early age.

Here are some ideas:

- Walk a beginner through network setup
- Walk a begginer through the use of an essential program
- The most important and usefull linux commands
- How to set up a firewall
- How to play videos, dvd, mp3, streams, sound...
- The perfect setup
- Make a video tutorial
- How to do testing (check list?)
- Hardware choices
- HowTo set up an external backup pc
- Update the wishlist at http://wiki.debian.org/DebianEdu/Wishlist
- Get started with Moodle in DebainEdu
- Cool educational apps
- Installing and configuring printers
- Samba
- Troubleshooting guides
- Links and recomandations to other great guides that are relevant for DebianEdu
- Eye candy
- Connect your DebianEdu/skolelinux blog to http://planet.skolelinux.org
  and tell us about the cool stuff you do with DebianEdu.

To consider the value of documentation, you only need to look at the projects where it is scant or non-existent. The projects also become scant and non-existent as people find that setup, install and operation are beyond the native intuitiveness of the interface and move onto something more user-friendly - something with documentation. The value of an application is often measured by it's documentation. We have a lot of good documentation, and our manual are becoming better and better every day. But in my oppinion it is almost impossible to get enough :)

So let us put our efforts together to make our documentation even better.

Ole-Anders Andreassen

Reply to: