You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@harmony.apache.org by "Morozova, Nadezhda" <na...@intel.com> on 2007/06/26 22:19:15 UTC

[site][doc] improving sitemap

Hi everyone,

I've come up with an idea of improving our site map [1], which is
essentially a good idea to have. it seems the current version is
longish. I've have had a sitemap that is really a map with many
structured links all fitting into one page - and not a long listing of
all pages that we have. The *map* word has the idea of a more compact
design.

With this in mind, I've thought of creating a shorter sitemap [2]. I
still haven't managed to remove all comments to pages, but the new
design has much less text and organizes links in two columns.
I'm looking forward to ideas and feedback. My attempt has been very
straight-forward, and your fresh eye could help us improve the
navigation a lot.
.. or you could just say that we have a perfect sitemap, and we don't
need to change anything;) 


[1]http://harmony.apache.org/sitemap.html
[2]http://people.apache.org/~nadinem/sitemap_alt.html

Thanks,
Nadya Morozova

Re: [site][doc] improving sitemap

Posted by Egor Pasko <eg...@gmail.com>.
On the 0x302 day of Apache Harmony Nadezhda Morozova wrote:
> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >descriptions become shorter or you killed a couple of unpopoular links
> >too?
> Oh :) I only mean organizing links to take less space and making
> descriptions shorter, not erasing links. If the sitemap is not a
> complete list of all pages, what's the point? 
> A couple of links are also inside a paragraph, not on their own (for
> example, the Getting Started with Eclipse link has a link to the eclipse
> movie in its description); but that's not common practice.

OK, great

> >> I like an idea to remove a control bar from the map to make a layout
> >compact.
> Actually, removing the control bar was only because I placed only one
> page, not the whole site on the share. I'm not planning to remove the
> left navigation bar - it is always a part of site except when you print
> a page. I don't think it's a big issue. And again, when all pages of a
> website have the same layout except one given page, this attracts
> unneeded attention.
> 
> Cheers, 
> Nadya
>  
> >-----Original Message-----
> >From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
> >Sent: Wednesday, June 27, 2007 11:39 AM
> >To: dev@harmony.apache.org
> >Subject: Re: [site][doc] improving sitemap
> >
> >On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
> >> Nadya,
> >> I like an idea to remove a control bar from the map to make a layout
> >compact.
> >
> >+1, and 2 columns looks really really great
> >
> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >descriptions become shorter or you killed a couple of unpopoular links
> >too?
> >
> >>
> >> On 6/27/07, Morozova, Nadezhda <na...@intel.com> wrote:
> >> > Hi everyone,
> >> >
> >> > I've come up with an idea of improving our site map [1], which is
> >> > essentially a good idea to have. it seems the current version is
> >> > longish. I've have had a sitemap that is really a map with many
> >> > structured links all fitting into one page - and not a long listing
> of
> >> > all pages that we have. The *map* word has the idea of a more
> compact
> >> > design.
> >> >
> >> > With this in mind, I've thought of creating a shorter sitemap [2].
> I
> >> > still haven't managed to remove all comments to pages, but the new
> >> > design has much less text and organizes links in two columns.
> >> > I'm looking forward to ideas and feedback. My attempt has been very
> >> > straight-forward, and your fresh eye could help us improve the
> >> > navigation a lot.
> >> > .. or you could just say that we have a perfect sitemap, and we
> don't
> >> > need to change anything;)
> >> >
> >> >
> >> > [1]http://harmony.apache.org/sitemap.html
> >> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> >> >
> >> > Thanks,
> >> > Nadya Morozova
> >> >
> >>
> >>
> >> --
> >> With best regards,
> >> Alexei,
> >> ESSD, Intel
> >>
> >
> >--
> >Egor Pasko
> 

-- 
Egor Pasko


Re: Re: [site][doc] improving sitemap

Posted by Alexey Ivanov <al...@gmail.com>.
Mikhail,

I guess developers_guide.html layout is not as good as for site map.
In developers_guide.html it's just a table of contents.

For site map I think we should try to present information as compact
as we can so that users (and we ourselves) shouldn't need to scroll
the page, i.e. all the info at first glance. Having this in mind,
Nadya's two-column layout is perfect.


Regards,
Alexey.

