Re: Moving on...

new topic     » goto parent     » topic index » view thread      » older message » newer message

Matt,

Could you give some detail on the mods you've made to your copy of
MakeDoc.exw?

I ask because although I've been temporarily side-tracked,  I was (& intend
to return to) making an "editor" intended to make it easy to add the
slash-tag style commenting to any existing library, so MakeDoc can use that
library to create the htm doc.  Idea is for library creator not to have to
concern themselves with the slash-tags, just fill out a "form" for each
global intended for library user use.

Dan Moyer


From: Matt Lewis >
> From: Peter Willems
> > Al Getz wrote:
> > > It's true that development goes faster when there is more
> > > then one person working on something, but the thing is,
> > > does everyone really want to work on the same exact project?
> >
> >    I think that other projects are showing that it can work this
> >    way. I do think that more people would like to participate IF
> >    they actually knew that they could. I think that some form of
> >    project management (through a community site) would help much
> >    to attract participants in the first place.
>
> I think it's important to remember that a 'project team' isn't synonymous
> with 'coders' (I know that Peter and Derek are posting with this in mind).
> Even simple help with documentation can dramatically raise the quality of
a
> project.  I strongly recommend using the makedoc utility that comes with
> Win32Lib (I've made a lot of modifications to my copy).  It makes the
> process a lot less painful.  Since I've started using it religiously, I
> think my documentation has seen huge improvements (I'd rate most of it at
> poor to fair now :).  One thing that's always a turnoff to me is a short
> readme.txt file saying to look at the comments in the file to see how
> everything works.  Please use some sort of doc generator (like the
> above-mentioned makedoc.exw) that pulls those comments out into an HTML
file
> or something.  The easier and more user friendly your projects, the better
> they'll be received.  It's always worth delaying a day to release if you
> spend the time documenting everything.  Plus testers and demo writers are
a
> lot of help.
>
> One problem, as Al alludes, is that many projects cover a fairly narrow
> spectrum of interest.  There may be only 2 or 3 people even remotely
> interested in a project in the Euphoria community.  Unless its something
you
> feel very passionate about, without interest and feedback from others, you
> *will* lose interest in any project.  This often leads others to believe
> that the project is dead.  They don't inquire about it, seeing that it's
> very incomplete and inactive, and so the developer never regains interest
in
> it.  It's a chicken and the egg scenario in some respects.
>
>
> > > Usually this isnt the case unless there is some concrete
> > > reward, even if it's small.  Most people i think do what they
> > > do because they really want to do it, not because they are
> > > getting paid smile
> >
> >    Agreed. But I'm sure there are more people that would like
> >    to help, just for the fun of it.
>
> We actually have a reward system.  No one's going to get rich off the
> MicroEconomy, but it's a great way to recognize the efforts of others, not
> to mention encourage them.  Personally, I feel it to be a responsibility
to
> put my votes in (just like voting in real elections).  I don't always vote
> for things that I actually have a use for, but often for projects that
seem
> interesting to me for one reason or another.  I hope that the votes help
> motivate the authors to continue to develop.
>
> Matt Lewis
>
>
>
> TOPICA - Start your own email discussion group. FREE!
>

new topic     » goto parent     » topic index » view thread      » older message » newer message

Search



Quick Links

User menu

Not signed in.

Misc Menu