Debian i18n - Policies and documentation
========================================


 !! XXX !! - Eventually this needs to go to a wiki, ikiwiki, HTML, SVN/git,
             somewhere so people can read it and know how it operates


Internal policies and documentation
-----------------------------------

 Useful information for people maintaining services in the machines

 * Server maintenance
   - Dependencies on other packages are expressed using meta-packages
     + debian.org-$yourservice.d.o
     + git+ssh://git.debian.org/git/mirror/debian.org.git

   - It is allowed to use packages/modules from backports.debian.org
   - It is allowed to use non-packaged software
     + Avoid running stuff on personal directories ($HOME, public_html)
     + Avoid PHP, and be reasonable about what we are running
     + Do not mix both packaged & non-packaged scripts of the same software

   - Cronjobs
     + sudo -u debian-i18n; crontab -e
     + sudo -u ddtp; crontab -e

   - Both machines have incoming/outgoing email
     /srv/ddtp.debian.org/mail
     /srv/i18n.debian.org/mail

   - Configuration can be added/ammended thru puppet (git requests preferred)
     + git+ssh://git.debian.org/git/mirror/dsa-puppet.git

   - Python
     + Was used for Pootle, but we are dropping Pootle
     + May be required for
       . Weblate (django)
       . Transifex (django)

   - Perl CGI
     + Memory is limited by DSA, it might need to be adjusted

   - Access to Debian mirror
     + NFS mounted mirrors at /srv/mirrors/debian

   - tye.debian.org
     + debian-i18n group has SSH access and apachectl
     + i18n.debian.org
       Services common to all teams or used to generate specific items, the
       rule of thumb is that the data availabe from i18n.d.o is used to build
       l10n.d.o

     + l10n.debian.org
       Services for individual teams (stats, coordination pages, robots)

   - dukas.debian.org
     + ddtp group has SSH access and apachectl
     + ddtp.debian.org
       DDTP - Debian Description Translation Project, includes the DDT Server
       and DDTSS (DDTS Satellite or Debian Distributed Translation Server
       Satellite), a web frontend to the DDTS.

 * .net domains (ddtp.d.n and i18n.d.n)
   - DSA (zobel) made:
     + ddtp.debian.NET owned by ddtp group
     + i18n.debian.NET owned by debian-i18n group

 * Guest accounts
   - DSA procedure: http://dsa.debian.org/doc/guest-account/
     + Used to give Martijn van Oosterhout (kleptog, non-DD) access to i18n
       and ddtp machines

 * Reboots
   - DSA reboots debian.org machines ASAP after stable kernel updates
     + For i18n services this seems fine and is the current practice on churro
     + Scripts must be idempotent and try to recover by itselves
     + If needed, lockfiles can be used to delay reboot
       + NEEDS FIX: Translated package descriptions takes a long time (most of
         the day), so that will need to be improved, one way or another.