2007/7/2, Mikhail Fursov <mi...@gmail.com>:
> Nadya,
> IMO both pages have too much info to read from the first glance.
> Another page layout could be:
> 1) list of topics like:
> http://harmony.apache.org/subcomponents/drlvm/developers_guide.html on the
> top
> 2) and description for each topic below the list with links to appropriate
> pages.
> in this case we can use single column page for descriptions and keep
> sidebar.
>
>
>
> On 6/28/07, Morozova, Nadezhda <na...@intel.com> wrote:
> >
> > Alexey,
> > I've uploaded a new two-column sitemap to the website. Feedback and
> > changes are welcome.
> > I'm not sure how to implement your no-navigation pane solution, so your
> > help is needed.
> >
> > There's also a lot of whitespace between sections, I guess due to H2
> > headings used in column headers. Do you think we should reduce that but
> > applying a different style?
> >
> > Cheers,
> > Nadya
> >
> >
> > >-----Original Message-----
> > >From: Alexey Ivanov [mailto:alxey.ivanov@gmail.com]
> > >Sent: Thursday, June 28, 2007 3:26 PM
> > >To: dev@harmony.apache.org
> > >Subject: Re: Re: [site][doc] improving sitemap
> > >
> > >Actually with the new layout of the site which is completely based on
> > >CSS, you can easily hide the left navigation bar and, if you like, the
> > >logo at the top of the page.
> > >And I think hiding the left navigation is a good idea for a site map
> > >because:
> > >  1. it frees up some horizontal space for the map itself,
> > >  2. it quite useless here since all links are present here anyway.
> > >
> > >On the other hand without left navigation the page will look different
> > >from other pages, as Nadya notes. However, I think a slightly
> > >different look is acceptable for a map page.
> > >
> > >Regards,
> > >Alexey.
> > >
> > >2007/6/27, Morozova, Nadezhda <na...@intel.com>:
> > >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> > >> >descriptions become shorter or you killed a couple of unpopoular
> > links
> > >> >too?
> > >> Oh :) I only mean organizing links to take less space and making
> > >> descriptions shorter, not erasing links. If the sitemap is not a
> > >> complete list of all pages, what's the point?
> > >> A couple of links are also inside a paragraph, not on their own (for
> > >> example, the Getting Started with Eclipse link has a link to the
> > eclipse
> > >> movie in its description); but that's not common practice.
> > >>
> > >> >> I like an idea to remove a control bar from the map to make a
> > layout
> > >> >compact.
> > >> Actually, removing the control bar was only because I placed only one
> > >> page, not the whole site on the share. I'm not planning to remove the
> > >> left navigation bar - it is always a part of site except when you
> > print
> > >> a page. I don't think it's a big issue. And again, when all pages of
> > a
> > >> website have the same layout except one given page, this attracts
> > >> unneeded attention.
> > >>
> > >> Cheers,
> > >> Nadya
> > >>
> > >> >-----Original Message-----
> > >> >From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
> > >> >Sent: Wednesday, June 27, 2007 11:39 AM
> > >> >To: dev@harmony.apache.org
> > >> >Subject: Re: [site][doc] improving sitemap
> > >> >
> > >> >On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
> > >> >> Nadya,
> > >> >> I like an idea to remove a control bar from the map to make a
> > layout
> > >> >compact.
> > >> >
> > >> >+1, and 2 columns looks really really great
> > >> >
> > >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> > >> >descriptions become shorter or you killed a couple of unpopoular
> > links
> > >> >too?
> > >> >
> > >> >>
> > >> >> On 6/27/07, Morozova, Nadezhda <na...@intel.com>
> > wrote:
> > >> >> > Hi everyone,
> > >> >> >
> > >> >> > I've come up with an idea of improving our site map [1], which
> > is
> > >> >> > essentially a good idea to have. it seems the current version is
> > >> >> > longish. I've have had a sitemap that is really a map with many
> > >> >> > structured links all fitting into one page - and not a long
> > listing
> > >> of
> > >> >> > all pages that we have. The *map* word has the idea of a more
> > >> compact
> > >> >> > design.
> > >> >> >
> > >> >> > With this in mind, I've thought of creating a shorter sitemap
> > [2].
> > >> I
> > >> >> > still haven't managed to remove all comments to pages, but the
> > new
> > >> >> > design has much less text and organizes links in two columns.
> > >> >> > I'm looking forward to ideas and feedback. My attempt has been
> > very
> > >> >> > straight-forward, and your fresh eye could help us improve the
> > >> >> > navigation a lot.
> > >> >> > .. or you could just say that we have a perfect sitemap, and we
> > >> don't
> > >> >> > need to change anything;)
> > >> >> >
> > >> >> >
> > >> >> > [1]http://harmony.apache.org/sitemap.html
> > >> >> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> > >> >> >
> > >> >> > Thanks,
> > >> >> > Nadya Morozova
> > >> >> >
> > >> >>
> > >> >>
> > >> >> --
> > >> >> With best regards,
> > >> >> Alexei,
> > >> >> ESSD, Intel
> > >> >>
> > >> >
> > >> >--
> > >> >Egor Pasko
> > >>
> >
>
>
>
> --
> Mikhail Fursov
>

RE: Re: [site][doc] improving sitemap

Posted by "Morozova, Nadezhda" <na...@intel.com>.
HI Mikhail,
Sorry for a longish reply. I guess your idea of making the page more
compact is great; in fact, I also thought of removing descriptions and
only having links grouped into sections for structure. 
However, our pages are diverse and dedicated to varied areas of
expertise, so we cannot hope to give the reader understanding of all
page titles with no description at all. 
As I see it, the aim of a sitemap is to index all pages of a site and
show them in a structured way. For frequently accessed pages, we have
the side bar, so the sitemap can be an inventory list. Perhaps, we could
come to a completely different approach for sitemap one day, but I don't
see any radical alternative now. 

Surely, there is room for improvement and change - like, making the
links on the sitemap more prominent, changing descriptions of pages,
re-arranging things. You are also welcome to contribute to these or any
other enhancements, as usual ;)  

Cheers, 
Nadya
 
