You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by Brett Porter <br...@apache.org> on 2004/12/01 13:24:56 UTC

please review: another site drop

I've dropped an update to
http://www.apache.org/~brett/site-2/

Please review the documentation if you have a chance. Everything there 
is ready to go and has been refreshed (there are still empty pages 
though, which are in progress, though feel free to volunteer to do one 
if you can work on it immediately :). In other words, I'll take 
nitpicking, grammar, spelling corrections if you have them.

I am still thinking about how to make the navigation shorter, as I want 
this usable on my 1024x768 laptop. It needs to balance between too much 
information and not enough to get around - so some submenus are probably 
appropriate, but not all of them, and some better titles too. Thoughts?

Thanks,
Brett


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

Re: please review: another site drop

Posted by Brett Porter <br...@apache.org>.
Cool, though I'm reluctant to add it. They have no documentation on the 
web site about it, and I haven't been able to get it to work OOTB.

1) missing dependencies
2) once installed, classpath is not set correctly for tests
3) usage is unintuitive from the CLI, only maven-emma-plugin in the 
reports list does what you expect (except for all the CNFE during testing)

- Brett

Dion Gillard wrote:

>Emma (http://emma.sourceforge.net/) also has a Maven plugin.
>
>
>On Wed, 01 Dec 2004 23:24:56 +1100, Brett Porter <br...@apache.org> wrote:
>  
>
>>I've dropped an update to
>>http://www.apache.org/~brett/site-2/
>>
>>Please review the documentation if you have a chance. Everything there
>>is ready to go and has been refreshed (there are still empty pages
>>though, which are in progress, though feel free to volunteer to do one
>>if you can work on it immediately :). In other words, I'll take
>>nitpicking, grammar, spelling corrections if you have them.
>>
>>I am still thinking about how to make the navigation shorter, as I want
>>this usable on my 1024x768 laptop. It needs to balance between too much
>>information and not enough to get around - so some submenus are probably
>>appropriate, but not all of them, and some better titles too. Thoughts?
>>
>>Thanks,
>>Brett
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
>>For additional commands, e-mail: dev-help@maven.apache.org
>>
>>
>>    
>>
>
>
>  
>



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

Re: please review: another site drop

Posted by Dion Gillard <di...@gmail.com>.
Emma (http://emma.sourceforge.net/) also has a Maven plugin.


On Wed, 01 Dec 2004 23:24:56 +1100, Brett Porter <br...@apache.org> wrote:
> I've dropped an update to
> http://www.apache.org/~brett/site-2/
> 
> Please review the documentation if you have a chance. Everything there
> is ready to go and has been refreshed (there are still empty pages
> though, which are in progress, though feel free to volunteer to do one
> if you can work on it immediately :). In other words, I'll take
> nitpicking, grammar, spelling corrections if you have them.
> 
> I am still thinking about how to make the navigation shorter, as I want
> this usable on my 1024x768 laptop. It needs to balance between too much
> information and not enough to get around - so some submenus are probably
> appropriate, but not all of them, and some better titles too. Thoughts?
> 
> Thanks,
> Brett
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
> 
> 


-- 
http://www.multitask.com.au/people/dion/

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

Re: please review: another site drop

Posted by Brett Porter <br...@apache.org>.
Eric Pugh wrote:

>Looks better, but I agree that the left nav is too long..  It's almost
>overwhelming, I am not sure where to look...
>  
>
I've just dropped another version - let me know if this is more what you 
were thinking.

>So, some suggestions in no specific order:
>1) Getting Maven and Getting Started seem like they should be the same
>thing?  I can't get started with out getting maven, and if I already have
>Maven, I probably don't need the installation instructions.
>  
>
I moved the installation instructions, though I thought it helpful to 
have the "latest stuff" bit at the top.

>2) Using Maven and Reference seem like they could be in the same section,
>and be collapsed submenus?  Or, maybe just move some things:
>  
>
I've fiddled with this too and taken on some suggestions.

>3) I like the Related Projects section, I think it is key.  However, the
>Maven Project heading seems to repeat the site..  Could you remove that and
>relocate Maven-Plugins under something else?  That would save some space.
>  
>
This was because the subprojects weren't shown. I've changed this a bit 
now - but they are more important than the related ones.

>4) Move Maven Developers as a submenu of Project Documentation.  Folks who
>care about project docs will also care about the stuff under Maven
>Developers..
>  
>
That requires fiddling with xdoc, which is out of scope for now. I've 
actually moved the developers stuff to the bottom, but am trying to 
think about how it could be more of a "contributors" section.

>5) Move news and maven-blogs up..  People like to see that stuff when
>evaluating a new project.
>  
>
Yeah, I'm thinking you might be right, though the roadmap probably only 
makes sense to people already familiar. However, the backwards compat 
and release notes in the first menu are likewise.

- Brett


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

RE: please review: another site drop

Posted by Eric Pugh <ep...@upstate.com>.
Looks better, but I agree that the left nav is too long..  It's almost
overwhelming, I am not sure where to look...

So, some suggestions in no specific order:
1) Getting Maven and Getting Started seem like they should be the same
thing?  I can't get started with out getting maven, and if I already have
Maven, I probably don't need the installation instructions.
2) Using Maven and Reference seem like they could be in the same section,
and be collapsed submenus?  Or, maybe just move some things:
	- Sharing Plugins doesn't seem like a reference thing, but more of a Using
Maven thing
	- Uploading to Ibiblio seems like part of "Working with Repositories"..
	- Alternatively, what if a different breakdown:
	Instructions
		Plugins
		Projects
		Repositories
		Command Line
	and then put each section under there.  Then, expose in the top level the
Plugins/Projects/Repositories/Command Line, but make them each a collapsed
menu that opens..   More of a "topic" oriented organization.

3) I like the Related Projects section, I think it is key.  However, the
Maven Project heading seems to repeat the site..  Could you remove that and
relocate Maven-Plugins under something else?  That would save some space.
4) Move Maven Developers as a submenu of Project Documentation.  Folks who
care about project docs will also care about the stuff under Maven
Developers..
5) Move news and maven-blogs up..  People like to see that stuff when
evaluating a new project.
Just a couple suggestions, the docs are looking better!

Eric




> -----Original Message-----
> From: Brett Porter [mailto:brett@apache.org]
> Sent: Wednesday, December 01, 2004 1:25 PM
> To: Maven Developers List
> Subject: please review: another site drop
>
>
> I've dropped an update to
> http://www.apache.org/~brett/site-2/
>
> Please review the documentation if you have a chance. Everything there
> is ready to go and has been refreshed (there are still empty pages
> though, which are in progress, though feel free to volunteer to do one
> if you can work on it immediately :). In other words, I'll take
> nitpicking, grammar, spelling corrections if you have them.
>
> I am still thinking about how to make the navigation shorter, as I want
> this usable on my 1024x768 laptop. It needs to balance between too much
> information and not enough to get around - so some submenus are probably
> appropriate, but not all of them, and some better titles too. Thoughts?
>
> Thanks,
> Brett
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org