Re-Read up through Ch1. Three chapters to reread and edit before a 0.1

[fspm_howto] / FreeSoftwareDevelopmentHOWTO.sgml

diff --git a/FreeSoftwareDevelopmentHOWTO.sgml b/FreeSoftwareDevelopmentHOWTO.sgml
index 96b8dd146551bc05cec7247714f71b53d5fdd9b3..66fd9c60e98fbecc0b3d9463e2bc8fe69169dda6 100644 (file)
--- a/FreeSoftwareDevelopmentHOWTO.sgml
+++ b/FreeSoftwareDevelopmentHOWTO.sgml
@@ -39,10 +39,10 @@
      This HOWTO is designed for people with experience in programming
      and some skills in managing a software project but who are new to
      the world of Free Software. This document is meant to act as a
      This HOWTO is designed for people with experience in programming
      and some skills in managing a software project but who are new to
      the world of Free Software. This document is meant to act as a

-     guide to the non-technical aspects of programming and was written
-     to act as a crash course in the people skills that aren't taught
-     to commercial coders but that can make or break a free software
-     project.
+     guide to the non-technical aspects of free software development
+     and was written to act as a crash course in the people skills
+     that aren't taught to commercial coders but that can make or
+     break a free software project.

     </para>
   </abstract>
 
     </para>
   </abstract>
 


@@ -80,9 +80,9 @@
    This HOWTO tries to do a lot of thing (probably too many), but it
    can't answer that question and won't attempt it. What this HOWTO
    will attempt to do is give your Free Software project a fighting
    This HOWTO tries to do a lot of thing (probably too many), but it
    can't answer that question and won't attempt it. What this HOWTO
    will attempt to do is give your Free Software project a fighting

-   chance-an edge. If you write a piece of crap that no one is
-   interested in, you can read this HOWTO until you recite it in your
-   sleep and your project will probably fail. Then again, you can
+   chance--an edge. If you write a piece of crap that no one is
+   interested in, you can read this HOWTO until you can recite it in
+   your sleep and your project will probably fail. Then again, you can

    write a beautiful, relevant piece of software and follow every
    instruction in this HOWTO and your software may still not make
    it. Sometimes life is like that. However, I'll go out a limb and
    write a beautiful, relevant piece of software and follow every
    instruction in this HOWTO and your software may still not make
    it. Sometimes life is like that. However, I'll go out a limb and


@@ -95,15 +95,11 @@
    A lot of the information in this HOWTO is best called common
    sense. Of course, as any debate on interfaces will prove, what is
    common sense to some programmers proves totally unintuitive to
    A lot of the information in this HOWTO is best called common
    sense. Of course, as any debate on interfaces will prove, what is
    common sense to some programmers proves totally unintuitive to

-   others. After explaining bites and pieces of this HOWTO to Free
-   Software developers on several occasions, I realized that that
-   writing this HOWTO might provide a useful resource and a forum for
+   others. After explaining bits and pieces of this HOWTO to Free
+   Software developers on several occasions, I realized that writing
+   this HOWTO might provide a useful resource and a forum for

    programmers to share ideas about what has and has not worked for
    programmers to share ideas about what has and has not worked for

-   them. 
-  </para>
-
-  <para>
-
+   them.

   </para>
 
   <para>
   </para>
 
   <para>


@@ -124,13 +120,13 @@
    </para>
 
    <para>
    </para>
 
    <para>

-    Unless otherwise stated, Linux HOWTO documents are
-    copyrighted by their respective authors. Linux HOWTO documents may
-    be reproduced and distributed in whole or in part, in any medium
-    physical or electronic, as long as this copyright notice is
-    retained on all copies. Commercial redistribution is allowed and
-    encouraged; however, the author would like to be notified of any
-    such distributions.
+    Unless otherwise stated, Linux HOWTO documents are copyrighted by
+    their respective authors. Linux HOWTO documents may be reproduced
+    and distributed in whole or in part, in any medium physical or
+    electronic, as long as this copyright notice is retained on all
+    copies. Commercial redistribution is allowed and encouraged;
+    however, the author would like to be notified of any such
+    distributions.

    </para>
 
    <para>
    </para>
 
    <para>


@@ -144,14 +140,14 @@
    </para>
 
    <para>
    </para>
 
    <para>

-    In short, we wish to promote dissemination of this
-    information through as many channels as possible. However, we do
-    wish to retain copyright on the HOWTO documents, and would like to
-    be notified of any plans to redistribute the HOWTOs.
+    In short, we wish to promote dissemination of this information
+    through as many channels as possible. However, we do wish to
+    retain copyright on the HOWTO documents, and would like to be
+    notified of any plans to redistribute the HOWTOs.

    </para>
 
    <para>
    </para>
 
    <para>

-    If you have any questions, please contact 
+    If you have any questions, please contact

     <email>linux-howto@metalab.unc.edu</email>
    </para>
   </sect2>
     <email>linux-howto@metalab.unc.edu</email>
    </para>
   </sect2>


@@ -163,11 +159,11 @@
 
    <para>
     No liability for the contents of this documents can be accepted.
 
    <para>
     No liability for the contents of this documents can be accepted.