>-----Original Message-----
>From: Mikhail Fursov [mailto:mike.fursov@gmail.com]
>Sent: Monday, July 02, 2007 4:57 PM
>To: dev@harmony.apache.org
>Subject: Re: Re: [site][doc] improving sitemap
>
>Nadya,
>IMO both pages have too much info to read from the first glance.
>Another page layout could be:
>1) list of topics like:
>http://harmony.apache.org/subcomponents/drlvm/developers_guide.html on
the
>top
>2) and description for each topic below the list with links to
appropriate
>pages.
>in this case we can use single column page for descriptions and keep
>sidebar.
>
>
>
>On 6/28/07, Morozova, Nadezhda <na...@intel.com> wrote:
>>
>> Alexey,
>> I've uploaded a new two-column sitemap to the website. Feedback and
>> changes are welcome.
>> I'm not sure how to implement your no-navigation pane solution, so
your
>> help is needed.
>>
>> There's also a lot of whitespace between sections, I guess due to H2
>> headings used in column headers. Do you think we should reduce that
but
>> applying a different style?
>>
>> Cheers,
>> Nadya
>>
>>
>> >-----Original Message-----
>> >From: Alexey Ivanov [mailto:alxey.ivanov@gmail.com]
>> >Sent: Thursday, June 28, 2007 3:26 PM
>> >To: dev@harmony.apache.org
>> >Subject: Re: Re: [site][doc] improving sitemap
>> >
>> >Actually with the new layout of the site which is completely based
on
>> >CSS, you can easily hide the left navigation bar and, if you like,
the
>> >logo at the top of the page.
>> >And I think hiding the left navigation is a good idea for a site map
>> >because:
>> >  1. it frees up some horizontal space for the map itself,
>> >  2. it quite useless here since all links are present here anyway.
>> >
>> >On the other hand without left navigation the page will look
different
>> >from other pages, as Nadya notes. However, I think a slightly
>> >different look is acceptable for a map page.
>> >
>> >Regards,
>> >Alexey.
>> >
>> >2007/6/27, Morozova, Nadezhda <na...@intel.com>:
>> >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
>> >> >descriptions become shorter or you killed a couple of unpopoular
>> links
>> >> >too?
>> >> Oh :) I only mean organizing links to take less space and making
>> >> descriptions shorter, not erasing links. If the sitemap is not a
>> >> complete list of all pages, what's the point?
>> >> A couple of links are also inside a paragraph, not on their own
(for
>> >> example, the Getting Started with Eclipse link has a link to the
>> eclipse
>> >> movie in its description); but that's not common practice.
>> >>
>> >> >> I like an idea to remove a control bar from the map to make a
>> layout
>> >> >compact.
>> >> Actually, removing the control bar was only because I placed only
one
>> >> page, not the whole site on the share. I'm not planning to remove
the
>> >> left navigation bar - it is always a part of site except when you
>> print
>> >> a page. I don't think it's a big issue. And again, when all pages
of
>> a
>> >> website have the same layout except one given page, this attracts
>> >> unneeded attention.
>> >>
>> >> Cheers,
>> >> Nadya
>> >>
>> >> >-----Original Message-----
>> >> >From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
>> >> >Sent: Wednesday, June 27, 2007 11:39 AM
>> >> >To: dev@harmony.apache.org
>> >> >Subject: Re: [site][doc] improving sitemap
>> >> >
>> >> >On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
>> >> >> Nadya,
>> >> >> I like an idea to remove a control bar from the map to make a
>> layout
>> >> >compact.
>> >> >
>> >> >+1, and 2 columns looks really really great
>> >> >
>> >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
>> >> >descriptions become shorter or you killed a couple of unpopoular
>> links
>> >> >too?
>> >> >
>> >> >>
>> >> >> On 6/27/07, Morozova, Nadezhda <na...@intel.com>
>> wrote:
>> >> >> > Hi everyone,
>> >> >> >
>> >> >> > I've come up with an idea of improving our site map [1],
which
>> is
>> >> >> > essentially a good idea to have. it seems the current version
is
>> >> >> > longish. I've have had a sitemap that is really a map with
many
>> >> >> > structured links all fitting into one page - and not a long
>> listing
>> >> of
>> >> >> > all pages that we have. The *map* word has the idea of a more
>> >> compact
>> >> >> > design.
>> >> >> >
>> >> >> > With this in mind, I've thought of creating a shorter sitemap
>> [2].
>> >> I
>> >> >> > still haven't managed to remove all comments to pages, but
the
>> new
>> >> >> > design has much less text and organizes links in two columns.
>> >> >> > I'm looking forward to ideas and feedback. My attempt has
been
>> very
>> >> >> > straight-forward, and your fresh eye could help us improve
the
>> >> >> > navigation a lot.
>> >> >> > .. or you could just say that we have a perfect sitemap, and
we
>> >> don't
>> >> >> > need to change anything;)
>> >> >> >
>> >> >> >
>> >> >> > [1]http://harmony.apache.org/sitemap.html
>> >> >> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
>> >> >> >
>> >> >> > Thanks,
>> >> >> > Nadya Morozova
>> >> >> >
>> >> >>
>> >> >>
>> >> >> --
>> >> >> With best regards,
>> >> >> Alexei,
>> >> >> ESSD, Intel
>> >> >>
>> >> >
>> >> >--
>> >> >Egor Pasko
>> >>
>>
>
>
>
>--
>Mikhail Fursov

Re: Re: [site][doc] improving sitemap

Posted by Mikhail Fursov <mi...@gmail.com>.
Nadya,
IMO both pages have too much info to read from the first glance.
Another page layout could be:
1) list of topics like:
http://harmony.apache.org/subcomponents/drlvm/developers_guide.html on the
top
2) and description for each topic below the list with links to appropriate
pages.
in this case we can use single column page for descriptions and keep
sidebar.



