]> projects.mako.cc - fspm_howto/log
fspm_howto
19 years agoThis version includes the following changes
Benj. Mako Hill [Sat, 4 Jun 2005 00:09:13 +0000 (00:09 +0000)]
This version includes the following changes
Author: mako
Date: 2002/04/15 21:15:34
This version includes the following changes:

* More information about the mechanics of licensing.
* Several additions under the "Other Documentation Hints."
* Some specifics on package naming (with a ref to ESR's howto).
* A new section on encouraging good patching (also with a ref).
* More specifics on announcing the software.
* Quite a number of grammar, spelling, and other small errors.

Also, as per user request, I've added a number of new documents to the
bibliography. I've added information and references from these docs
into appropriate places in the HOWTO. As per request, I've gone
through and provided references to Eric Raymond's Software Release
Practices HOWTO in the places where it seemed relevant helping to make
the two work together a bit. These slight overlap areas are evident in
the list of changes above.

19 years ago* some more changes (fixes) to render_sgml
Benj. Mako Hill [Sat, 4 Jun 2005 00:09:11 +0000 (00:09 +0000)]
* some more changes (fixes) to render_sgml
Author: mako
Date: 2001/06/21 10:05:23
* some more changes (fixes) to render_sgml

* a spelling change sent in by Andrew Shugg

* an addition to the TODO (also by Andrew) that calls for tweaking
with way that the appendix (license) is sectioned off and renders

19 years agochanged render_sgml to be a makefile and added a bunch of
Benj. Mako Hill [Sat, 4 Jun 2005 00:09:06 +0000 (00:09 +0000)]
changed render_sgml to be a makefile and added a bunch of
Author: mako
Date: 2001/06/19 10:32:23
changed render_sgml to be a makefile and added a bunch of
functionality to the script (which now works and has been tested!)

19 years agoadding a build script for rending the sgml into all the forms in a temporary
Benj. Mako Hill [Sat, 4 Jun 2005 00:09:03 +0000 (00:09 +0000)]
adding a build script for rending the sgml into all the forms in a temporary
Author: mako
Date: 2001/06/19 10:17:16
adding a build script for rending the sgml into all the forms in a temporary
directory

19 years agoupdated the revision history to show an increase in version number
Benj. Mako Hill [Sat, 4 Jun 2005 00:09:01 +0000 (00:09 +0000)]
updated the revision history to show an increase in version number
Author: mako
Date: 2001/06/19 08:49:48
updated the revision history to show an increase in version number

19 years ago* a whole bunch of small changes, centered in the introduction
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:59 +0000 (00:08 +0000)]
* a whole bunch of small changes, centered in the introduction
Author: mako
Date: 2001/06/19 08:47:31
* a whole bunch of small changes, centered in the introduction
* relicensed under the GDL and followed the intructions on the LDP website
on how to do that license most effectively and legally appropriate

19 years agoThanks Andy King for suggesting that the use of quotes and emphasis be
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:56 +0000 (00:08 +0000)]
Thanks Andy King for suggesting that the use of quotes and emphasis be
Author: mako
Date: 2001/05/06 21:27:40
Thanks Andy King for suggesting that the use of quotes and emphasis be
standardized in the HOWTO. Thank you so much Andy.

