On Fri, 15 Mar 2002, Amir Abiri wrote:
> From: "Tzafrir Cohen" <[EMAIL PROTECTED]>
>
> > On Fri, 15 Mar 2002, Shlomi Fish wrote:
> >
> > > Are you using CVS to maintain the code? If not - you should. If possible
> > > I'd like to take a look at the code to verify it.
> >
> > CVS is a useful tool when you are already accustomed to it. I figure that
> > the site's source should be eventually available on the sourceforge
> > project's CVS. ("eventually" == sometime *before* it becomes the main page
> > of iglu)
>
> I was under the impression that CVS is for multi-programmer projects ( and
> therefore failed to see the need for it in a one-man-project, or even three,
> but it seems i was wrong... ).
>
I use CVS even for stuff I work on entirely on my own. It's good for
keeping old versions, reverting to history, etc. It's also highly
addictive, and you eventually wonder how you managed without it<tm>.
Besides, it is possible that I or someone else may wish to view or
download the code, or even apply patches to it. We have a CVS server on
SourceForge, so please use it.
> > > So, please either
> > > comment reasonably, write a design document, an architecture document,
> > > and/or follow other good documnting methodologies.
>
> I comment a lot. Mainly from one reason: That i hardly remember why i wrote
> thing the way i wrote them after a week or so.
>
Programmers' Amnesia? :-) Well, just makes sure everybody understands your
comment. I've seen commented code where the comments were very unhelpful.
> > No need to over-design :-)
> >
> > This is not a big project (I believe), so enough comments in the code to
> > make it readable, and a reasonable README that will also describe how
> > things work will probably be enough for now.
>
> That's what i thought two.
>
OK.
Regards,
Shlomi Fish
> --
> http://abiri-e.com/
> "God is a programmer".
>
>
> ----------------------------------------------------------------------------
> To unsubscribe, send a message to [EMAIL PROTECTED]
> Archives available at http://www.mail-archive.com/[email protected]/
>
----------------------------------------------------------------------
Shlomi Fish [EMAIL PROTECTED]
Home Page: http://t2.technion.ac.il/~shlomif/
Home E-mail: [EMAIL PROTECTED]
"Let's suppose you have a table with 2^n cups..."
"Wait a second - is n a natural number?"
----------------------------------------------------------------------------
To unsubscribe, send a message to [EMAIL PROTECTED]
Archives available at http://www.mail-archive.com/[email protected]/
