Wendy Smoak wrote:
On 11/16/06, Adam Hardy
Secondly the comments functionality or the link to the wiki is a pretty
urgent requirement for me, and I think I'm a typical user.
Where are you looking to add comments? Honestly I don't think we're
going to get a 'comment mechanism' on the existing
Wendy Smoak wrote:
I had problems today finding some documentation on the war plugin.
Pretty standard stuff but I couldn't even find the plugins documentation
start page in the left-hand menu, rather I found it on the home page
(where I happened NOT to be to start with) in the text. I think this
Wendy Smoak wrote:
Any thoughts on what a menu link on each plugin site might be called?
For example, I'm planning to link Maven Javadoc Plugin
http://maven.apache.org/plugins/maven-javadoc-plugin
to its wiki page
http://docs.codehaus.org/display/MAVENUSER/Javadoc+Plugin
Just "Wiki" seems i
On 11/16/06, Adam Hardy
<[EMAIL PROTECTED]://mail.google.com/mail/> wrote:
Just wanted to dredge up this old thread concerning documentation to
find out what status it has now after the last conversation.
I think this was already in the works when this thread started, but
the plugins and guide
Just wanted to dredge up this old thread concerning documentation to
find out what status it has now after the last conversation.
I had problems today finding some documentation on the war plugin.
Pretty standard stuff but I couldn't even find the plugins documentation
start page in the left-h
On 10/31/06, Jeff Mutonho <[EMAIL PROTECTED]> wrote:
documents say.That led me to http://maven.apache.org/wagon/ and
clicking on the Getting Started link I ended up at the URL
http://maven.apache.org/wagon/guides/getting-started/index.html , and
almost every link there leads to a :
OK. I like this, too, but there's already the mechanism for doing this in
the form of documentation for the individual components.
Specifically, the "how to use" sections of most of the plugins, which are a
huge portion of the "how to maven" world, are weak. However, since it
requires the knowl
On 11/5/06, David Whitehurst <[EMAIL PROTECTED]> wrote:
I WIKI everything and I wish I had a public WIKI to write in that I felt
comfortable that would stay there for all to see and wouldn't change.
That's not really the nature of wikis... people will come along and
edit what you've written.
David Whitehurst wrote:
Excellent thoughts! I want to adopt maven2 and in-fact we are debating the
issue at work. And the cons are the lack of documentation and the fact
that
ANT is easier to customize. And, that's what we all do, customize
everything to support our needs.
I WIKI everything
t my
>>> > quick investigation there didn't show anything. Check out mysql
>>> though.
>>> > Perhaps
>>> > their documentation publishing framework is OS.
>>> >
>>> > > What would the menu link be called? How should th
ng framework is OS.
>>> >
>>> > > What would the menu link be called? How should the pages on the
>>> wiki
>>> > > be organized?"
>>> >
>>> > I think the whole maven documentation website should be
>>> wiki-commentated
>>> > (is
>>> > that the correct verb here??)
>>> >
>>> > So each plugin remains as it is except the wiki-commentary can be
>>> appended
>>> > to
>>> > the bottom of every page.
>>> >
>>> > I think that any plugin that makes it onto repo.maven.org should get
>>> its
>>> > docs
>>> > site on the website too, at least for the releases.
>>> >
>>> > regards
>>> > Adam
>>> >
>>> > [1] http://dev.mysql.com/doc/refman/5.0/en/linux-rpm.html
>>> >
>>> > -
>>> > To unsubscribe, e-mail: [EMAIL PROTECTED]
>>> > For additional commands, e-mail: [EMAIL PROTECTED]
>>> >
>>> >
>>>
>>>
>>
>>
>
> --
> Gisbert Amm
> Softwareentwickler Infrastruktur
>
> WEB.DE GmbH
> Brauerstraße 48 · D-76135 Karlsruhe
> Tel. +49-721-91374-4224 · Fax +49-721-91374-2740
> [EMAIL PROTECTED] · http://www.web.de/
>
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
>
--
View this message in context:
http://www.nabble.com/Maven-rant-tf2544811s177.html#a7184794
Sent from the Maven - Users mailing list archive at Nabble.com.
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Maven Users List
Onderwerp: Re: Maven rant
Why not use the central repo for documentation aswell?
E.g. in
http://www.ibiblio.org/maven2/plugins/org/apache/maven/plugins/maven-ant-plugin/2.0-alpha-2/
could exist a bundle named user-manual.zip, containing the sources for the
user-manual. There coul
-Oorspronkelijk bericht-
Van: Gisbert Amm [mailto:[EMAIL PROTECTED]
Verzonden: vrijdag 3 november 2006 9:43
Aan: Maven Users List
Onderwerp: Re: Maven rant
Why not use the central repo for documentation aswell?
E.g. in
http://www.ibiblio.org/maven2/plugins/org/apache/maven/plugins/maven-ant-plugin/2.0
Why not use the central repo for documentation aswell?
E.g. in
http://www.ibiblio.org/maven2/plugins/org/apache/maven/plugins/maven-ant-plugin/2.0-alpha-2/
could exist a bundle named user-manual.zip, containing the sources for
the user-manual. There could be a reference-manual.zip, a
develope
Ok, this is think outside the box time... I like Thomas' comments on
centralizing documentation. I really, really like Thomas' comments on
centralizing documentation. However, I think the logistics may be
off. I'm thinking of the documentation problem as similar to the
build problem.
Before t
The problem, as I see it, is that the documentation is fragmented. Unlike
Hibernate and Spring, which provide a single reference manual which is kept
up to date with every release, Maven documentation is spread all over the
place (wiki, generated sites, better builds with Maven, etc.). The probl
Wendy Smoak on 02/11/06 22:34, wrote:
On 11/2/06, Sebastien Brunot <[EMAIL PROTECTED]> wrote:
What I meant by "it" was the comment mechanism.
Right... it doesn't exist yet, we need to design it.
The comment mechanism can be a wiki where the public can only add at the bottom
of the page, an
On 11/2/06, Mykel Alvis <[EMAIL PROTECTED]> wrote:
Like it or not,
people read a lot of wikis, but rarely write to them. They WILL, however,
provide their comments from the peanut gallery on a mailing list.
I'm currently looking at 1212 unread messages in my inbox from this list.
That's from t
On 11/2/06, Sebastien Brunot <[EMAIL PROTECTED]> wrote:
What I meant by "it" was the comment mechanism.
Right... it doesn't exist yet, we need to design it.
Earlier, I asked, "Any ideas on how to present that as an option?
What would the menu link be called? How should the pages on the wiki
My $0.02:
First of all, lets note that I make most of my livelihood working on maven
builds, so this is not (repeat NOT) criticism of the product, developers, or
community at large.
The maven users list (and the associted developers lists and users lists for
all the OTHER
not-necessarily-maven-s
What I meant by "it" was the comment mechanism.
Sebastien
-Original Message-
From: Wendy Smoak [mailto:[EMAIL PROTECTED]
Sent: Thursday, November 02, 2006 3:35 PM
To: Maven Users List
Subject: Re: Maven rant
On 11/2/06, Sebastien Brunot <[EMAIL PROTECTED]> wrote:
>
What I'd like to do for comments is make use of the MAVENUSER wiki
[1]. I'd like to see a link on every plugin site so that users can
share configuration examples or tell us that something is just plain
wrong.
+1 to that
On 11/2/06, Sebastien Brunot <[EMAIL PROTECTED]> wrote:
Good ! When do you think it would be possible to have it online ?
Have what online? We need to decide what "it" is first. :)
What we have available is all of Maven's documentation, (some of which
is generated, some is in APT format,) an
Good ! When do you think it would be possible to have it online ?
Sebastien
-Original Message-
From: Adam Hardy [mailto:[EMAIL PROTECTED]
Sent: Thursday, November 02, 2006 11:44 AM
To: Maven Users List
Subject: Re: Maven rant
Wendy Smoak wrote:
> On 10/31/06, Sebastien Arbog
Wendy Smoak wrote:
On 10/31/06, Sebastien Arbogast <[EMAIL PROTECTED]> wrote:
Think of Hibernate or PHP documentation: one base reference book with
DYNAMIC comments in which people can share their thoughts and
experiences about each feature/chapter, remarks that can be later
integrated when the
PROTECTED]
Sent: Thursday, November 02, 2006 10:31 AM
To: Maven Users List
Subject: Re: Maven rant
But you won't solve the main issue of a wiki system: information replacement.
I still think that a comment system would be more reliable on the long term.
2006/11/2, Sebastien Brunot <[EMAIL P
help to achieve this goal.
Sebastien
-Original Message-
From: Sebastien Arbogast [mailto:[EMAIL PROTECTED]
Sent: Tuesday, October 31, 2006 2:45 PM
To: Maven Users List
Subject: Re: Maven rant
2 thoughts about what you wrote Vincent:
I totally agree on the fact that a few people hav
> -Original Message-
> From: Sebastien Brunot [mailto:[EMAIL PROTECTED]
> Sent: jeudi 2 novembre 2006 10:26
> To: Maven Users List
> Subject: RE: Maven rant
>
> I'm just joining, but what about creating a wiki with the entire free
> maven book content so
be a "no cost"
operation, and having a predefined structure may help to achieve this goal.
Sebastien
-Original Message-
From: Sebastien Arbogast [mailto:[EMAIL PROTECTED]
Sent: Tuesday, October 31, 2006 2:45 PM
To: Maven Users List
Subject: Re: Maven rant
2 thoughts about
"Wayne Fay" <[EMAIL PROTECTED]> writes:
> The "Documentation Check" (DOCCK) plugin was recently created to help
> address this very issue. It will help not only Maven but also its
> plugins and even other projects/plugins using Maven.
>
Hello to all,
And first great thanks to all maven developer
The "Documentation Check" (DOCCK) plugin was recently created to help
address this very issue. It will help not only Maven but also its
plugins and even other projects/plugins using Maven.
Maven Dev has established a baseline for expected documentation and
will now use this plugin to enforce that
On 10/31/06, Sebastien Arbogast <[EMAIL PROTECTED]> wrote:
Think of Hibernate or PHP documentation: one base reference book with
DYNAMIC comments in which people can share their thoughts and
experiences about each feature/chapter, remarks that can be later
integrated when the reference is rewrit
On 10/31/06, Vincent Massol <[EMAIL PROTECTED]> wrote:
BTW
there's already a Maven wiki which is opened to anyone interested. It's been
there for more than a year but I wouldn't call the result comprehensive
documentation.
Thanks
-Vincent
I'm sure there are many people who might want to contri
06 14:18
> To: Maven Users List
> Subject: Re: Maven rant
>
> I totally agree but I think that the problem is very difficult to
> solve, especially with all the incredible amount of undeocumented
> features that Maven has. Moreover, the problem is amplified by the
> fact that Mave
>> > feel that there's need for more participation from plugin authors in
>> > helping mere users like myself and others who get stuck with problems
>> > only the maven gurus can solve...unless of course the plugins are only
>> > to be used by the authors themse
> -Original Message-
> From: Sebastien Arbogast [mailto:[EMAIL PROTECTED]
> Sent: mardi 31 octobre 2006 14:18
> To: Maven Users List
> Subject: Re: Maven rant
>
> I totally agree but I think that the problem is very difficult to
> solve, especially with all
elves.
> Please don't take take this as whining , but rather , as a personal
> view and perhaps constructive criticism.
>
> --
>
>
> Jeff Mutonho
>
> GoogleTalk : ejbengine
> Skype: ejbengine
> Registered Linux user number 366042
>
> -
>
>
> Jeff Mutonho
>
> GoogleTalk : ejbengine
> Skype: ejbengine
> Registered Linux user number 366042
>
> -----
> To unsubscribe, e-m
s whining , but rather , as a personal
> view and perhaps constructive criticism.
>
> --
>
>
> Jeff Mutonho
>
> GoogleTalk : ejbengine
> Skype: ejbengine
> Registered Linux user number 366042
>
> -----
> To unsubscribe, e-m
Is maven in the process of unintentionally killing itself due to poor
support and documentation?I may be wrong but I strongly feel that the
poor support and documentation is hampering adoption of an otherwise
brilliant tool.It always seems like the participation of plugin
developers in answering q
40 matches
Mail list logo