You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by "Brian E. Fox" <br...@reply.infinity.nu> on 2007/07/04 01:29:35 UTC
Merging Taxonomy pages
Hi all,
I'm going to work on merging the two existing Taxonomy pages into a
consistent view:
(1) http://docs.codehaus.org/display/MAVEN/Taxonomy
(2) http://docs.codehaus.org/display/MAVEN/Maven+Taxonomy
Any input is welcome, or you can wait until I think I'm done and then
yell at me ;-) I can take either.
Thanks,
Brian
RE: Merging Taxonomy pages
Posted by "Brian E. Fox" <br...@reply.infinity.nu>.
I took another pass through the page and added more sub categories. I
think visually it's good to use the various hx sizes to make it easy to
see the hierarchy, but it requires more scrolling up and down than I
would prefer. I moved it to a 4 column layout to attempt to condense it
more and it's not too bad. If fits ok on my screen, but if too wide, we
could drop back to 3 columns.
Please take a look and send feedback on the categories and/or layout (or
update the page it is a wiki after all....)
Thanks,
--Brian
-----Original Message-----
From: Jason van Zyl [mailto:jason@maven.org]
Sent: Wednesday, July 04, 2007 11:01 AM
To: Maven Developers List
Subject: Re: Merging Taxonomy pages
Cool, thanks I will take a look. The only comment I would make is
that all the categories on the bottom of that page can be merged into
the list of the main body of the page.
We also need to represent sub-categories. For example Pom::Encoding
which was there but seems to be gone. In the proposals pages for
example can use the categories to link together proposals. Like the
work Herve is doing to clean up all the XML encoding.
I'll take another look too, but it's lookings good. The two column
layout looks much better.
On 3 Jul 07, at 6:12 PM 3 Jul 07, Brian E. Fox wrote:
> I merged all the real documents into the first page (1) and then
> deprecated the old one (2) by removing it from home and adding a
> comment/link to (1). I also moved everything into a table format to
> make
> it easier to digest.
>
> I feel like we could break some categories down a little further but
> only a few categories currently have enough documents to make it worth
> while. We seem to have a hodge-podge of docs in here: half complete
> thoughts, references to the maven site, design artifacts from 2.0 and
> 2.1 etc. If this is just supposed to be a full list of all docs, then
> maybe it's ok, but it makes me wonder if keeping the maven site
> urls are
> needed (either we keep them and make a more complete list, or just get
> rid of them all together)
>
> -----Original Message-----
> From: Brian E. Fox [mailto:brianf@reply.infinity.nu]
> Sent: Tuesday, July 03, 2007 7:30 PM
> To: Maven Developers List
> Subject: Merging Taxonomy pages
>
> Hi all,
>
> I'm going to work on merging the two existing Taxonomy pages into a
> consistent view:
>
> (1) http://docs.codehaus.org/display/MAVEN/Taxonomy
>
> (2) http://docs.codehaus.org/display/MAVEN/Maven+Taxonomy
>
>
>
> Any input is welcome, or you can wait until I think I'm done and then
> yell at me ;-) I can take either.
>
>
>
> Thanks,
>
> Brian
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>
Thanks,
Jason
----------------------------------------------------------
Jason van Zyl
Founder and PMC Chair, Apache Maven
jason at sonatype dot com
----------------------------------------------------------
---------------------------------------------------------------------
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: Merging Taxonomy pages
Posted by Hervé BOUTEMY <he...@free.fr>.
Le mercredi 4 juillet 2007, Jason van Zyl a écrit :
> Cool, thanks I will take a look. The only comment I would make is
> that all the categories on the bottom of that page can be merged into
> the list of the main body of the page.
>
> We also need to represent sub-categories. For example Pom::Encoding
> which was there but seems to be gone.
I found it: http://docs.codehaus.org/display/MAVEN/POM+Loading+and+Building
> In the proposals pages for
> example can use the categories to link together proposals. Like the
> work Herve is doing to clean up all the XML encoding.
I added a page to user proposals:
http://docs.codehaus.org/display/MAVENUSER/XML+encoding
Could not link it from "POM Loading and Building", since it is not in user
pages
Hervé
>
> I'll take another look too, but it's lookings good. The two column
> layout looks much better.
>
> On 3 Jul 07, at 6:12 PM 3 Jul 07, Brian E. Fox wrote:
> > I merged all the real documents into the first page (1) and then
> > deprecated the old one (2) by removing it from home and adding a
> > comment/link to (1). I also moved everything into a table format to
> > make
> > it easier to digest.
> >
> > I feel like we could break some categories down a little further but
> > only a few categories currently have enough documents to make it worth
> > while. We seem to have a hodge-podge of docs in here: half complete
> > thoughts, references to the maven site, design artifacts from 2.0 and
> > 2.1 etc. If this is just supposed to be a full list of all docs, then
> > maybe it's ok, but it makes me wonder if keeping the maven site
> > urls are
> > needed (either we keep them and make a more complete list, or just get
> > rid of them all together)
> >
> > -----Original Message-----
> > From: Brian E. Fox [mailto:brianf@reply.infinity.nu]
> > Sent: Tuesday, July 03, 2007 7:30 PM
> > To: Maven Developers List
> > Subject: Merging Taxonomy pages
> >
> > Hi all,
> >
> > I'm going to work on merging the two existing Taxonomy pages into a
> > consistent view:
> >
> > (1) http://docs.codehaus.org/display/MAVEN/Taxonomy
> >
> > (2) http://docs.codehaus.org/display/MAVEN/Maven+Taxonomy
> >
> >
> >
> > Any input is welcome, or you can wait until I think I'm done and then
> > yell at me ;-) I can take either.
> >
> >
> >
> > Thanks,
> >
> > Brian
> >
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
>
> Thanks,
>
> Jason
>
> ----------------------------------------------------------
> Jason van Zyl
> Founder and PMC Chair, Apache Maven
> jason at sonatype dot com
> ----------------------------------------------------------
>
>
>
>
> ---------------------------------------------------------------------
> 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: Merging Taxonomy pages
Posted by Jason van Zyl <ja...@maven.org>.
Cool, thanks I will take a look. The only comment I would make is
that all the categories on the bottom of that page can be merged into
the list of the main body of the page.
We also need to represent sub-categories. For example Pom::Encoding
which was there but seems to be gone. In the proposals pages for
example can use the categories to link together proposals. Like the
work Herve is doing to clean up all the XML encoding.
I'll take another look too, but it's lookings good. The two column
layout looks much better.
On 3 Jul 07, at 6:12 PM 3 Jul 07, Brian E. Fox wrote:
> I merged all the real documents into the first page (1) and then
> deprecated the old one (2) by removing it from home and adding a
> comment/link to (1). I also moved everything into a table format to
> make
> it easier to digest.
>
> I feel like we could break some categories down a little further but
> only a few categories currently have enough documents to make it worth
> while. We seem to have a hodge-podge of docs in here: half complete
> thoughts, references to the maven site, design artifacts from 2.0 and
> 2.1 etc. If this is just supposed to be a full list of all docs, then
> maybe it's ok, but it makes me wonder if keeping the maven site
> urls are
> needed (either we keep them and make a more complete list, or just get
> rid of them all together)
>
> -----Original Message-----
> From: Brian E. Fox [mailto:brianf@reply.infinity.nu]
> Sent: Tuesday, July 03, 2007 7:30 PM
> To: Maven Developers List
> Subject: Merging Taxonomy pages
>
> Hi all,
>
> I'm going to work on merging the two existing Taxonomy pages into a
> consistent view:
>
> (1) http://docs.codehaus.org/display/MAVEN/Taxonomy
>
> (2) http://docs.codehaus.org/display/MAVEN/Maven+Taxonomy
>
>
>
> Any input is welcome, or you can wait until I think I'm done and then
> yell at me ;-) I can take either.
>
>
>
> Thanks,
>
> Brian
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>
Thanks,
Jason
----------------------------------------------------------
Jason van Zyl
Founder and PMC Chair, Apache Maven
jason at sonatype dot com
----------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
RE: Merging Taxonomy pages
Posted by "Brian E. Fox" <br...@reply.infinity.nu>.
I merged all the real documents into the first page (1) and then
deprecated the old one (2) by removing it from home and adding a
comment/link to (1). I also moved everything into a table format to make
it easier to digest.
I feel like we could break some categories down a little further but
only a few categories currently have enough documents to make it worth
while. We seem to have a hodge-podge of docs in here: half complete
thoughts, references to the maven site, design artifacts from 2.0 and
2.1 etc. If this is just supposed to be a full list of all docs, then
maybe it's ok, but it makes me wonder if keeping the maven site urls are
needed (either we keep them and make a more complete list, or just get
rid of them all together)
-----Original Message-----
From: Brian E. Fox [mailto:brianf@reply.infinity.nu]
Sent: Tuesday, July 03, 2007 7:30 PM
To: Maven Developers List
Subject: Merging Taxonomy pages
Hi all,
I'm going to work on merging the two existing Taxonomy pages into a
consistent view:
(1) http://docs.codehaus.org/display/MAVEN/Taxonomy
(2) http://docs.codehaus.org/display/MAVEN/Maven+Taxonomy
Any input is welcome, or you can wait until I think I'm done and then
yell at me ;-) I can take either.
Thanks,
Brian
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org