On 6/28/07, Morozova, Nadezhda <na...@intel.com> wrote:
>
> Alexey,
> I've uploaded a new two-column sitemap to the website. Feedback and
> changes are welcome.
> I'm not sure how to implement your no-navigation pane solution, so your
> help is needed.
>
> There's also a lot of whitespace between sections, I guess due to H2
> headings used in column headers. Do you think we should reduce that but
> applying a different style?
>
> Cheers,
> Nadya
>
>
> >-----Original Message-----
> >From: Alexey Ivanov [mailto:alxey.ivanov@gmail.com]
> >Sent: Thursday, June 28, 2007 3:26 PM
> >To: dev@harmony.apache.org
> >Subject: Re: Re: [site][doc] improving sitemap
> >
> >Actually with the new layout of the site which is completely based on
> >CSS, you can easily hide the left navigation bar and, if you like, the
> >logo at the top of the page.
> >And I think hiding the left navigation is a good idea for a site map
> >because:
> >  1. it frees up some horizontal space for the map itself,
> >  2. it quite useless here since all links are present here anyway.
> >
> >On the other hand without left navigation the page will look different
> >from other pages, as Nadya notes. However, I think a slightly
> >different look is acceptable for a map page.
> >
> >Regards,
> >Alexey.
> >
> >2007/6/27, Morozova, Nadezhda <na...@intel.com>:
> >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >> >descriptions become shorter or you killed a couple of unpopoular
> links
> >> >too?
> >> Oh :) I only mean organizing links to take less space and making
> >> descriptions shorter, not erasing links. If the sitemap is not a
> >> complete list of all pages, what's the point?
> >> A couple of links are also inside a paragraph, not on their own (for
> >> example, the Getting Started with Eclipse link has a link to the
> eclipse
> >> movie in its description); but that's not common practice.
> >>
> >> >> I like an idea to remove a control bar from the map to make a
> layout
> >> >compact.
> >> Actually, removing the control bar was only because I placed only one
> >> page, not the whole site on the share. I'm not planning to remove the
> >> left navigation bar - it is always a part of site except when you
> print
> >> a page. I don't think it's a big issue. And again, when all pages of
> a
> >> website have the same layout except one given page, this attracts
> >> unneeded attention.
> >>
> >> Cheers,
> >> Nadya
> >>
> >> >-----Original Message-----
> >> >From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
> >> >Sent: Wednesday, June 27, 2007 11:39 AM
> >> >To: dev@harmony.apache.org
> >> >Subject: Re: [site][doc] improving sitemap
> >> >
> >> >On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
> >> >> Nadya,
> >> >> I like an idea to remove a control bar from the map to make a
> layout
> >> >compact.
> >> >
> >> >+1, and 2 columns looks really really great
> >> >
> >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >> >descriptions become shorter or you killed a couple of unpopoular
> links
> >> >too?
> >> >
> >> >>
> >> >> On 6/27/07, Morozova, Nadezhda <na...@intel.com>
> wrote:
> >> >> > Hi everyone,
> >> >> >
> >> >> > I've come up with an idea of improving our site map [1], which
> is
> >> >> > essentially a good idea to have. it seems the current version is
> >> >> > longish. I've have had a sitemap that is really a map with many
> >> >> > structured links all fitting into one page - and not a long
> listing
> >> of
> >> >> > all pages that we have. The *map* word has the idea of a more
> >> compact
> >> >> > design.
> >> >> >
> >> >> > With this in mind, I've thought of creating a shorter sitemap
> [2].
> >> I
> >> >> > still haven't managed to remove all comments to pages, but the
> new
> >> >> > design has much less text and organizes links in two columns.
> >> >> > I'm looking forward to ideas and feedback. My attempt has been
> very
> >> >> > straight-forward, and your fresh eye could help us improve the
> >> >> > navigation a lot.
> >> >> > .. or you could just say that we have a perfect sitemap, and we
> >> don't
> >> >> > need to change anything;)
> >> >> >
> >> >> >
> >> >> > [1]http://harmony.apache.org/sitemap.html
> >> >> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> >> >> >
> >> >> > Thanks,
> >> >> > Nadya Morozova
> >> >> >
> >> >>
> >> >>
> >> >> --
> >> >> With best regards,
> >> >> Alexei,
> >> >> ESSD, Intel
> >> >>
> >> >
> >> >--
> >> >Egor Pasko
> >>
>



-- 
Mikhail Fursov

Re: Re: [site][doc] improving sitemap

Posted by Alexey Ivanov <al...@gmail.com>.
Nadya,

I've created a JIRA and attached a patch there which fixes some of
those issues: http://issues.apache.org/jira/browse/HARMONY-4348

Another point to improve is the location of 'Class Library Component
Status' which is not very successful at this time. I think the page
will look better if <h3> headings "Developing and Building the Code"
and "Project Conventions" are aligned. This can be achieved by moving
"Class Library Component Status" into the previous table cell. But
this allocates unused space in the left column. Additionally I think
this link should be visually separated from "Start here for
JCL-specific docs" link.

At the moment "Start here..." links don't look like a starting point
for a section, and we need to make them stand out from other links, I
think.


What do you think?


Regards,
Alexey.

2007/6/28, Morozova, Nadezhda <na...@intel.com>:
> Alexey,
> I've uploaded a new two-column sitemap to the website. Feedback and
> changes are welcome.
> I'm not sure how to implement your no-navigation pane solution, so your
> help is needed.
>
> There's also a lot of whitespace between sections, I guess due to H2
> headings used in column headers. Do you think we should reduce that but
> applying a different style?
>
> Cheers,
> Nadya
>
>
> >-----Original Message-----
> >From: Alexey Ivanov [mailto:alxey.ivanov@gmail.com]
> >Sent: Thursday, June 28, 2007 3:26 PM
> >To: dev@harmony.apache.org
> >Subject: Re: Re: [site][doc] improving sitemap
> >
> >Actually with the new layout of the site which is completely based on
> >CSS, you can easily hide the left navigation bar and, if you like, the
> >logo at the top of the page.
> >And I think hiding the left navigation is a good idea for a site map
> >because:
> >  1. it frees up some horizontal space for the map itself,
> >  2. it quite useless here since all links are present here anyway.
> >
> >On the other hand without left navigation the page will look different
> >from other pages, as Nadya notes. However, I think a slightly
> >different look is acceptable for a map page.
> >
> >Regards,
> >Alexey.
> >
> >2007/6/27, Morozova, Nadezhda <na...@intel.com>:
> >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >> >descriptions become shorter or you killed a couple of unpopoular
> links
> >> >too?
> >> Oh :) I only mean organizing links to take less space and making
> >> descriptions shorter, not erasing links. If the sitemap is not a
> >> complete list of all pages, what's the point?
> >> A couple of links are also inside a paragraph, not on their own (for
> >> example, the Getting Started with Eclipse link has a link to the
> eclipse
> >> movie in its description); but that's not common practice.
> >>
> >> >> I like an idea to remove a control bar from the map to make a
> layout
> >> >compact.
> >> Actually, removing the control bar was only because I placed only one
> >> page, not the whole site on the share. I'm not planning to remove the
> >> left navigation bar - it is always a part of site except when you
> print
> >> a page. I don't think it's a big issue. And again, when all pages of
> a
> >> website have the same layout except one given page, this attracts
> >> unneeded attention.
> >>
> >> Cheers,
> >> Nadya
> >>
> >> >-----Original Message-----
> >> >From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
> >> >Sent: Wednesday, June 27, 2007 11:39 AM
> >> >To: dev@harmony.apache.org
> >> >Subject: Re: [site][doc] improving sitemap
> >> >
> >> >On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
> >> >> Nadya,
> >> >> I like an idea to remove a control bar from the map to make a
> layout
> >> >compact.
> >> >
> >> >+1, and 2 columns looks really really great
> >> >
> >> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >> >descriptions become shorter or you killed a couple of unpopoular
> links
> >> >too?
> >> >
> >> >>
> >> >> On 6/27/07, Morozova, Nadezhda <na...@intel.com>
> wrote:
> >> >> > Hi everyone,
> >> >> >
> >> >> > I've come up with an idea of improving our site map [1], which
> is
> >> >> > essentially a good idea to have. it seems the current version is
> >> >> > longish. I've have had a sitemap that is really a map with many
> >> >> > structured links all fitting into one page - and not a long
> listing
> >> of
> >> >> > all pages that we have. The *map* word has the idea of a more
> >> compact
> >> >> > design.
> >> >> >
> >> >> > With this in mind, I've thought of creating a shorter sitemap
> [2].
> >> I
> >> >> > still haven't managed to remove all comments to pages, but the
> new
> >> >> > design has much less text and organizes links in two columns.
> >> >> > I'm looking forward to ideas and feedback. My attempt has been
> very
> >> >> > straight-forward, and your fresh eye could help us improve the
> >> >> > navigation a lot.
> >> >> > .. or you could just say that we have a perfect sitemap, and we
> >> don't
> >> >> > need to change anything;)
> >> >> >
> >> >> >
> >> >> > [1]http://harmony.apache.org/sitemap.html
> >> >> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> >> >> >
> >> >> > Thanks,
> >> >> > Nadya Morozova
> >> >> >
> >> >>
> >> >>
> >> >> --
> >> >> With best regards,
> >> >> Alexei,
> >> >> ESSD, Intel
> >> >>
> >> >
> >> >--
> >> >Egor Pasko
> >>
>