19 years agoA diff fixing a ton of errors made by Andy King. The Diff follow
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:54 +0000 (00:08 +0000)]
A diff fixing a ton of errors made by Andy King. The Diff follow
Author: mako
Date: 2001/05/06 21:24:26
A diff fixing a ton of errors made by Andy King. The Diff follow:
L84   - added "s" to "thing"
L17   - do = does -- necessary? the "(s)" makes it a little confusing, but
because it is primarily "author" (not plural), then "does" makes more
sense.
L186  - take = make
L308  - how = who
L387  - added comma between "work" and "while"
L412  - perhaps add "If not, you should probably think about contributing to an
existing free software application.  It will accomplish the same goals
that your own project would, and most likely make a better application
than if there were two seperate ones." or something to that degree --
sort of like where you talk about forking later on; except that later on
you're talking about how to deal with forks in the new project.  This
isn't really "forking," but more like "fracturing."  You do mention that
later, in "Deciding to proceed" but I can't decide which place is more
appropriate.
L484  - <nitpick> "useful gap" is awkward -- the gap isn't useful, the filling
of it is.</nitpick>
L488  - The = the
L490  - how = who
L504  - bellow = below
- "searching of their databases" might want to be changed to "database
searches of existing software"
L526  - On the /. frontpage its stated as "News for Nerds. Stuff that matters."
L528  - new = news
L229  - an = a
L230  - added comma between "here" and "so"
- added "is"
L464  - removed repetative "is"
L540  - an = a
L546  - rm'd "at"
L596  - added comma between "management" and "but"
L597  - be = get
L599  - switched comma position around "but"
L600  - added "s" to "remember"
L663  - added "be" between "can" and "flexible"
L736  - added "also" -- as it was before, it seems like the "but" is
contradicting your previous statement when in fact you are re-inforcing
it.
L1152  - removed "a" between "in" and "the"
L1184  - added "and" between "possible" and "are"
L1198  - removed comma between "been" and "changed"
L1271  - added "to" after "hesitate"
L1310  - distributiosn = distributions
L1328  - is the use of "problems" and then later "less problematic" redunant to
you?
L1348  - added "have" after "should"
L2285  - large = largely

19 years agomispelled management in a link
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:52 +0000 (00:08 +0000)]
mispelled management in a link
Author: mako
Date: 2001/05/05 17:47:39
mispelled management in a link

19 years agoFixed some extra slashes in the links. <DOH!>
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:50 +0000 (00:08 +0000)]
Fixed some extra slashes in the links. <DOH!>
Author: mako
Date: 2001/05/05 17:41:52
Fixed some extra slashes in the links. <DOH!>

19 years agoMore fixes made before the release of the new version.
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:47 +0000 (00:08 +0000)]
More fixes made before the release of the new version.
Author: mako
Date: 2001/05/05 16:27:37
More fixes made before the release of the new version.

19 years agoChanged the name from the "Free Software Development HOWTO" to the
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:45 +0000 (00:08 +0000)]
Changed the name from the "Free Software Development HOWTO" to the
Author: mako
Date: 2001/05/05 16:01:45
Changed the name from the "Free Software Development HOWTO" to the
much more specific "Free Software Project Management HOWTO." I like it
better and some of the early readers agree that this is an intelligent
change.

19 years agoChanging the Name of the HOWTO files in the CVS repository.
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:42 +0000 (00:08 +0000)]
Changing the Name of the HOWTO files in the CVS repository.
Author: mako
Date: 2001/05/05 15:47:33
Changing the Name of the HOWTO files in the CVS repository.

19 years agoA final revision making some changes in linktext and making forking
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:42 +0000 (00:08 +0000)]
A final revision making some changes in linktext and making forking
Author: mako
Date: 2001/04/10 13:21:56
A final revision making some changes in linktext and making forking
its own section so it doesn't seem like its just another section on
branching. I changed a little bit of the text of the forking section
to try and reflect this organizational change.

19 years agoAdded a list of 6 items to the TODO from an email from Josh Crawford.
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:36 +0000 (00:08 +0000)]
Added a list of 6 items to the TODO from an email from Josh Crawford.
Author: mako
Date: 2001/04/09 15:51:28
Added a list of 6 items to the TODO from an email from Josh Crawford.
These should be fixed and probably call for another release of the
HOWTO before Tuesday. :(

19 years agoMajor readthrough. Major changes, and minor additions. More than I can
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:34 +0000 (00:08 +0000)]
Major readthrough. Major changes, and minor additions. More than I can
Author: mako
Date: 2001/04/09 05:39:03
Major readthrough. Major changes, and minor additions. More than I can
list here.

This is version v0.2 of the HOWTO with substantial changes over the
last release.

19 years agoMajor, major revisions and additions.
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:28 +0000 (00:08 +0000)]
Major, major revisions and additions.
Author: mako
Date: 2001/04/08 23:58:49
Major, major revisions and additions.

I've added an extensive reference section, paragraphs on CVS, a
section on naming a project, more information on decision making and
delegation and much more.

I've also made major changes to the nature of the resources file
(which I may change back) and really did a number on the TODO file (as
I DID most of the things that needed doing. :) Yeah!)

A read through and minor alterations are all that stand between this
version and a v0.2 release.

