Mailing-List: contact jspwiki-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: jspwiki-dev@incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of Janne.Jalkanen@ecyrd.com
 designates 193.64.5.122 as permitted sender)
Mime-Version: 1.0 (Apple Message framework v753.1)
In-Reply-To: <486806BC.8020208@altheim.com>
References: <78EA94E6-5D27-479C-AAEC-694183831110@ecyrd.com>
 <1214751038.30958.253.camel@netframe>
 <2C9F19AF-C10B-4EB2-9A6E-13BD3869931F@ecyrd.com>
 <4867E6A0.4000809@altheim.com>
 <A20F2232-009C-481F-AAD6-241A6A168B38@ecyrd.com>
 <3C8AE37D-F09B-4482-A4B4-CB38ECAC9E36@ecyrd.com>
 <486806BC.8020208@altheim.com>
Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed
Message-Id: <AAAD9DBD-2DA7-4F70-B70D-BB75A6759DD9@ecyrd.com>
Content-Transfer-Encoding: 7bit
From: Janne Jalkanen <Janne.Jalkanen@ecyrd.com>
Subject: Re: First pass at 3.1 (also: 2.8 alphas, anyone?)
Date: Mon, 30 Jun 2008 09:55:43 +0300
To: jspwiki-dev@incubator.apache.org

> And to be clear, it's not a lack of motivation on my part, it's a
> lack of time.

I completely understand this.  I never expected anything else.

> documentation, or I can't find the documentation. As an example,
> (my fault or not, not the point) I didn't even *know* the
> jspwiki_module.xml file existed when I proposed the idea of a
> plugin administration feature. I hadn't had the chance to locate
> it, and I hadn't seen anything in the documentation about it.

That's fine.  Even if we wrote documentation on all bits (e.g. the  
workflow package is very well documented), you still wouldn't have  
time to read about it all.

Which would land you in exactly the same situation as before.

And this is *NOT* a failure of the project.

(Besides, the feature you mention is documented: http:// 
doc.jspwiki.org/2.4/wiki/DevelopingPlugins).  I would very much like  
to see what would be a better place to put the documentation about  
plugins than the "how to develop plugins" section of our official  
documentation.)

> To reiterate, I'm not trying to be critical here, I'm only trying
> to let you know that some of us are struggling to keep up.

I completely understand.  But your proposed solution of "let's slow  
down" is completely wrong, which is why I am criticizing it so  
harshly.  Making developers feel unhappy about the effort that they  
are putting into the system is bloody destructive.

> Some
> of this might be mitigated by better documentation (or even a map
> of the existing documentation, as it's sometimes hard to find
> things) but I know you're as strapped for time as anyone. But as
> more developers get involved in the project I'm hoping this
> situation will improve, not get worse.

You know, even adding empty templates on doc.jspwiki.org on the  
subjects that *need* updates would be helpful. That way people can  
come in and know what is unclear to other people.  And adding a  
couple of lines to a wiki is not a question of time.

In fact, using the wiki to document these things is very much  
preferred, since email conversations are forgotten in a week.  A JIRA  
issue or a wikipage will be eventually attended to.

/Janne