X-Git-Url: https://git.adam-barratt.org.uk/?a=blobdiff_plain;f=input%2Findex.mdwn;fp=input%2Findex.mdwn;h=8e8c31d403b7896930ab394f78476dc6975f5ef8;hb=ae4572f9757952c3935dcc3864f8b3b331885600;hp=9787550038af60c9ac387391e946d01e20502fef;hpb=edae2938597d9b796cda07a404857c1eb4ca8f2e;p=mirror%2Fdsa-wiki.git

diff --git a/input/index.mdwn b/input/index.mdwn
index 9787550..8e8c31d 100644
--- a/input/index.mdwn
+++ b/input/index.mdwn
@@ -1,8 +1,8 @@
 # Debian System Administrators
 
-The Debian System Debian Administration Team (DSA) is the team that
-keeps debian.org's infrastructure going. This is the internal team wiki,
-which as some howto mainly targeted for the team members.  
+The Debian System Debian Administrator team (DSA) is responsible for
+Debian's infrastructure.  This wiki is focussed on system administration
+documention, primarily in the form of HOWTOs, for the team.
 
 To contact us, mail debian-admin@lists.debian.org.
 
@@ -20,21 +20,23 @@ prepare patches for any of our GIT repositories please use git format-patch and
 mail them to debian-admin@lists.debian.org or attach them to the according RT
 ticket.
 
-## documentation
+## documentation for end users or services owners
 
-* [[doc/wiki]]: How to contribute to the dsa.d.o wiki
-* [RT Usage](http://wiki.debian.org/Teams/DSA/RTUsage) - offsite
-* [DSA usertagged bugreports](http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-admin@lists.debian.org) - offsite
-* [[user/sudo]]: How to set sudo passwords.
-* [[doc/schroot]]: How schroot can be used on porter machines
-* [[doc/guest-account]]: guest account access to porter machines
-* [[doc/subdomains]]: facilities offered to teams with a dedicated subdomain
+* [how to use RT](http://wiki.debian.org/Teams/DSA/RTUsage)
+* [how to set sudo passwords](user/sudo)
+* [how to request guest access to porter machines](doc/guest-account)
+* [how to use schroot on porter machines](doc/schroot)
+* [how to manage service subdomains](doc/subdomains)
 
-## Internal documentation
+## documentation for 
+* [how to contribute to this wiki](doc/wiki)
+* [list of DSA usertagged bugreports](http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-admin@lists.debian.org)
+
+## documentation for team members
 
 * [[howto/dns]]
-* [[howto/new-machine]]: How to setup and integrate machines into debian.org's infrastructure.
-* [[howto/decomission]]: How to decomission a machine
+* [[howto/new-machine]]: how to add a machine
+* [[howto/decomission]]: how to decomission a machine
 * [[howto/puppet-setup]]
 * [[howto/upgrade-to-lenny]]
 * [[howto/upgrade-to-squeeze]]
@@ -43,16 +45,16 @@ ticket.
 * [[howto/ilo-https]]
 * [[howto/backup]]
 * [[howto/exim-ca]]
-* [[howto/iscsi]]: How to setup a new iscsi initiator
-* [[howto/export-iscsi]]: How to export new iscsi LUNs
-* [[howto/install-kvm]]: How to setup a new kvm domain without going through d-i etc.
+* [[howto/iscsi]]: how to setup a new iscsi initiator
+* [[howto/export-iscsi]]: how to export new iscsi LUNs
+* [[howto/install-kvm]]: how to setup a new kvm domain without going through d-i etc.
 * [[howto/postgres]]: Random postgres stuff
-* [[howto/add-guest]]: How to add guests to ud-ldap
-* [[howto/add-account]]: How to add accounts to ud-ldap / upgrade guest accounts
-* [[howto/swarm-kernel]]: How to build kernels for our swarm boxes
-* [[howto/drac-reset]]: How to beat the radacm rootk^Wbinary only software.
+* [[howto/add-guest]]: how to add a guest to ud-ldap
+* [[howto/add-account]]: how to add an account to ud-ldap (also: how to upgrade a guest)
+* [[howto/lock-account]]: how to lock an account in ud-ldap
+* [[howto/swarm-kernel]]: how to build kernels for our swarm boxes
+* [[howto/drac-reset]]: how to beat the radacm rootk^Wbinary only software.
 * [[howto/new-dpl]]: What to do when we have a new DPL
-* [New DSA manual](http://dsa.debian.org/dsa-manual/_build/html/)
 
 ## ports