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
/!\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
(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
/!\ FIXME: explain how to install and use squidguard
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
- Troubleshooting guides
- Links and recomandations to other great guides that are relevant for
- 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.