RE: Re: [site][doc] improving sitemap

Posted by "Morozova, Nadezhda" <na...@intel.com>.
Alexey,
I've uploaded a new two-column sitemap to the website. Feedback and
changes are welcome. 
I'm not sure how to implement your no-navigation pane solution, so your
help is needed. 

There's also a lot of whitespace between sections, I guess due to H2
headings used in column headers. Do you think we should reduce that but
applying a different style?

Cheers, 
Nadya
 

>-----Original Message-----
>From: Alexey Ivanov [mailto:alxey.ivanov@gmail.com]
>Sent: Thursday, June 28, 2007 3:26 PM
>To: dev@harmony.apache.org
>Subject: Re: Re: [site][doc] improving sitemap
>
>Actually with the new layout of the site which is completely based on
>CSS, you can easily hide the left navigation bar and, if you like, the
>logo at the top of the page.
>And I think hiding the left navigation is a good idea for a site map
>because:
>  1. it frees up some horizontal space for the map itself,
>  2. it quite useless here since all links are present here anyway.
>
>On the other hand without left navigation the page will look different
>from other pages, as Nadya notes. However, I think a slightly
>different look is acceptable for a map page.
>
>Regards,
>Alexey.
>
>2007/6/27, Morozova, Nadezhda <na...@intel.com>:
>> >Nadya, what do you mean by "shorter sitemap"? Is it that only
>> >descriptions become shorter or you killed a couple of unpopoular
links
>> >too?
>> Oh :) I only mean organizing links to take less space and making
>> descriptions shorter, not erasing links. If the sitemap is not a
>> complete list of all pages, what's the point?
>> A couple of links are also inside a paragraph, not on their own (for
>> example, the Getting Started with Eclipse link has a link to the
eclipse
>> movie in its description); but that's not common practice.
>>
>> >> I like an idea to remove a control bar from the map to make a
layout
>> >compact.
>> Actually, removing the control bar was only because I placed only one
>> page, not the whole site on the share. I'm not planning to remove the
>> left navigation bar - it is always a part of site except when you
print
>> a page. I don't think it's a big issue. And again, when all pages of
a
>> website have the same layout except one given page, this attracts
>> unneeded attention.
>>
>> Cheers,
>> Nadya
>>
>> >-----Original Message-----
>> >From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
>> >Sent: Wednesday, June 27, 2007 11:39 AM
>> >To: dev@harmony.apache.org
>> >Subject: Re: [site][doc] improving sitemap
>> >
>> >On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
>> >> Nadya,
>> >> I like an idea to remove a control bar from the map to make a
layout
>> >compact.
>> >
>> >+1, and 2 columns looks really really great
>> >
>> >Nadya, what do you mean by "shorter sitemap"? Is it that only
>> >descriptions become shorter or you killed a couple of unpopoular
links
>> >too?
>> >
>> >>
>> >> On 6/27/07, Morozova, Nadezhda <na...@intel.com>
wrote:
>> >> > Hi everyone,
>> >> >
>> >> > I've come up with an idea of improving our site map [1], which
is
>> >> > essentially a good idea to have. it seems the current version is
>> >> > longish. I've have had a sitemap that is really a map with many
>> >> > structured links all fitting into one page - and not a long
listing
>> of
>> >> > all pages that we have. The *map* word has the idea of a more
>> compact
>> >> > design.
>> >> >
>> >> > With this in mind, I've thought of creating a shorter sitemap
[2].
>> I
>> >> > still haven't managed to remove all comments to pages, but the
new
>> >> > design has much less text and organizes links in two columns.
>> >> > I'm looking forward to ideas and feedback. My attempt has been
very
>> >> > straight-forward, and your fresh eye could help us improve the
>> >> > navigation a lot.
>> >> > .. or you could just say that we have a perfect sitemap, and we
>> don't
>> >> > need to change anything;)
>> >> >
>> >> >
>> >> > [1]http://harmony.apache.org/sitemap.html
>> >> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
>> >> >
>> >> > Thanks,
>> >> > Nadya Morozova
>> >> >
>> >>
>> >>
>> >> --
>> >> With best regards,
>> >> Alexei,
>> >> ESSD, Intel
>> >>
>> >
>> >--
>> >Egor Pasko
>>

Re: Re: [site][doc] improving sitemap

Posted by Alexey Ivanov <al...@gmail.com>.
Actually with the new layout of the site which is completely based on
CSS, you can easily hide the left navigation bar and, if you like, the
logo at the top of the page.
And I think hiding the left navigation is a good idea for a site map because:
  1. it frees up some horizontal space for the map itself,
  2. it quite useless here since all links are present here anyway.

