-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

It uses anakia to transform, but in true Maven spirit it should be able
to be done - with a plugin. ;-) And maybe maven-site is suited to it
just fine (not a maven-site expert for user sites AT ALL - I'm with
Jesse here that so much more 'whiz-bang' is possible with a container.
add a db and the ability to submit plugin information, have it approved
and be live, searchable by name, keyword, etc, and have paged tables for
results would do wonders in my eyes) and all that needs to be done is
"enhance the plugin" and change the site source and sprinkle generously
with css.

My main point was content geared, though. As a user of a project, there
are usually about 4 main links I look for:
  1. Documentation - tell me why it fits or won't fit my needs and how
to get my job done. If you've got layers/levels of documentation, break
it down in there.
  2. Download - Okay. If I hadn't heard by word of mouth, I found out in
the documentation why it's great. Let me get it. Have different
versions? I should be able to find them all on the Download page, right?
  3. Plugins/Extensions - The project is great, but aside from doing
nothing I need to be able to so other stuff. What's out there that I can
use? Consider Plugins/Extensions as cyclic to the main page. Give me
documentation. Give me a way to download it. If you can 'extend' it,
tell me what extensions there are for it. Then give me a way to find help.
  4. Support - "HELP! My boss is standing over my shoulder and this
thing isn't working!!!" (nevermind that I skipped that part of the docs,
where's the support?) Mailing Lists? It's in there. Forum? It's in
there. Wiki? It's in there.

What I see on the Maven site is:
  Features - sounds like boasts, but that's what projects do, right?
Start with #1: "Simple project setup that follows best practices - get a
new project or module started in seconds". Leads me to the "Getting
Started" link which is a mile long. Somewhere in there my reading skills
must have drastically improved to be able to read all that "getting
started" material and still get a project started in seconds.
  A user FAQ that has a lot of "we need more information" answers
  Where is it - Where's Maven? Nope. Short page with links to maven
structures - pretty long pages, too; and mailing list archives?
  Specific Plugin references and a single "Reference" link that takes me
inside 'current' and looks nothing like anything else on the main page.
  About Maven 2.0 - Wait - I'm on the maven site and the first I see on
the main page about a "Maven 2" is half way down the nav on the left -
or up on the top right. But the top right has Maven, Maven 1.x, and
Maven 2.x. Why this hooplah about Maven 2 and users of Maven 1? I'm not
here for either of those - I'm here for Maven. On the bright side,
there's a FAQ under this section that's really a FAQ.
  Powered By - I view this as a selling point to a small extent, but the
resulting page is pretty... lame? [why must there always be at least one
page with "work in progress" on it?]
  FAQ for Other Projects: Huh? Does this sound like the place to find a
FAQ on Drupal? Spring, maybe? Ohhhhh...... nope. Don't get it. Not on
the main page.
  And the dreaded "Project Documentation" section. Nice for developers.
More than a little meaningless to users by and large. And to make
matters worse in this instance, it's project documentation for
maven-site - a Maven plugin! How confusing is that?!?

  These are points I see from a 'user' point of view of the site.
There's a LOT of information on the site - some has to be 'fixed' or
'finished' or 'redone', but there's a lot there. And there needs to be
more - too many things about Maven are "plugin specific" and not
documented for users to understand. But if it's not organized, it'll
still be next to useless for a user to understand.

  Could this be done with Maven itself and a plugin (be it maven-site or
something else)? Well... if Maven can do everything else it does, I
don't see why not. (not as easily as other ways, perhaps... but still
possible)


Tim O'Brien wrote:
>  I read your response, clicked on the Geronimo site, and wanted to believe
> that that was possible with Maven.  But, if you look at
> https://svn.apache.org/repos/asf/geronimo/site/
> 
> It's either Maven 1.x or Ant the directory contains a v3 POM, but it also
> contains an .  The NOTES.txt begins "Download Ant from http://ant.apache.org";.
> 

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (MingW32)

iD8DBQFED9zDaCoPKRow/gARAvBoAJ94VrB1h7xymX+GjcUtOA9wLVFMXACgtOIh
qLaOSU94wFMYKdicCTV7P/c=
=Sk/2
-----END PGP SIGNATURE-----

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

Reply via email to