[Savannah-cvs] [568] minor refinements

[ineiev]

Revision: 568
          
http://svn.savannah.gnu.org/viewvc/?view=rev&root=administration&revision=568
Author:   ineiev
Date:     2023-02-09 04:17:49 -0500 (Thu, 09 Feb 2023)
Log Message:
-----------
minor refinements

Modified Paths:
--------------
    trunk/sviki/AudioVideo.mdwn
    trunk/sviki/GnuArchitecture.mdwn
    trunk/sviki/ListServer.mdwn
    trunk/sviki/Mirroring.mdwn
    trunk/sviki/SavannahArchitecture.mdwn

Modified: trunk/sviki/AudioVideo.mdwn
===================================================================
--- trunk/sviki/AudioVideo.mdwn 2023-02-09 09:15:35 UTC (rev 567)
+++ trunk/sviki/AudioVideo.mdwn 2023-02-09 09:17:49 UTC (rev 568)
@@ -1,6 +1,8 @@
+# Audio-Video
+
 We also host audio-video.gnu.org, that is, all the audio and video files
-referenced at
-<http://www.gnu.org/philosophy/audio/audio.html>
+referenced at the [audio-video section](//www.gnu.org/audio-video/audio.html)
+of www.gnu.org.
 
 Access is via SFTP in a separate directory - check
 <http://download.sv.gnu.org/releases/audio-video/README.uploaders>
@@ -7,8 +9,7 @@
 
 Contact: John Sullivan
 
-[[ToDo]]:
----------
+## ToDo
 
 -   How comes those files aren't uploaded to the GNU mirrors in the
     first place?

Modified: trunk/sviki/GnuArchitecture.mdwn
===================================================================
--- trunk/sviki/GnuArchitecture.mdwn    2023-02-09 09:15:35 UTC (rev 567)
+++ trunk/sviki/GnuArchitecture.mdwn    2023-02-09 09:17:49 UTC (rev 568)
@@ -1,3 +1,5 @@
+# Hosts of the GNU Project
+
 -   savannah: hosting Savane webui & trackers, VCSs (cvs, svn, git, hg,
     bzr - anonymous, shell and web accesses), downloads (http & sftp) -
     cf. [[SavannahArchitecture]]

Modified: trunk/sviki/ListServer.mdwn
===================================================================
--- trunk/sviki/ListServer.mdwn 2023-02-09 09:15:35 UTC (rev 567)
+++ trunk/sviki/ListServer.mdwn 2023-02-09 09:17:49 UTC (rev 568)
@@ -1,16 +1,16 @@
-Mailing Lists Server
+Mailing List Server
 ====================
 All gnu and nongnu (there are other domains too) mailing lists are
 processed on `lists.gnu.org` using the Mailman package. This machine is
 managed by FSF admins. Savannah admins have only non-root access and are
-able to perform limited mailing-list related administration tasks.
+able to perform limited mailing list-related administration tasks.
 
 This page describes commands to manually manage mailing lists
 by Savannah administrators. See also:
 
-* [[MailSystem]] - various email and mailing-list related details
-  in Savannah and gnu systems.
-* [[MailingListsInternals]] - the interface between savannah's php
+* [[MailSystem]] - various email and mailing list-related details
+  in Savannah and GNU systems.
+* [[MailingListsInternals]] - the interface between Savannah PHP
   frontend and Mailman.
 
 
@@ -23,7 +23,7 @@
 
 In order to do this you need to have shell access to `lists.gnu.org` -
 the machine that runs the master Mailman installation.  If you require
-such access, ask one of the other savannah admins to add your ssh
+such access, ask one of the other Savannah admins to add your ssh
 public key.
 
 Once your ssh public key has been added, you can log in as the user
@@ -39,7 +39,7 @@
 the active mailman installation (maintained by FSF sysadmin), or nothing
 will work right.
 
-Mailman home page: <http://www.gnu.org/software/mailman>.
+[Mailman home page](//www.gnu.org/software/mailman)
 
 List creation
 -------------
@@ -47,7 +47,7 @@
 interface.  (This results in an ssh connection to `lists.gnu.org`
 and `newlist` being run there; see the [[MailSystem]] page.)
 
-For lists whose names do not follow an allowed pattern, savannah-hackers
+For lists whose names do not follow an allowed pattern, Savannah hackers
 must manually run `~/mycreate_list.pl` on lists, and then attach the
 list to the given project using `~/bin/ml.pl` on root@mgt0:
 

Modified: trunk/sviki/Mirroring.mdwn
===================================================================
--- trunk/sviki/Mirroring.mdwn  2023-02-09 09:15:35 UTC (rev 567)
+++ trunk/sviki/Mirroring.mdwn  2023-02-09 09:17:49 UTC (rev 568)
@@ -1,7 +1,7 @@
 Mirroring at Savannah
 =====================
 
-NOTE: This is an updated version of the previous [[Mirmon]] page.
+> NOTE: This is an updated version of the previous [[Mirmon]] page.
 
 
 Savannah offers two public-facing mirroring services:
@@ -11,9 +11,9 @@
     `ftpmirror.gnu.org` and `gnu mirror` are used interchangeably in this
     page.
 
-2.  `download.savannah.{nongnu,gnu}.org` - redirects to world-wide mirrors of
-    savannah's [[DownloadArea]]. Typically used for non-gnu software,
-    but gnu packages can store files there as well.
+2.  `download.savannah.{nongnu,gnu}.org` - redirects to world-wide mirrors
+    of [[Savannah download area|DownloadArea]].  Typically used
+    for non-GNU software, but GNU packages can store files there as well.
     `download` and `nongnu mirror` are used interchangeably in this page.
 
 
@@ -48,7 +48,6 @@
 only redirects actual files.  See nginx details below.
 
 
-
 Server-side redirection overview
 --------------------------------
 
@@ -58,7 +57,7 @@
 Both gnu and nongnu redirections are served from
 download0.savannah.gnu.org VM. `ftpmirror.gnu.org` is
 CNAME'd to `ftpmirror.sv.gnu.org`, which points
-to the same IP as download0 (remember savannah admin's
+to the same IP as download0 (remember Savannah admin's
 only control *.sv.gnu.org DNS entries).
 
 The nginx configuration files are:
@@ -132,7 +131,7 @@
     For gnu/ftpmirrors, FSF admins or GNU webmasters update the lists
     (<http://www.gnu.org/prep/ftp.html>, generated from
     <http://www.gnu.org/prep/FTP>).
-    For nongnu/download mirrors, savannah admins update
+    For nongnu/download mirrors, Savannah admins update
     [this file](http://dl.sv.gnu.org/releases/00_MIRRORS.txt)
     (and [html version](http://dl.sv.gnu.org/releases/00_MIRRORS.html)).
 

Modified: trunk/sviki/SavannahArchitecture.mdwn
===================================================================
--- trunk/sviki/SavannahArchitecture.mdwn       2023-02-09 09:15:35 UTC (rev 
567)
+++ trunk/sviki/SavannahArchitecture.mdwn       2023-02-09 09:17:49 UTC (rev 
568)
@@ -1,18 +1,17 @@
-Documentation places
---------------------
+# Savannah architecture
 
--   This wiki:
-    <http://savannah.gnu.org/maintenance/>
+## Documentation places
+
+-   [This wiki](//savannah.gnu.org/maintenance/)
 -   The administration 'infra' repository, with system installation
     notes and maintenance script:
     <http://bzr.savannah.gnu.org/lh/administration/>
     <http://git.savannah.gnu.org/cgit/savane-cleanup/framework.git/>
 
-(All the live code is in the `administration` project; the savane,
-savane-cleanup, and other projects are idle.)
+(All the live code is in the `administration` repository; the savane,
+savane-cleanup, and other repositories are idle.)
 
-Global architecture
--------------------
+## Global architecture
 
 ![Architecture2010.png](/maintenance/Architecture2010.png)
 
@@ -24,14 +23,12 @@
 hardware was donated to the FSF by HP, and the bandwidth is provided by
 the FSF.
 
-Savannah was setup and is maintained by the Savannah Hackers
-([[SavannahTeam]]).
+Savannah was setup and is maintained by the [[Savannah Hackers|SavannahTeam]].
 
-<https://savannah.gnu.org/bzr/?group=administration>
+The [Bazaar repository](//savannah.gnu.org/bzr/?group=administration)
 contains step-by-step notes about the system setup.
 
-Xen/KVM architecture
---------------------
+## Xen/KVM architecture
 
 Savannah operates with five critical Xen/KVM VMs.
 
@@ -41,8 +38,7 @@
 -   vcs0.savannah.gnu.org
 -   download0.savannah.gnu.org
 
-mgt0.savannah.gnu.org
----------------------
+## mgt0.savannah.gnu.org
 
 This is the management VM, where maintenance scripts can be run and
 software can be built for the other four VMs.  Also runs bind (for the
@@ -71,20 +67,17 @@
 management vm on the other vm's without actually being in the mgt vm's
 authorized\_keys file.
 
-internal0.savannah.gnu.org
---------------------------
+## internal0.savannah.gnu.org
 
 The internal0 VM runs mysql.
 
-frontend0.savannah.gnu.org
---------------------------
+## frontend0.savannah.gnu.org
 
 The frontend VM runs the web server instances for Savannah.
 
 The frontend Savane repository pulls from administration/savane.git
 
-vcs0.savannah.gnu.org
----------------------
+## vcs0.savannah.gnu.org
 
 This is the version control system virtual machine. It runs
 cvs/git/bzr/etc as well as webservers for repository viewing.
@@ -97,14 +90,12 @@
 `mysql` module (`libnss-mysql`), also directly against the mysql
 database on internal0.
 
-download0.savannah.gnu.org
---------------------------
+## download0.savannah.gnu.org
 
 This is the "download" vm, it runs a webserver and stores the released
 packages from Savannah.
 
-High load
----------
+## High load
 
 If a DomU is experiencing heavy load, running these commands will
 dump some basic system state for possible post mortems:
@@ -114,8 +105,7 @@
 
 We have often seen high loads due to vc browsers being hit too hard.
 
-Testing Savannah VMs
---------------------
+## Testing Savannah VMs
 
 Frontend serves not just Savannah but also some other virtual sites.
 For testing check this list.
@@ -131,8 +121,7 @@
 
 See also [[SavannahServices]] for list of publically accessible services.
 
-Misc
-----
+## Misc
 
 Suggested Debian mirror:
 <http://debian.csail.mit.edu/debian/>