On the other hand without left navigation the page will look different
from other pages, as Nadya notes. However, I think a slightly
different look is acceptable for a map page.

Regards,
Alexey.

2007/6/27, Morozova, Nadezhda <na...@intel.com>:
> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >descriptions become shorter or you killed a couple of unpopoular links
> >too?
> Oh :) I only mean organizing links to take less space and making
> descriptions shorter, not erasing links. If the sitemap is not a
> complete list of all pages, what's the point?
> A couple of links are also inside a paragraph, not on their own (for
> example, the Getting Started with Eclipse link has a link to the eclipse
> movie in its description); but that's not common practice.
>
> >> I like an idea to remove a control bar from the map to make a layout
> >compact.
> Actually, removing the control bar was only because I placed only one
> page, not the whole site on the share. I'm not planning to remove the
> left navigation bar - it is always a part of site except when you print
> a page. I don't think it's a big issue. And again, when all pages of a
> website have the same layout except one given page, this attracts
> unneeded attention.
>
> Cheers,
> Nadya
>
> >-----Original Message-----
> >From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
> >Sent: Wednesday, June 27, 2007 11:39 AM
> >To: dev@harmony.apache.org
> >Subject: Re: [site][doc] improving sitemap
> >
> >On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
> >> Nadya,
> >> I like an idea to remove a control bar from the map to make a layout
> >compact.
> >
> >+1, and 2 columns looks really really great
> >
> >Nadya, what do you mean by "shorter sitemap"? Is it that only
> >descriptions become shorter or you killed a couple of unpopoular links
> >too?
> >
> >>
> >> On 6/27/07, Morozova, Nadezhda <na...@intel.com> wrote:
> >> > Hi everyone,
> >> >
> >> > I've come up with an idea of improving our site map [1], which is
> >> > essentially a good idea to have. it seems the current version is
> >> > longish. I've have had a sitemap that is really a map with many
> >> > structured links all fitting into one page - and not a long listing
> of
> >> > all pages that we have. The *map* word has the idea of a more
> compact
> >> > design.
> >> >
> >> > With this in mind, I've thought of creating a shorter sitemap [2].
> I
> >> > still haven't managed to remove all comments to pages, but the new
> >> > design has much less text and organizes links in two columns.
> >> > I'm looking forward to ideas and feedback. My attempt has been very
> >> > straight-forward, and your fresh eye could help us improve the
> >> > navigation a lot.
> >> > .. or you could just say that we have a perfect sitemap, and we
> don't
> >> > need to change anything;)
> >> >
> >> >
> >> > [1]http://harmony.apache.org/sitemap.html
> >> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> >> >
> >> > Thanks,
> >> > Nadya Morozova
> >> >
> >>
> >>
> >> --
> >> With best regards,
> >> Alexei,
> >> ESSD, Intel
> >>
> >
> >--
> >Egor Pasko
>

Re: [site][doc] improving sitemap

Posted by Egor Pasko <eg...@gmail.com>.
On the 0x302 day of Apache Harmony Alexei Fedotov wrote:
> Nadya,
> I like an idea to remove a control bar from the map to make a layout compact.

+1, and 2 columns looks really really great

Nadya, what do you mean by "shorter sitemap"? Is it that only
descriptions become shorter or you killed a couple of unpopoular links
too?

> 
> On 6/27/07, Morozova, Nadezhda <na...@intel.com> wrote:
> > Hi everyone,
> >
> > I've come up with an idea of improving our site map [1], which is
> > essentially a good idea to have. it seems the current version is
> > longish. I've have had a sitemap that is really a map with many
> > structured links all fitting into one page - and not a long listing of
> > all pages that we have. The *map* word has the idea of a more compact
> > design.
> >
> > With this in mind, I've thought of creating a shorter sitemap [2]. I
> > still haven't managed to remove all comments to pages, but the new
> > design has much less text and organizes links in two columns.
> > I'm looking forward to ideas and feedback. My attempt has been very
> > straight-forward, and your fresh eye could help us improve the
> > navigation a lot.
> > .. or you could just say that we have a perfect sitemap, and we don't
> > need to change anything;)
> >
> >
> > [1]http://harmony.apache.org/sitemap.html
> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> >
> > Thanks,
> > Nadya Morozova
> >
> 
> 
> -- 
> With best regards,
> Alexei,
> ESSD, Intel
> 

-- 
Egor Pasko


Re: [site][doc] improving sitemap

Posted by Alexei Fedotov <al...@gmail.com>.
Nadya,
I like an idea to remove a control bar from the map to make a layout compact.


On 6/27/07, Morozova, Nadezhda <na...@intel.com> wrote:
> Hi everyone,
>
> I've come up with an idea of improving our site map [1], which is
> essentially a good idea to have. it seems the current version is
> longish. I've have had a sitemap that is really a map with many
> structured links all fitting into one page - and not a long listing of
> all pages that we have. The *map* word has the idea of a more compact
> design.
>
> With this in mind, I've thought of creating a shorter sitemap [2]. I
> still haven't managed to remove all comments to pages, but the new
> design has much less text and organizes links in two columns.
> I'm looking forward to ideas and feedback. My attempt has been very
> straight-forward, and your fresh eye could help us improve the
> navigation a lot.
> .. or you could just say that we have a perfect sitemap, and we don't
> need to change anything;)
>
>
> [1]http://harmony.apache.org/sitemap.html
> [2]http://people.apache.org/~nadinem/sitemap_alt.html
>
> Thanks,
> Nadya Morozova
>


-- 
With best regards,
Alexei,
ESSD, Intel

Re: [site][doc] improving sitemap

Posted by Spark Shen <sm...@gmail.com>.
2007/7/5, Alexey Ivanov <al...@gmail.com>:
>
> Spark,
>
> The site of Lucene is cool, and we may consider using their approach
> to navigation. However implementing it wouldn't be very easy because
> it will require to re-write the navigation support completely.
>
> I didn't come up with many site which feature site map. Those I looked
> at didn't have any description of the links. Despite this fact, I
> consider that having a short description for a link is good idea, at
> least for some of the links.


