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: Do you

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

Re: Little documentation issues

2014-12-16 Thread Barrie Treloar
On 17 December 2014 at 12:24, Ron Wheeler rwhee...@artifact-software.com 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

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 baerr...@gmail.com wrote: On 17 December 2014 at 12:24, Ron Wheeler rwhee...@artifact-software.com wrote: One of the wonderful features about Maven is

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 terms

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

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 rwhee...@artifact-software.com wrote: After using maven for

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 back

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

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 *plugin* is