19 years agoFixed some formatting in the HOWTO.
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:22 +0000 (00:08 +0000)]
Fixed some formatting in the HOWTO.
Author: mako
Date: 2001/04/07 07:05:58
Fixed some formatting in the HOWTO.

19 years agoA lot organizational change but not much content yet. Mostly in
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:20 +0000 (00:08 +0000)]
A lot organizational change but not much content yet. Mostly in
Author: mako
Date: 2001/04/07 07:04:53
A lot organizational change but not much content yet. Mostly in
preperation for the v0.2 which I plan on doing most of the work for
tomorrow (and getting the version released the same day).

I removed both the linuxdoc and the docbook template from the CVS
repository because they don't seem as useful anymore now that the
HOWTO is pretty much written and I am much more familiar with DocBook.

I added a TODO file and a RESOURCES file. The TODO file has a list of
all the stuff that I want to do with the HOWTO tomorrow and a list of
links/sources that I still need to check out.

The RESOURCES is empty right now but will house the list of those
resources with a few sentances on what is at each link.

19 years agoI fixed a couple grammatical errors that Andy King emailed me and
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:13 +0000 (00:08 +0000)]
I fixed a couple grammatical errors that Andy King emailed me and
Author: mako
Date: 2001/04/06 04:52:57
I fixed a couple grammatical errors that Andy King emailed me and
started myself off on the road to v0.2 which I am going to try and
release in the next couple of days if I can. :) Ugh.

Anyway. Andy also suggested that I add a paragraph about using version
control systems with a couple ideas of CVS equiavalents on Windoze as
well as CVS which I use. I will try to incrorporate that into the next
version. I also have a whole back of links from advogato that I've
been reading through and getting highlights from. I am will spend a
good check of tomorrow trying to synthesize that stuff all in before I
have a big ol' proof reading party with a couple friends and try to
get a relatively error free version v0.2 out before tomorrow night. :)

I may try to have another error fixes but one goal is to have a stable
version out by Tuesday for a final meeting. I will get comments there
that might push me towards a version that I will try and submit to
advogato first and then maybe LDP as a real HOWTO. :)

19 years agoBugs fixed.
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:09 +0000 (00:08 +0000)]
Bugs fixed.
Author: mako
Date: 2001/03/28 05:17:43
Bugs fixed.
Document reread.
0.1 RELEASED!!!!!

19 years agoI fixed a weird rending problem that was causing one character
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:05 +0000 (00:08 +0000)]
I fixed a weird rending problem that was causing one character
Author: mako
Date: 2001/03/27 22:15:51
I fixed a weird rending problem that was causing one character
indentation on all variable lists. <shrug>

I've also reread first section (intro) of the documention on the
initial reread.

19 years agoRe-Read up through Ch1. Three chapters to reread and edit before a 0.1
Benj. Mako Hill [Sat, 4 Jun 2005 00:08:01 +0000 (00:08 +0000)]
Re-Read up through Ch1. Three chapters to reread and edit before a 0.1
Author: mako
Date: 2001/03/27 14:56:58
Re-Read up through Ch1. Three chapters to reread and edit before a 0.1
release. Yeah. :)

19 years agofixed one word in the last paragraph
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:57 +0000 (00:07 +0000)]
fixed one word in the last paragraph
Author: mako
Date: 2001/03/27 03:53:04
fixed one word in the last paragraph

19 years agoFinished the first draft of the HOWTO --AND-- spelled check the entire
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:53 +0000 (00:07 +0000)]
Finished the first draft of the HOWTO --AND-- spelled check the entire
Author: mako
Date: 2001/03/27 03:28:56
Finished the first draft of the HOWTO --AND-- spelled check the entire
thing. Every section should be filled in. A final read through and
something that describes how webserves and ftp servers should have the
necessary bandwidth before a program is released.

19 years agoFinished section 3 on interacting with developers.. just one more
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:49 +0000 (00:07 +0000)]
Finished section 3 on interacting with developers.. just one more
Author: mako
Date: 2001/03/26 22:36:51
Finished section 3 on interacting with developers.. just one more
section to go on interacting with users (4 subsections) before the
first draft is finished.

