On Sun, 20 Aug 2000, burtonator wrote:
> Jason van Zyl wrote:
> >
> > Hi,
> >
> > cvs co turbine-docs
> >
> > Is where the turbine docs now live. The XML documents
> > are there, plus there is a copy of resultant HTML.
> <snip>
>
> Huh? Did anyone approve a new module in CVS?
I asked, a couple people it should be moved for the reasons
I outlined in the email where I asked the question. Primarily
because I have someone who is willing to look after the docs
but he is not a programmer, and I might have others who
might be interested and I thought it would be better to
separate the modules because they are separate tasks. At
least in professional software development shops. Programmers
don't write professional grade docs, or most don't anyway.
Nothing is carved in stone, the docs can go back if no
one minds non-programmers having write access to the
source.
I asked for opinions and no one responded except for
two people who agreed (Daniel and Josh). I also asked
what the policy was for approving something, I got
CVS write with three +1, that's what I had for the
new module. No one disagreed. Like I said not
carved in stone, I wanted to discuss it but no
one seemed very interested.
> This breaks how we have
> historically added modules. -1. I am sure the Jakarta PMC would -1
> this if a move ever happens. What is wrong with ./xdocs?
It's certainly something to discuss. I've never kept the docs
for a product in the same module as the product itself.
If there separated then the documentors can choose whatever
tools they want and figure it out amongst themselves
without having to worry about adding things to the
main branch and break builds and what not.
Like I said I have a friend who wants to doc Turbine
from one end to the other, but was slightly paranoid
about CVS write access in the main branch.
It's totally up for discussion, I just want it
to be easy and safe for documentors to make changes.
My friend is certainly not technically challenged,
but he's no programmer and just learning to use
CVS. I was just trying to make his entrace a little
gentler.
> > I'm going to remove the turbine/xdocs files,
> > but the directory will remain there. Someone
> > who has access to the CVS server should
> > probably wipe it out, and we should all
> > checkout turbine again.
>
> ... no. Not necessary. cvs update -d -P will take care of this.
> Removing the dir on the CVS server will wipe out Attic information....
> which is something we don't want to happen.
Thanks. Didn't know that. I'm sure Jon would have stopped
that.
jvz.
--
Jason van Zyl
[EMAIL PROTECTED]
------------------------------------------------------------
To subscribe: [EMAIL PROTECTED]
To unsubscribe: [EMAIL PROTECTED]
Search: <http://www.mail-archive.com/turbine%40list.working-dogs.com/>
Problems?: [EMAIL PROTECTED]