Agree.

As another option for placing description is *using title attribute*
> which will be rendered as a tooltip in all browsers. When user hovers
> link with mouse, a tooltip with link description will be displayed.
> This approach will surely reduce "visual clutter".


IMHO, this site map is still a little too verbose. That would be a GREAT
idea at least to me.

Regards,
> Alexey.
>
> 2007/7/3, Spark Shen <sm...@gmail.com>:
> > I love the new one very much.
> >
> > I have my opinion:
> > It is indeed much better than the previous one, but if this page is
> taken as
> > the index page, it may be a little visually too verbose.
> > I'd suggest lucene project's index page [1]. It put different content
> into
> > different tabs.
> >
> > I think the tabbed layout would show one focus per tab. This way we can
> keep
> > compact and clean together.
> >
> > Just FYI
> >
> > [1] http://lucene.apache.org/
> >
> > 2007/6/27, Morozova, Nadezhda <na...@intel.com>:
> > >
> > > Hi everyone,
> > >
> > > I've come up with an idea of improving our site map [1], which is
> > > essentially a good idea to have. it seems the current version is
> > > longish. I've have had a sitemap that is really a map with many
> > > structured links all fitting into one page - and not a long listing of
> > > all pages that we have. The *map* word has the idea of a more compact
> > > design.
> > >
> > > With this in mind, I've thought of creating a shorter sitemap [2]. I
> > > still haven't managed to remove all comments to pages, but the new
> > > design has much less text and organizes links in two columns.
> > > I'm looking forward to ideas and feedback. My attempt has been very
> > > straight-forward, and your fresh eye could help us improve the
> > > navigation a lot.
> > > .. or you could just say that we have a perfect sitemap, and we don't
> > > need to change anything;)
> > >
> > >
> > > [1]http://harmony.apache.org/sitemap.html
> > > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> > >
> > > Thanks,
> > > Nadya Morozova
> > >
> >
> >
> >
> > --
> > Spark Shen
> > China Software Development Lab, IBM
> >
>



-- 
Spark Shen
China Software Development Lab, IBM

Re: [site][doc] improving sitemap

Posted by Alexey Ivanov <al...@gmail.com>.
Spark,

The site of Lucene is cool, and we may consider using their approach
to navigation. However implementing it wouldn't be very easy because
it will require to re-write the navigation support completely.

I didn't come up with many site which feature site map. Those I looked
at didn't have any description of the links. Despite this fact, I
consider that having a short description for a link is good idea, at
least for some of the links.

As another option for placing description is *using title attribute*
which will be rendered as a tooltip in all browsers. When user hovers
link with mouse, a tooltip with link description will be displayed.
This approach will surely reduce "visual clutter".


Regards,
Alexey.

2007/7/3, Spark Shen <sm...@gmail.com>:
> I love the new one very much.
>
> I have my opinion:
> It is indeed much better than the previous one, but if this page is taken as
> the index page, it may be a little visually too verbose.
> I'd suggest lucene project's index page [1]. It put different content into
> different tabs.
>
> I think the tabbed layout would show one focus per tab. This way we can keep
> compact and clean together.
>
> Just FYI
>
> [1] http://lucene.apache.org/
>
> 2007/6/27, Morozova, Nadezhda <na...@intel.com>:
> >
> > Hi everyone,
> >
> > I've come up with an idea of improving our site map [1], which is
> > essentially a good idea to have. it seems the current version is
> > longish. I've have had a sitemap that is really a map with many
> > structured links all fitting into one page - and not a long listing of
> > all pages that we have. The *map* word has the idea of a more compact
> > design.
> >
> > With this in mind, I've thought of creating a shorter sitemap [2]. I
> > still haven't managed to remove all comments to pages, but the new
> > design has much less text and organizes links in two columns.
> > I'm looking forward to ideas and feedback. My attempt has been very
> > straight-forward, and your fresh eye could help us improve the
> > navigation a lot.
> > .. or you could just say that we have a perfect sitemap, and we don't
> > need to change anything;)
> >
> >
> > [1]http://harmony.apache.org/sitemap.html
> > [2]http://people.apache.org/~nadinem/sitemap_alt.html
> >
> > Thanks,
> > Nadya Morozova
> >
>
>
>
> --
> Spark Shen
> China Software Development Lab, IBM
>

RE: [site][doc] improving sitemap

Posted by "Morozova, Nadezhda" <na...@intel.com>.
Hi,
Thanks for your opinions on the site map, and Lucene's expandable tabbed
menu indeed looks compact and nice.
However, I'm not sure how we can fit this idea into the current layout
of Harmony's website: in our site organization, the sitemap is a
separate page aiming at giving a list of all pages of the site - for
reference and supplementary navigation. A short definition on each page
might be helpful in this case.
If we decide to merge the nav menu on the left and the sitemap, Lucene's
got a role model for us :) 

Cheers, 
Nadya
 
>-----Original Message-----
>From: Spark Shen [mailto:smallsmallorgan@gmail.com]
>Sent: Tuesday, July 03, 2007 10:58 AM
>To: dev@harmony.apache.org
>Subject: Re: [site][doc] improving sitemap
>
>I love the new one very much.
>
>I have my opinion:
>It is indeed much better than the previous one, but if this page is
taken
>as
>the index page, it may be a little visually too verbose.
>I'd suggest lucene project's index page [1]. It put different content
into
>different tabs.
>
>I think the tabbed layout would show one focus per tab. This way we can
>keep
>compact and clean together.
>
>Just FYI
>
>[1] http://lucene.apache.org/
>
>2007/6/27, Morozova, Nadezhda <na...@intel.com>:
>>
>> Hi everyone,
>>
>> I've come up with an idea of improving our site map [1], which is
>> essentially a good idea to have. it seems the current version is
>> longish. I've have had a sitemap that is really a map with many
>> structured links all fitting into one page - and not a long listing
of
>> all pages that we have. The *map* word has the idea of a more compact
>> design.
>>
>> With this in mind, I've thought of creating a shorter sitemap [2]. I
>> still haven't managed to remove all comments to pages, but the new
>> design has much less text and organizes links in two columns.
>> I'm looking forward to ideas and feedback. My attempt has been very
>> straight-forward, and your fresh eye could help us improve the
>> navigation a lot.
>> .. or you could just say that we have a perfect sitemap, and we don't
>> need to change anything;)
>>
>>
>> [1]http://harmony.apache.org/sitemap.html
>> [2]http://people.apache.org/~nadinem/sitemap_alt.html
>>
>> Thanks,
>> Nadya Morozova
>>
>
>
>
>--
>Spark Shen
>China Software Development Lab, IBM