19 years agoI've removed the section on code cram because it doesn't seem
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:45 +0000 (00:07 +0000)]
I've removed the section on code cram because it doesn't seem
Author: mako
Date: 2001/03/26 17:23:21
I've removed the section on code cram because it doesn't seem
relative. I finished written the section on delegation and had a
couple orgazational crises on the way but it seems to look nice. I
used a sect3 and several sec4 insetead of an itemized list but I think
it looks a lot btter now.

19 years agoFinished most of delegation except the first and last thing in the
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:41 +0000 (00:07 +0000)]
Finished most of delegation except the first and last thing in the
Author: mako
Date: 2001/03/26 06:26:43
Finished most of delegation except the first and last thing in the
itemized list toward the bottom. Get to that first thing in the
morning. Yawn.

19 years agoSection 2 on completely a project is complete. The whole thing
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:37 +0000 (00:07 +0000)]
Section 2 on completely a project is complete. The whole thing
Author: mako
Date: 2001/03/26 04:46:54
Section 2 on completely a project is complete. The whole thing
validates and looks good with db2html and db2ps. All that's left to be
written is the two Maintaining Sections.

19 years agoI fixed lots of little bugs, the subsections on choosing a license and
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:33 +0000 (00:07 +0000)]
I fixed lots of little bugs, the subsections on choosing a license and
Author: mako
Date: 2001/03/26 01:38:50
I fixed lots of little bugs, the subsections on choosing a license and
on version numbering. I also removed the last subsection of the
starting section on "Nurtuing Future Development" because much of
seems like it it was too small and the information that belonged under
it could go into sections like presentation and under working with
developers. :)

19 years agoFinished going through and writing the "Starting a Project" general
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:29 +0000 (00:07 +0000)]
Finished going through and writing the "Starting a Project" general
Author: mako
Date: 2001/03/25 19:40:27
Finished going through and writing the "Starting a Project" general
introduction and writing the entire "Choosing a Project" subsection.
There are some errors that need to be fixed with URLs (the url is
entered twice and shouldn't be).

19 years agoOnly small changes and fixes. I also removed all the samples and
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:26 +0000 (00:07 +0000)]
Only small changes and fixes. I also removed all the samples and
Author: mako
Date: 2001/03/25 17:46:24
Only small changes and fixes. I also removed all the samples and
learning stuff that was left over from the template.

19 years agoJust a few bug fixes including mispellings in tag names.
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:22 +0000 (00:07 +0000)]
Just a few bug fixes including mispellings in tag names.
Author: mako
Date: 2001/03/25 09:09:19
Just a few bug fixes including mispellings in tag names.

19 years agoI've completed a first through on everything in the introduction. I
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:18 +0000 (00:07 +0000)]
I've completed a first through on everything in the introduction. I
Author: mako
Date: 2001/03/23 23:56:16
I've completed a first through on everything in the introduction. I
also went through and did an indexterm for the three major sect1s that
were not the intro. I'm ready to start writing the actual howto now!
:)

19 years agoI've gone through from the beginning and got up to "Credits" in the Intro.
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:14 +0000 (00:07 +0000)]
I've gone through from the beginning and got up to "Credits" in the Intro.
Author: mako
Date: 2001/02/07 05:11:05
I've gone through from the beginning and got up to "Credits" in the Intro.
I've done a good once over on the intro  text but it will need to be revised
and the rest of it is probably spelled horribly with bad grammer. "Credits"
is the first section that I have not done.

19 years agoAdded FreeSoftwareDevelopment which is the actual HOWTO document. So far, it
Benj. Mako Hill [Sat, 4 Jun 2005 00:07:11 +0000 (00:07 +0000)]
Added FreeSoftwareDevelopment which is the actual HOWTO document. So far, it
Author: mako
Date: 2001/01/02 21:48:33
Added FreeSoftwareDevelopment which is the actual HOWTO document. So far, it
is mostly just a copy of the template but I've put in an outline that goes
as far as halfway through the 'Interacting with Users' section and still has
mot of the old stuff.

19 years agoInitial revision
Benj. Mako Hill [Sat, 4 Jun 2005 00:06:57 +0000 (00:06 +0000)]
Initial revision
Author: makolee
Date: 2001/01/02 20:59:48
Initial revision

Benjamin Mako Hill || Want to submit a patch?