First problem is I've no idea how to post a patch, and yes I could learn,
but so would everyone else that wants to update the docs and it's just one
more hurdle to get over (plus I'm a lazy git).

As to the HTML ball, I assume you want to do that to deploy help. I just
wonder how many people are referencing local help these days. I for one
always go straight to the web site. It might be worth doing some sort of
survey to see how important it is.

Having said that a method of creating a HTML extract from a wiki would be
nice.

Regards,
Brett.
-----Original Message-----
From: Geir Magnusson Jr [mailto:[EMAIL PROTECTED] 
Sent: Monday, 7 June 2004 9:07 AM
To: Velocity Developers List
Subject: Re: User Documentation


On Jun 6, 2004, at 6:47 PM, Brett Sutton wrote:

> I would like to suggest that while all of this wiki activity is 
> underway
> that we move the user and developer documentation into the wiki as 
> well.
>
> The logic is that if the doco was wikified (is that a word?) then more
> people could contribute to its upkeep, such as fixing errors, adding
> examples and annotations etc.

The problem I have w/ wikification (I have lots of problems, 
actually...) is that you can't take it with you.  IOW, you have to be 
connected.

>
> I've wanted to change the doco on a number of occasions but it just 
> seemed
> too hard to submit a change request. If it was wikified then I would 
> have
> just gone in and modified it.

Why?  Just post the patch to the docs.

>
> That's my opinion anyway.

I know a few people are working on extracting the docs out of wiki into 
an HTML ball that we could include.  That would solve one of the big 
drawbacks of wiki (IMO) if we did the same thing.

geir

>
> Regards,
> S. Brett Sutton.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
-- 
Geir Magnusson Jr                                   203-247-1713(m)
[EMAIL PROTECTED]


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to