[Savannah-cvs] administration/docs/hacking_savannah hacking_sa...

[Sylvain Beucler]

CVSROOT:        /cvsroot/administration
Module name:    administration
Branch:         
Changes by:     Sylvain Beucler <address@hidden>        04/09/21 23:28:00

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

Log message:
        Improved sections about team work, Mailman, and test installing

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/administration/administration/docs/hacking_savannah/hacking_savannah.texi.diff?tr1=1.43&tr2=1.44&r1=text&r2=text

Patches:
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.43 
administration/docs/hacking_savannah/hacking_savannah.texi:1.44
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.43     Tue Sep 
21 21:21:23 2004
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Tue Sep 21 
23:28:00 2004
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.43 2004/09/21 21:21:23 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.44 2004/09/21 23:28:00 Beuc Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -62,7 +62,7 @@
 
 @menu
 * Introduction::                About this manual.
-* Communication::               Getting in sync with the Savannah Team.
+* Team work::                   
 * Savannah configuration::      Savannah configuration in-depth description.
 * Using MySQL::                 
 * Mailman Administration::      Mailman command line tips.
@@ -77,7 +77,7 @@
 @end menu
 
 
address@hidden Introduction, Communication, Top, Top
address@hidden Introduction, Team work, Top, Top
 @chapter Introduction
 
 @menu
@@ -120,17 +120,71 @@
 
 
 
address@hidden Communication, Savannah configuration, Introduction, Top
address@hidden Team work, Savannah configuration, Introduction, Top
 @chapter Communication
 
 
 @menu
+* Priority list::               
+* Logging and documenting::     
 * WWW::                         
 * Mailing lists::               
 * IRC::                         
 @end menu
 
address@hidden WWW, Mailing lists, Communication, Communication
+
address@hidden Priority list, Logging and documenting, Team work, Team work
address@hidden Priority list
+
address@hidden
address@hidden
+Keeping users informed
address@hidden
+Fixing broken services
address@hidden
+Answering support requests
address@hidden
+Reviewing pending projects
address@hidden
+Improving Savannah
address@hidden enumerate
+
+
address@hidden Logging and documenting, WWW, Priority list, Team work
address@hidden Logging and documenting
+
+All the Savannah hackers must know of each others works in details. We
+need this so that:
address@hidden
address@hidden
+No Savanah hackers work on an issue at the same time than another
+Savannah hackers, without knowing it
address@hidden
+If a Savannah hackers is hit by a truck or suddently busy, somebody
+else can perform the same kind of job or continue it quickly simply by
+studying the documentation of the work previously done.
address@hidden
+Any decision is, if not previously discussed, carefully explained
+somewhere.
address@hidden
+It makes possible to recreate the Savannah configuration in a test
+installation without much research.
address@hidden itemize
+
+There are several logging places:
address@hidden @emph
address@hidden IRC
+To tell other hackers what you are currently doing
address@hidden ChangeLog
+There is one at savannah and another one at lists. To explain what you
+did.
address@hidden This document
+Section about test installation should be kept up-to-date at any time,
+and recurrent jobs should be documented.
address@hidden table
+
+
address@hidden WWW, Mailing lists, Logging and documenting, Team work
 @section WWW
 
 Read the latest news on the Savannah main page, so you know what is
@@ -148,7 +202,7 @@
 Also read Savannah's FAQ.
 
 
address@hidden Mailing lists, IRC, WWW, Communication
address@hidden Mailing lists, IRC, WWW, Team work
 @section Mailing lists
 
 @menu
@@ -236,7 +290,7 @@
 projects one).
 
 
address@hidden IRC,  , Mailing lists, Communication
address@hidden IRC,  , Mailing lists, Team work
 @section IRC
 
 Currently, we have a channel, #savannah, on @uref{irc.freenode.net}
@@ -251,7 +305,7 @@
 all important, policy-related and administrative decisions are made.
 
 
address@hidden Savannah configuration, Using MySQL, Communication, Top
address@hidden Savannah configuration, Using MySQL, Team work, Top
 @chapter Savannah configuration
 
 This chapter will present how Savannah is set up. Informations on how
@@ -886,6 +940,7 @@
 $ ln -s /usr/savannah/infra/misc/crontab savannah
 # Edit the cronjob's MAILTO, comment out uneeded stuff
 # edit the Conf.pm so as to make the system believe you are at Savannah
+# edit sv_users and replace mkdir($home) by 'mkdir -p $home`
 
 
 @node Using MySQL, Mailman Administration, Savannah configuration, Top
@@ -958,6 +1013,7 @@
 @menu
 * Access to lists.gnu.org::     
 * Creating a new list::         
+* Moving a list::               
 @end menu
 
 @node Access to lists.gnu.org, Creating a new list, Mailman Administration, 
Mailman Administration
@@ -982,7 +1038,7 @@
 that are discussed below.
 
 
address@hidden Creating a new list,  , Access to lists.gnu.org, Mailman 
Administration
address@hidden Creating a new list, Moving a list, Access to lists.gnu.org, 
Mailman Administration
 @section Creating a new list
 
 To Create a new mailing list, you first need the following information:
@@ -1012,7 +1068,8 @@
 make it look like a Real Password. Moreover, you just saved the
 password and will be able to copy-paste it in the mail you'll send to
 the guy (unless Mailman does that when he notifies the list owner?
-Needs to be checked...)
+Needs to be checked... => it does... still useful when reseting a
+pass)
 
 @example
 $ mkdir /var/mailman/lists/@var{new-list-name}/domains
@@ -1048,6 +1105,11 @@
 
 If the list you have just created is for a non-GNU project.
 
+You can ignore the @samp{Non-standard property restored: web_page_url}
+warning. It would be good to get rid of it, though [TODO].
+
+
+
 You also need to work around a bug in Mailman, using this little
 script from Jim:
 @example
@@ -1067,6 +1129,20 @@
 And that's it.
 
 
address@hidden Moving a list,  , Creating a new list, Mailman Administration
address@hidden Moving a list
+
+[TODO]
+
address@hidden
address@hidden
+Change in domains/
address@hidden
+Change in the Mailman configuration via webui (near the end of main
+admin page)
address@hidden itemize
+
+
 @node Some Savannah tasks, Frequent support requests, Mailman Administration, 
Top
 @chapter Some Savannah tasks