Re: [site][doc] improving sitemap

Posted by Spark Shen <sm...@gmail.com>.
I love the new one very much.

I have my opinion:
It is indeed much better than the previous one, but if this page is taken as
the index page, it may be a little visually too verbose.
I'd suggest lucene project's index page [1]. It put different content into
different tabs.

I think the tabbed layout would show one focus per tab. This way we can keep
compact and clean together.

Just FYI

[1] http://lucene.apache.org/

2007/6/27, Morozova, Nadezhda <na...@intel.com>:
>
> Hi everyone,
>
> I've come up with an idea of improving our site map [1], which is
> essentially a good idea to have. it seems the current version is
> longish. I've have had a sitemap that is really a map with many
> structured links all fitting into one page - and not a long listing of
> all pages that we have. The *map* word has the idea of a more compact
> design.
>
> With this in mind, I've thought of creating a shorter sitemap [2]. I
> still haven't managed to remove all comments to pages, but the new
> design has much less text and organizes links in two columns.
> I'm looking forward to ideas and feedback. My attempt has been very
> straight-forward, and your fresh eye could help us improve the
> navigation a lot.
> .. or you could just say that we have a perfect sitemap, and we don't
> need to change anything;)
>
>
> [1]http://harmony.apache.org/sitemap.html
> [2]http://people.apache.org/~nadinem/sitemap_alt.html
>
> Thanks,
> Nadya Morozova
>



-- 
Spark Shen
China Software Development Lab, IBM

RE: [site][doc] improving sitemap

Posted by "Morozova, Nadezhda" <na...@intel.com>.
Ok, seems people are liking the new version.
I'll upload to the site when I'm done organizing into groups and fixing
wording. 
Thanks everyone. If you find an error on the site map, just let me know.

Cheers, 
Nadya
 
>-----Original Message-----
>From: Gregory Shimansky [mailto:gshimansky@gmail.com] On Behalf Of
Gregory
>Shimansky
>Sent: Wednesday, June 27, 2007 4:16 PM
>To: dev@harmony.apache.org
>Subject: Re: [site][doc] improving sitemap
>
>Tim Ellison wrote:
>> Morozova, Nadezhda wrote:
>>> Hi everyone,
>>>
>>> I've come up with an idea of improving our site map [1], which is
>>> essentially a good idea to have. it seems the current version is
>>> longish. I've have had a sitemap that is really a map with many
>>> structured links all fitting into one page - and not a long listing
of
>>> all pages that we have. The *map* word has the idea of a more
compact
>>> design.
>>>
>>> With this in mind, I've thought of creating a shorter sitemap [2]. I
>>> still haven't managed to remove all comments to pages, but the new
>>> design has much less text and organizes links in two columns.
>>> I'm looking forward to ideas and feedback. My attempt has been very
>>> straight-forward, and your fresh eye could help us improve the
>>> navigation a lot.
>>> .. or you could just say that we have a perfect sitemap, and we
don't
>>> need to change anything;)
>>>
>>>
>>> [1]http://harmony.apache.org/sitemap.html
>>> [2]http://people.apache.org/~nadinem/sitemap_alt.html
>>
>>
>> The new one looks much better.  Good job.
>
>+1
>I live the 2nd version.
>
>--
>Gregory

Re: [site][doc] improving sitemap

Posted by Gregory Shimansky <gs...@apache.org>.
Tim Ellison wrote:
> Morozova, Nadezhda wrote:
>> Hi everyone,
>>
>> I've come up with an idea of improving our site map [1], which is
>> essentially a good idea to have. it seems the current version is
>> longish. I've have had a sitemap that is really a map with many
>> structured links all fitting into one page - and not a long listing of
>> all pages that we have. The *map* word has the idea of a more compact
>> design.
>>
>> With this in mind, I've thought of creating a shorter sitemap [2]. I
>> still haven't managed to remove all comments to pages, but the new
>> design has much less text and organizes links in two columns.
>> I'm looking forward to ideas and feedback. My attempt has been very
>> straight-forward, and your fresh eye could help us improve the
>> navigation a lot.
>> .. or you could just say that we have a perfect sitemap, and we don't
>> need to change anything;) 
>>
>>
>> [1]http://harmony.apache.org/sitemap.html
>> [2]http://people.apache.org/~nadinem/sitemap_alt.html
> 
> 
> The new one looks much better.  Good job.

+1
I live the 2nd version.

-- 
Gregory


Re: [site][doc] improving sitemap

Posted by Tim Ellison <t....@gmail.com>.
Morozova, Nadezhda wrote:
> Hi everyone,
> 
> I've come up with an idea of improving our site map [1], which is
> essentially a good idea to have. it seems the current version is
> longish. I've have had a sitemap that is really a map with many
> structured links all fitting into one page - and not a long listing of
> all pages that we have. The *map* word has the idea of a more compact
> design.
> 
> With this in mind, I've thought of creating a shorter sitemap [2]. I
> still haven't managed to remove all comments to pages, but the new
> design has much less text and organizes links in two columns.
> I'm looking forward to ideas and feedback. My attempt has been very
> straight-forward, and your fresh eye could help us improve the
> navigation a lot.
> .. or you could just say that we have a perfect sitemap, and we don't
> need to change anything;) 
> 
> 
> [1]http://harmony.apache.org/sitemap.html
> [2]http://people.apache.org/~nadinem/sitemap_alt.html


The new one looks much better.  Good job.

Regards,
Tim