Editing in the Debian webtree (preliminary version)
-----------------------------

Questions, remarks, requests for clarification to webmaster@debian.org, please.

[Q] What is the Debian webtree?
[A] The Debian webtree is the collection of directories and their contents
    that are mirrored from master.debian.org to www.debian.org, and that
    together comprise the Debian web site "www.debian.org".

[Q] Where is the Debian webtree?
[A] master.debian.org:/home/Archives/DebianWebMaster/debian.org
    (the debian.org-local is for files that are automatically generated;
    debian.org-RCS is for the Revision Control System).

[Q] How do I edit a file in the Debian webtree?
[A] - Make sure your umask is 002
    - Check out the file from the RCS archive like this:
    	co -l fubar.html
    - Edit the file using your favourite editor
    - Check the file in into the RCS archive _while keeping a readonly copy_
      like this:
        ci -u fubar.html
      and give a short description of the changes you made.

[Q] May I make a subdirectory in the Debian webtree?
[A] No. Ask webmaster@debian.org to do it for you.
  [Q] Why?
  [A] We don't want to waste diskspace on www.debian.org (and its mirrors),
      so RCS is a symlink to a dir outside of the mirrored directories.
      There will be a script to make dirs in the future.

[Q] I want to put <fancy web feature> into www.debian.org, may I?
[A] No. We want www.debian.org to be as accessible as possible, so
    - no browser specific "extensions".
    - no relying on images only. Images may be used to clarify, but the
      information on www.debian.org must remain accessible via a text-only
      webbrowser, like lynx.

[Q] I have this nice idea. Can you enable FOO in www.debian.org's HTTPD,
    please?
[A] No. We want to make life easy for administrators to mirror www.debian.org,
    so no special HTTPD features please. No, not even SSI.

[Q[ Why is everything owned by group debwww and directories mode 2775?
[A] They are group debwww so only those in that group can modify files in
    the web directory. The 2775 on directories means that any files created
    under that directory will inherit the group - debwww in this case.
    Anyone in group debwww is expected to set 'umask 002' so that the
    files are created with group write permissions.