-    Use the concepts, examples and other content at your own risk.
-    As this is a new edition of this document, there may be errors
-    and inaccuracies, that may of course be damaging to your system.
-    Proceed with caution, and although this is highly unlikely,
-    the author(s) do not take any responsibility for that.
+    Use the concepts, examples and other content at your own risk.  As
+    this is a new edition of this document, there may be errors and
+    inaccuracies, that may of course be damaging to your system.
+    Proceed with caution, and although this is highly unlikely, the
+    author(s) do not take any responsibility for that.

    </para>
 
    <para>
    </para>
 
    <para>


@@ -194,7 +190,7 @@
    <title>New Versions</title>
 
     <indexterm>
    <title>New Versions</title>
 
     <indexterm>

-     <primary>(your index root)!news on</primary>
+     <primary>fswd!news on</primary>

     </indexterm>
 
    <para>
     </indexterm>
 
    <para>


@@ -275,7 +271,10 @@
     more. <ulink url="http://cvsbook.red-bean.com">The book's
     website</ulink> has information on ordering the book and provides
     several translations of the chapters on CVS. I you are seriously
     more. <ulink url="http://cvsbook.red-bean.com">The book's
     website</ulink> has information on ordering the book and provides
     several translations of the chapters on CVS. I you are seriously

-    interested in running a Free Software project, you want this book.
+    interested in running a Free Software project, you want this
+    book. I tried to mention Fogel in sections of this HOWTO where I
+    knew I was borrowing directly from his ideas. If I missed any, I'm
+    sorry, and I'll try and have those fixed in future versions.

    </para>
    
    <para>
    </para>
    
    <para>


@@ -283,25 +282,25 @@
     com</email>
    </para>
    <para>
     com</email>
    </para>
    <para>

-    Also providing support and material, and inspiration for this
-    HOWTO is Eric S. Raymond for his prolific, consistent, and
-    carefully crafted arguments, to Lawrence Lessig for reminding me
-    of the importance of Free Software and to every user and developer
+    Also providing support material, and inspiration for this HOWTO is
+    Eric S. Raymond for his prolific, consistent, and carefully
+    crafted arguments, Lawrence Lessig for reminding me of the
+    importance of Free Software and finally, every user and developer

     involved with the <ulink url="http://www.debian.org">Debian
     Project</ulink>. The project has provided me with a home, a place
     involved with the <ulink url="http://www.debian.org">Debian
     Project</ulink>. The project has provided me with a home, a place

-    to practice Free Software advocacy and to make a difference, a
-    place to learn from those how have been involved with the movement
-    much longer than I, and an proof of a Free Software project that
-    <emphasis>definitely, definitely works</emphasis>.
+    to practice Free Software advocacy, a place to make a difference,
+    a place to learn from those how have been involved with the
+    movement much longer than I, and proof of a Free Software project
+    that definitely, definitely works.

    </para>
 
    <para>
     Above all, I want to thank <emphasis>Richard Stallman</emphasis>
     for his work at the Free Software Foundation and for never giving
    </para>
 
    <para>
     Above all, I want to thank <emphasis>Richard Stallman</emphasis>
     for his work at the Free Software Foundation and for never giving

-    up. Stallman provided the philosophical basis that attracts me to
-    Free Software and that drives me towards writing a document to
-    make sure it succeeds. RMS can always be emailed at <email>rms
-    (at) gnu (dot) org</email>.
+    up. Stallman provides and articulates the philosophical basis that
+    attracts me to Free Software and that drives me towards writing a
+    document to make sure it succeeds. RMS can always be emailed at
+    <email>rms (at) gnu (dot) org</email>.

    </para>
 
   </sect2>
    </para>
 
   </sect2>


@@ -314,12 +313,12 @@
    <para>
     Feedback is most certainly welcome for this document. Without your
     submissions and input, this document wouldn't exist. Something
    <para>
     Feedback is most certainly welcome for this document. Without your
     submissions and input, this document wouldn't exist. Something

-    missing? Don't hesitate to contact me and to write a chapter. I
-    want this document to be as much a product of the Free Software
-    development process that it heralds and I think its ultimate
-    success will be rooted in this fact. Please send your additions,
-    comments and criticisms to the following email address :
-    <email>mako@debian. org</email>.
+    missing? Don't hesitate to contact me and to write a chapter or
+    section, or subsection. I want this document to be a product of
+    the Free Software development process that it heralds and I think
+    its ultimate success will be rooted in this fact. Please send your
+    additions, comments and criticisms to the following email address
+    : <email>mako@debian. org</email>.

    </para>
    </sect2>
 
    </para>
    </sect2>
 


@@ -335,7 +334,7 @@
    </para>
    <para>
     However, this HOWTO is still young and I have to yet to be
    </para>
    <para>
     However, this HOWTO is still young and I have to yet to be

-    contacted about a translation so English is all that is
+    contacted about a translation so English is all that is currently

     available. If you would like to help with or do a translation, you
     will gain my utmost respect and admiration and you'll get to be
     part of a cool process. If you are at all interested, please don't
     available. If you would like to help with or do a translation, you
     will gain my utmost respect and admiration and you'll get to be
     part of a cool process. If you are at all interested, please don't