Re: Little documentation issues

2014-12-17 Thread James Green
I've been wondering how to apply "explanations" to things. With ActiveMQ and Camel I just edit the Confluence wiki. If I can issue a GitHub pull request and see the change within a day or two that's fine. On 9 December 2014 at 16:52, Stephen Connolly < stephen.alan.conno...@gmail.com> wrote: > > D

Re: Little documentation issues

2014-12-16 Thread Mirko Friedenhagen
Barrie, if I am not wrong you probably have it right ;-) Regards Mirko -- Sent from my mobile On Dec 17, 2014 3:46 AM, "Barrie Treloar" wrote: > On 17 December 2014 at 12:24, Ron Wheeler > wrote: > > > > One of the wonderful features about Maven is that no matter how long one > > has been usi

Re: Little documentation issues

2014-12-16 Thread Barrie Treloar
On 17 December 2014 at 12:24, Ron Wheeler wrote: > > One of the wonderful features about Maven is that no matter how long one > has been using it or how much one has studied Maven documentation , one > still feels the necessity of ending every assertion about how it works with > "(If I have that r

Re: Little documentation issues

2014-12-16 Thread Ron Wheeler
One of the wonderful features about Maven is that no matter how long one has been using it or how much one has studied Maven documentation , one still feels the necessity of ending every assertion about how it works with "(If I have that right.)" . I am so happy to not be alone! Ron On 10/12

Re: Little documentation issues

2014-12-10 Thread Mark H. Wood
Thinking about the developer's perspective a bit, I came up with some suggestions but no actual language. The developer is a person who wants to build units of software into distributable products, so it's useful to talk briefly about "lifecycle", "phase", "goal", "execution", and "artifact" in te

Re: Little documentation issues

2014-12-09 Thread Curtis Rueden
Hi all, > Can someone suggest a description of "plugin" and "Mojo" that is > written from a developer's point of view but sufficiently close to the > technical reality that it will not cause trouble when someone starts > to read the Plugin Developer's sections. Here's my first cut at it: A *plug

Re: Little documentation issues

2014-12-09 Thread Ron Wheeler
I have made some of the changes in the attached file. There is not much that can be done until the plugin definition is added. This definition will clarify a few things and may make it easier to fix some of the other things. There are sentences like this one: " The second way to add goals to p

Re: Little documentation issues

2014-12-09 Thread Stephen Connolly
H that seems to have failed to sync since scratch that... On 9 December 2014 at 16:52, Stephen Connolly < stephen.alan.conno...@gmail.com> wrote: > Do you want to create some pull requests? > https://github.com/apache/maven-site is the repo... we can take care of > pulling those patches

Re: Little documentation issues

2014-12-09 Thread Stephen Connolly
Do you want to create some pull requests? https://github.com/apache/maven-site is the repo... we can take care of pulling those patches back to SVN, so no need to worry about that part ;-) On 9 December 2014 at 16:42, Ron Wheeler wrote: > After using maven for 7+years, I decided that I finally k

Little documentation issues

2014-12-09 Thread Ron Wheeler
After using maven for 7+years, I decided that I finally knew enough about it to read the docs. I started here - http://maven.apache.org/guides/getting-started/index.html - and this led to other pages. I have found some places where a little cleaning up might help new users. There is one BIG is