You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by Christian Grobmeier <gr...@gmail.com> on 2011/10/05 13:12:49 UTC

[DISCUSS] Layout change - remove the right table

Hi,

currently we use a three column model. On the right side is the search
box, links to thanks page and all the projects listed. Everytime we
add a new podling all podling pages need to be updated too.

I we should remove the third (right) column, because:
- the thanks page is already linked on the left side
- the search box can be moved to the left side
- a simple link to "Incubator Projects" can lead to the
projects/index.html page, which already is cared about

This will give us more space for the real content and we can play a
little with the css (which I plan).

Here is how it would look like:

http://code.grobmeier.de/incubator-draft/
http://code.grobmeier.de/incubator-draft/projects/index.html
http://code.grobmeier.de/incubator-draft/projects/ognl.html

Please let me know what you think about this change.

Cheers
Christian

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
On Thu, Oct 6, 2011 at 12:46 PM, sebb <se...@gmail.com> wrote:
> On 5 October 2011 20:06, Donald Whytock <dw...@gmail.com> wrote:
>> What about storing the podling names in a table somewhere and using a
>> Javascript fragment to read the table and populate the right-column
>> list?  Pages that include the script therefore don't have to be
>> updated at all when the podling list changes.
>
> I like that.

Actually there is more reason to remove the third column for me, not
only the svn update problem:
it is unbelievable ugly. It depresses me. I don't see a need for this
navigation.
But of course it is a matter of taste.

> It would fit in with the idea of maintaining a podling registry in an
> XML file or similar.
>
> The registry would contain all podling names (current and previous)
> together with state (active, dormant, graduated, retired) and other
> basic information.
> This would be used to generate the podling summary page(s) as well.

This is actually a good improvement. Which leads to the question why
not all status pages are done in plain xml. And so on. While I like
the idea of an easy maintenance registry I can't do that all alone.
Therefore I would like to concentrate to improve the layout step by
step. If somebody else wants to help situation is a bit different of
course. Is one of you guys volunteering to create such a registry?

Cheers
Christian

>
>> Don
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 7 October 2011 22:23, sebb <se...@gmail.com> wrote:
> On 7 October 2011 22:10, sebb <se...@gmail.com> wrote:
>> On 7 October 2011 10:03, Christian Grobmeier <gr...@gmail.com> wrote:
>>> On Fri, Oct 7, 2011 at 5:25 AM, Donald Whytock <dw...@gmail.com> wrote:
>>>> Apologies.  Forgot the status field.
>>>>
>>>> On Thu, Oct 6, 2011 at 11:11 PM, Donald Whytock <dw...@gmail.com> wrote:
>>>>> Okay...attached is a very simple podlings.xml, made from the contents
>>>>> of the podlings page.
>>>>>
>>>>> I itemized mentors, and made start and end dates two separate fields.
>>
>> That's good.
>>
>>>>> However, I had to take anchors out of the descriptions.
>>>
>>> Actually looks pretty good Don thanks for doing it
>>
>> Yes, thanks for doing it.
>>
>> However I think it would make sense to sort the entries by podling
>> name, rather than by name within status.
>> Otherwise it will be a pain when the status changes.
>>
>> Also, rather than use a <website> tag, I think it would be better to
>> use a tag which is the podling identity name (or whatever we call it).
>> For most podlings, this is just the name in lower-case, however there
>> are some exceptions that currently have to be hard-coded in clutch.py.
>> It's then easier to use the value to create the website and in other cases.
>>
>> Accumulo => accumulo
>> OpenOffice.org => openofficeorg
>>
>>> We need a good place for this. I suggest /site-author/podlings.xml
>>
>> That seems OK.
>
> Just discovered it gets copied to site-publish - do we want that?
> I suppose it might be useful. If not, build.xml needs updating.

Forget that, I see that the copying is deliberate.

If we can create site-author/projects/index.xml from it and maintain
the same format, then clutch won't have to be updated immediately.

I'll have a bash at that shortly.

>>> Christian
>>>
>>>>>
>>>>> Don
>>>>>
>>>>
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>>>> For additional commands, e-mail: general-help@incubator.apache.org
>>>>
>>>
>>>
>>>
>>> --
>>> http://www.grobmeier.de
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>>> For additional commands, e-mail: general-help@incubator.apache.org
>>>
>>>
>>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 7 October 2011 22:10, sebb <se...@gmail.com> wrote:
> On 7 October 2011 10:03, Christian Grobmeier <gr...@gmail.com> wrote:
>> On Fri, Oct 7, 2011 at 5:25 AM, Donald Whytock <dw...@gmail.com> wrote:
>>> Apologies.  Forgot the status field.
>>>
>>> On Thu, Oct 6, 2011 at 11:11 PM, Donald Whytock <dw...@gmail.com> wrote:
>>>> Okay...attached is a very simple podlings.xml, made from the contents
>>>> of the podlings page.
>>>>
>>>> I itemized mentors, and made start and end dates two separate fields.
>
> That's good.
>
>>>> However, I had to take anchors out of the descriptions.
>>
>> Actually looks pretty good Don thanks for doing it
>
> Yes, thanks for doing it.
>
> However I think it would make sense to sort the entries by podling
> name, rather than by name within status.
> Otherwise it will be a pain when the status changes.
>
> Also, rather than use a <website> tag, I think it would be better to
> use a tag which is the podling identity name (or whatever we call it).
> For most podlings, this is just the name in lower-case, however there
> are some exceptions that currently have to be hard-coded in clutch.py.
> It's then easier to use the value to create the website and in other cases.
>
> Accumulo => accumulo
> OpenOffice.org => openofficeorg
>
>> We need a good place for this. I suggest /site-author/podlings.xml
>
> That seems OK.

Just discovered it gets copied to site-publish - do we want that?
I suppose it might be useful. If not, build.xml needs updating.

>> Christian
>>
>>>>
>>>> Don
>>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>>> For additional commands, e-mail: general-help@incubator.apache.org
>>>
>>
>>
>>
>> --
>> http://www.grobmeier.de
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 8 October 2011 05:25, David Crossley <cr...@apache.org> wrote:
> Donald Whytock wrote:
>> sebb wrote:
>> > There ought to be a tapestry.html file locally; may need to generate a
>> > dummy one if the original cannot be recovered (or never existed).
>>
>> Weird...there IS a Tapestry page: http://tapestry.apache.org
>>
>> The URL on the podling page is just wrong.
>>
>> Latest XML attached.
>
> Yep the URL must be their podling Status page.
>
>
> Regarding the "resource" attribute:
>
> Clutch checks to see if their various resources
> are available yet.
>
> It tries with various names (and it also gets further
> hints from their Status page for each particlar resource):
> first the lowercase, no whitespace version of the project name
> then a set of "resource names" (yes some have been known
> to use two or three different inconsistent names).
>
> Here are the ones that Clutch is currently using
> (sorry no time, just grabbed bits from the code):
>
> Manifold Connector Framework (ManifoldCF) = manifoldcf
>
>  if k == "zetacomponents":
>    projects[k]['resourceNames'].append("zeta")
>  elif k == "beanvalidation":
>    projects[k]['resourceNames'].append("bval")
>  elif k == "lucene.net":
>    projects[k]['resourceNames'].append("lucene-net")
>  elif k == "manifoldcf":
>    projects[k]['resourceNames'].append("connectors")
>  elif k == "openoffice.org":
>    projects[k]['resourceNames'].append("ooo")
>  elif k == "odftoolkit":
>    projects[k]['resourceNames'].append("odf")
>
>  if k == 'lucene.net':
>    tlpSvn = "lucene-dot-net"

These could probably be handled with an optional "resourceAlias" attribute.
But this could be left until later, after the main bulk of the work is done.

> -David
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by David Crossley <cr...@apache.org>.
Donald Whytock wrote:
> sebb wrote:
> > There ought to be a tapestry.html file locally; may need to generate a
> > dummy one if the original cannot be recovered (or never existed).
> 
> Weird...there IS a Tapestry page: http://tapestry.apache.org
> 
> The URL on the podling page is just wrong.
> 
> Latest XML attached.

Yep the URL must be their podling Status page.


Regarding the "resource" attribute:

Clutch checks to see if their various resources
are available yet. 

It tries with various names (and it also gets further
hints from their Status page for each particlar resource):
first the lowercase, no whitespace version of the project name
then a set of "resource names" (yes some have been known
to use two or three different inconsistent names).

Here are the ones that Clutch is currently using
(sorry no time, just grabbed bits from the code):

Manifold Connector Framework (ManifoldCF) = manifoldcf

  if k == "zetacomponents":
    projects[k]['resourceNames'].append("zeta")
  elif k == "beanvalidation":
    projects[k]['resourceNames'].append("bval")
  elif k == "lucene.net":
    projects[k]['resourceNames'].append("lucene-net")
  elif k == "manifoldcf":
    projects[k]['resourceNames'].append("connectors")
  elif k == "openoffice.org":
    projects[k]['resourceNames'].append("ooo")
  elif k == "odftoolkit":
    projects[k]['resourceNames'].append("odf")

  if k == 'lucene.net':
    tlpSvn = "lucene-dot-net"

-David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
>> That would probably be fine - I'd like to see it before endorsing it fully.
>
> It would have been better to do it in a branch.

Agreed.

Actually there was so less comments (most of them positive) that I
didn't think about a branch.

> The current half-finished changes have made it difficult for
> the Incubator to operate. There are uncommitted generated docs
> changes for all pages. So real content changes are troublesome.

The website can be generated. The rh table is not there, but we can
add it in another change. I am going to commit generated changes now,
to keep up operations. Then we can care on the one single list of
projects.

>
> -David
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Marvin Humphrey <ma...@rectangular.com>.
On Mon, Oct 10, 2011 at 01:14:39AM +0100, sebb wrote:
> Although JSON is simpler, it does not allow comments AFAIK, which I
> think rules it out as a suitable original source file.

For the record: indeed, JSON as spec'd in RFC 4627 does not allow comments.
Some parser implementations support various kinds of comments as an extension.

Marvin Humphrey


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by David Crossley <cr...@apache.org>.
sebb wrote:
> David Crossley wrote:
> > sebb wrote:
> >> Christian Grobmeier wrote:
> >> >
> >> > I have added my layout changes too (website not updated). We need to
> >> > find a consens on the rh table. I am still not a fan of this, it
> >> > simply ugly. We have spoken on this thread about generating some kind
> >> > of projects list from the podlings.xml file. It could show a some kind
> >> > of dropdown menu from javascript. would you accept this als
> >> > alternative?
> >>
> >> That would probably be fine - I'd like to see it before endorsing it fully.
> >
> > It would have been better to do it in a branch.
> 
> +1
> 
> I think the style changes should be done separately from the change to
> use podlings.xml.
> 
> They are independent changes, and the podlings/XSLT change will affect
> at most the formatting of the projects index.xml page.

Yes i agree, and meant to say something about that.

Clutch can be tweaked if necessary. When the podlings.xml config
settles, then Clutch can also use it directly.

-David

> > The current half-finished changes have made it difficult for
> > the Incubator to operate. There are uncommitted generated docs
> > changes for all pages. So real content changes are troublesome.
> 
> > -David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
On Mon, Oct 10, 2011 at 2:21 PM, Martijn Dashorst
<ma...@gmail.com> wrote:
> On Mon, Oct 10, 2011 at 1:57 PM, sebb <se...@gmail.com> wrote:
>>> Thats exactly what I mean with a mess. Hope it clarifies a bit, b/c I
>>> thought about it a pretty long time.
>>
>> I agree that the LHS menu is confusing and messy, but for me, the RHS
>> list is simple and useful.
>
> For me the RHS list is not useful at all. It provides a list of
> project names, but that is it. All but a few are meaningless in their
> names:
>
> Accumulo
...
> Catalog
>
> The only project I actually get (as a Java developer) is Bean
> Validation. The rest provide no meaning whatsoever as to what they do
> and why I should click on them.
>
> A generic project page listing all projects with their description,
> extended with some JavaScript  filtering would be awesome, as long as
> each project provides some tags as to their meaning (but the
> JavaScript filter could also filter based on the description).

+1

Here we go Martijn:
http://incubator.apache.org/projects/index.html

This is the page you need - just without the fancy javascipt filter
and the tags. The tags by the way is actually a very good idea. We
should try to improve this page instead of using a three column model
just because... because.


>
> Martijn
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Martijn Dashorst <ma...@gmail.com>.
On Mon, Oct 10, 2011 at 1:57 PM, sebb <se...@gmail.com> wrote:
>> Thats exactly what I mean with a mess. Hope it clarifies a bit, b/c I
>> thought about it a pretty long time.
>
> I agree that the LHS menu is confusing and messy, but for me, the RHS
> list is simple and useful.

For me the RHS list is not useful at all. It provides a list of
project names, but that is it. All but a few are meaningless in their
names:

Accumulo
Ace
Airavata
Ambari
Amber
Any23
Bean Validation
Bigtop
Celix
Chukwa
Clerezza
Deft
Deltacloud
DirectMemory
Droids
EasyAnt
Empire-db
Etch
Flume
Giraph
Gora
Hama
Catalog

The only project I actually get (as a Java developer) is Bean
Validation. The rest provide no meaning whatsoever as to what they do
and why I should click on them.

A generic project page listing all projects with their description,
extended with some JavaScript  filtering would be awesome, as long as
each project provides some tags as to their meaning (but the
JavaScript filter could also filter based on the description).

Martijn

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
On Mon, Oct 10, 2011 at 10:58 AM, Christian Grobmeier
<gr...@gmail.com> wrote:
> Ok, for you. Not me. I believe people coming from outside are confused
> by this navigation too. Of course I cannot prove it, but all the
> website I like have easier navigation.

So what's the use case for the RHS column?  Presumably it's to quickly
navigate to a project of interest, which is good if you know what
you're looking for.  But then, if you know what you're looking for,
you also know it's at incubator.apache.org/<whatyou'relookingfor>.

If you don't know what you're looking for, a list of names may not be
as useful as, say, the actual podlings list page which has
descriptions along with the names.

Mostly it would seem useful if you *almost* know what you're looking
for..."What was the name of that podling again...? Well, let's go to
incubator.apache.org and...Oh, of course.  Chukwa."

So which of these is best served by the presence of the column, and is
that a frequently-enough-occurring need to demand the column?

Don

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
>> - 95+ visible links on a webpage visible navigation is a mess for me.
>
> It's not much longer than the LHS navigation, and would be a similar
> length if the non-project entries were removed as previously proposed.

It not about length. Its about confusion level. 40 links on the left,
40 on the right and 10 in the middle is short, but confusing.

>
>>  - The list of projects is nothing else than a menu which is opened by
>> default. Two different standard ways (projects/index.html and sidebar)
>> lead to the same information - it is a duplicate navigation.
>
> The problem I have is that projects/index.html is not easy to
> navigate, because the page is *much* longer than the RHS list.
>
> It's longer even if the non-active podlings were moved to a separate page.

Then we should put some work on projects/index.html and make it
better, instead of creating a duplicated navigation.

>
>> This is a
>> mess to, at least what I have learned about web navigation. Hard to
>> navigate, except you learned it.
>
> There's nothing difficult about the current RH links.

Duplicated navigation is always difficult, especially when you hit the
page for the first time of your life. A page navigation must be as
easy as possible, this is simply not the case.

>
>> - Instead we should provide one standard navigation way (as many other websites)
>
> Choice is not necessarily bad.

It is when it comes to website navigation, then then it is more than
bad. It makes your visitors go away.

>> and a new idea, we should provide breadcrumbs.
>
> Those are hard to get right.

Well, what to say? Yes, but actually a page like i.a.o should have it.
Its a complex page.

>
>> - There is even more I would change, now thinking about it:
>>
>> - Entry Guides has just one item: Proposal Guide. proposal guide
>> should be the main item, Entry guides need to be removed.
>>
>> - Entry guides link to http://incubator.apache.org/guides/index.html,
>> which duplicates navigation from the main left.
>>
>> - The "other guides" navigation item is named "General Incubator
>> Guides" at the  http://incubator.apache.org/guides/index.html site.
>>
>> - Alternative: Entry guides can stay as table of content for guides
>> and the "podling guides" navigation and the "Other guides" navigation
>> must disappear.
>>
>> - "Status of the Clutch" and the sub item "Current Podling Status"
>> links to the same page. Make only one item, everything else is
>> confusing.
>>
>>
>> Thats exactly what I mean with a mess. Hope it clarifies a bit, b/c I
>> thought about it a pretty long time.
>
> I agree that the LHS menu is confusing and messy, but for me, the RHS
> list is simple and useful.

Ok, for you. Not me. I believe people coming from outside are confused
by this navigation too. Of course I cannot prove it, but all the
website I like have easier navigation.

Cheers
Christian

>
>> Cheers,
>> Christian
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 10 October 2011 12:18, Christian Grobmeier <gr...@gmail.com> wrote:
> On Mon, Oct 10, 2011 at 12:28 PM, sebb <se...@gmail.com> wrote:
>> On 10 October 2011 09:09, Christian Grobmeier <gr...@gmail.com> wrote:
>>> On Mon, Oct 10, 2011 at 4:58 AM, sebb <se...@gmail.com> wrote:
>>>> On 10 October 2011 02:02, David Crossley <cr...@apache.org> wrote:
>>>>> sebb wrote:
>>>>>> Christian Grobmeier wrote:
>>>>>>
>>>>>> >>>>> I've not started looking at generating projects/index.xml yet.
>>>>>> >>>
>>>>>> >>> Reading the past mails shows me you are +1 to commit the layout
>>>>>> >>> changes. You are already working on the next steps :-)
>>>>>> >>
>>>>>> >> I'm not keen on losing the RH podling list, if that's what you mean; I
>>>>>> >> think it's useful.
>>>>>> >
>>>>>> > You was the only one who said so so far. WIth the bootstrap layout the
>>>>>> > project/index.html is even more readable than before.
>>>>>
>>>>> I reckon that it is important that the list of
>>>>> current podlings continues to be prominently displayed.
>>>>> Go to separate tables for further information.
>>>
>>> But not on every page.
>>> It is acceptable to have such a list on the front page, but please not
>>> on every single page. And if it is on the front page, then not as a
>>> third, tiny column messing up everything.
>>
>> In what way does it mess up everything currently?
>>
>> Can you post a screenshot somewhere we can inspect?
>
> I meant the website which is currently online.
>
> Its functional, but it is ugly and confusing. This is taste of course,
> but for me it looks like a mess, here are some reasons:
>
> - 95+ visible links on a webpage visible navigation is a mess for me.

It's not much longer than the LHS navigation, and would be a similar
length if the non-project entries were removed as previously proposed.

>  - The list of projects is nothing else than a menu which is opened by
> default. Two different standard ways (projects/index.html and sidebar)
> lead to the same information - it is a duplicate navigation.

The problem I have is that projects/index.html is not easy to
navigate, because the page is *much* longer than the RHS list.

It's longer even if the non-active podlings were moved to a separate page.

> This is a
> mess to, at least what I have learned about web navigation. Hard to
> navigate, except you learned it.

There's nothing difficult about the current RH links.

> - Instead we should provide one standard navigation way (as many other websites)

Choice is not necessarily bad.

> and a new idea, we should provide breadcrumbs.

Those are hard to get right.

> - There is even more I would change, now thinking about it:
>
> - Entry Guides has just one item: Proposal Guide. proposal guide
> should be the main item, Entry guides need to be removed.
>
> - Entry guides link to http://incubator.apache.org/guides/index.html,
> which duplicates navigation from the main left.
>
> - The "other guides" navigation item is named "General Incubator
> Guides" at the  http://incubator.apache.org/guides/index.html site.
>
> - Alternative: Entry guides can stay as table of content for guides
> and the "podling guides" navigation and the "Other guides" navigation
> must disappear.
>
> - "Status of the Clutch" and the sub item "Current Podling Status"
> links to the same page. Make only one item, everything else is
> confusing.
>
>
> Thats exactly what I mean with a mess. Hope it clarifies a bit, b/c I
> thought about it a pretty long time.

I agree that the LHS menu is confusing and messy, but for me, the RHS
list is simple and useful.

> Cheers,
> Christian
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
On Mon, Oct 10, 2011 at 12:28 PM, sebb <se...@gmail.com> wrote:
> On 10 October 2011 09:09, Christian Grobmeier <gr...@gmail.com> wrote:
>> On Mon, Oct 10, 2011 at 4:58 AM, sebb <se...@gmail.com> wrote:
>>> On 10 October 2011 02:02, David Crossley <cr...@apache.org> wrote:
>>>> sebb wrote:
>>>>> Christian Grobmeier wrote:
>>>>>
>>>>> >>>>> I've not started looking at generating projects/index.xml yet.
>>>>> >>>
>>>>> >>> Reading the past mails shows me you are +1 to commit the layout
>>>>> >>> changes. You are already working on the next steps :-)
>>>>> >>
>>>>> >> I'm not keen on losing the RH podling list, if that's what you mean; I
>>>>> >> think it's useful.
>>>>> >
>>>>> > You was the only one who said so so far. WIth the bootstrap layout the
>>>>> > project/index.html is even more readable than before.
>>>>
>>>> I reckon that it is important that the list of
>>>> current podlings continues to be prominently displayed.
>>>> Go to separate tables for further information.
>>
>> But not on every page.
>> It is acceptable to have such a list on the front page, but please not
>> on every single page. And if it is on the front page, then not as a
>> third, tiny column messing up everything.
>
> In what way does it mess up everything currently?
>
> Can you post a screenshot somewhere we can inspect?

I meant the website which is currently online.

Its functional, but it is ugly and confusing. This is taste of course,
but for me it looks like a mess, here are some reasons:

- 95+ visible links on a webpage visible navigation is a mess for me.

 - The list of projects is nothing else than a menu which is opened by
default. Two different standard ways (projects/index.html and sidebar)
lead to the same information - it is a duplicate navigation. This is a
mess to, at least what I have learned about web navigation. Hard to
navigate, except you learned it.

- Instead we should provide one standard navigation way (as many other
websites) and a new idea, we should provide breadcrumbs.

- There is even more I would change, now thinking about it:

- Entry Guides has just one item: Proposal Guide. proposal guide
should be the main item, Entry guides need to be removed.

- Entry guides link to http://incubator.apache.org/guides/index.html,
which duplicates navigation from the main left.

- The "other guides" navigation item is named "General Incubator
Guides" at the  http://incubator.apache.org/guides/index.html site.

- Alternative: Entry guides can stay as table of content for guides
and the "podling guides" navigation and the "Other guides" navigation
must disappear.

- "Status of the Clutch" and the sub item "Current Podling Status"
links to the same page. Make only one item, everything else is
confusing.


Thats exactly what I mean with a mess. Hope it clarifies a bit, b/c I
thought about it a pretty long time.

Cheers,
Christian

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 10 October 2011 09:09, Christian Grobmeier <gr...@gmail.com> wrote:
> On Mon, Oct 10, 2011 at 4:58 AM, sebb <se...@gmail.com> wrote:
>> On 10 October 2011 02:02, David Crossley <cr...@apache.org> wrote:
>>> sebb wrote:
>>>> Christian Grobmeier wrote:
>>>>
>>>> >>>>> I've not started looking at generating projects/index.xml yet.
>>>> >>>
>>>> >>> Reading the past mails shows me you are +1 to commit the layout
>>>> >>> changes. You are already working on the next steps :-)
>>>> >>
>>>> >> I'm not keen on losing the RH podling list, if that's what you mean; I
>>>> >> think it's useful.
>>>> >
>>>> > You was the only one who said so so far. WIth the bootstrap layout the
>>>> > project/index.html is even more readable than before.
>>>
>>> I reckon that it is important that the list of
>>> current podlings continues to be prominently displayed.
>>> Go to separate tables for further information.
>
> But not on every page.
> It is acceptable to have such a list on the front page, but please not
> on every single page. And if it is on the front page, then not as a
> third, tiny column messing up everything.

In what way does it mess up everything currently?

Can you post a screenshot somewhere we can inspect?

> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
On Mon, Oct 10, 2011 at 4:58 AM, sebb <se...@gmail.com> wrote:
> On 10 October 2011 02:02, David Crossley <cr...@apache.org> wrote:
>> sebb wrote:
>>> Christian Grobmeier wrote:
>>>
>>> >>>>> I've not started looking at generating projects/index.xml yet.
>>> >>>
>>> >>> Reading the past mails shows me you are +1 to commit the layout
>>> >>> changes. You are already working on the next steps :-)
>>> >>
>>> >> I'm not keen on losing the RH podling list, if that's what you mean; I
>>> >> think it's useful.
>>> >
>>> > You was the only one who said so so far. WIth the bootstrap layout the
>>> > project/index.html is even more readable than before.
>>
>> I reckon that it is important that the list of
>> current podlings continues to be prominently displayed.
>> Go to separate tables for further information.

But not on every page.
It is acceptable to have such a list on the front page, but please not
on every single page. And if it is on the front page, then not as a
third, tiny column messing up everything.

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 10 October 2011 02:02, David Crossley <cr...@apache.org> wrote:
> sebb wrote:
>> Christian Grobmeier wrote:
>>
>> >>>>> I've not started looking at generating projects/index.xml yet.
>> >>>
>> >>> Reading the past mails shows me you are +1 to commit the layout
>> >>> changes. You are already working on the next steps :-)
>> >>
>> >> I'm not keen on losing the RH podling list, if that's what you mean; I
>> >> think it's useful.
>> >
>> > You was the only one who said so so far. WIth the bootstrap layout the
>> > project/index.html is even more readable than before.
>
> I reckon that it is important that the list of
> current podlings continues to be prominently displayed.
> Go to separate tables for further information.
>
>> >> Introducing the podlings.xml file is independent of any layout changes.
>> >> The idea here is to centralise and simplify maintenance of podling
>> >> summary details.
>> >
>> > Yes I understand that. But this thread is/was about layout changes.
>> > This xml can be used for many things.
>> >
>> >>
>> >>> BTW, I have made a copy of the podlings.xml file because probably we
>> >>> want to use that for some javascript magic. Of course, transforming it
>> >>> to JSON would make things easier.
>> >>
>> >> Easier for Javascript maybe; not so easy for XSLT, and might be harder
>> >> for clutch.
>> >>
>> >> However, we could easily convert to JSON for the published version of the file.
>> >
>> > Transformation to both formats are possible of course
>>
>> It's really a question of which format is easiest to maintain.
>>
>> Although JSON is simpler, it does not allow comments AFAIK, which I
>> think rules it out as a suitable original source file.
>> Also, there are currently more tools to work with XML, again AFAIK.
>>
>> >
>> >>>>
>> >>>> And I won't now have time until Sunday earliest.
>> >>
>> >> Actually, I did already commit a sample XSLT, however it is not yet
>> >> integrated into the build process.
>> >
>> > Yes saw it.
>> >
>> > I have added my layout changes too (website not updated). We need to
>> > find a consens on the rh table. I am still not a fan of this, it
>> > simply ugly. We have spoken on this thread about generating some kind
>> > of projects list from the podlings.xml file. It could show a some kind
>> > of dropdown menu from javascript. would you accept this als
>> > alternative?
>>
>> That would probably be fine - I'd like to see it before endorsing it fully.
>
> It would have been better to do it in a branch.

+1

I think the style changes should be done separately from the change to
use podlings.xml.

They are independent changes, and the podlings/XSLT change will affect
at most the formatting of the projects index.xml page.

> The current half-finished changes have made it difficult for
> the Incubator to operate. There are uncommitted generated docs
> changes for all pages. So real content changes are troublesome.

> -David
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by David Crossley <cr...@apache.org>.
sebb wrote:
> Christian Grobmeier wrote:
>
> >>>>> I've not started looking at generating projects/index.xml yet.
> >>>
> >>> Reading the past mails shows me you are +1 to commit the layout
> >>> changes. You are already working on the next steps :-)
> >>
> >> I'm not keen on losing the RH podling list, if that's what you mean; I
> >> think it's useful.
> >
> > You was the only one who said so so far. WIth the bootstrap layout the
> > project/index.html is even more readable than before.

I reckon that it is important that the list of
current podlings continues to be prominently displayed.
Go to separate tables for further information.

> >> Introducing the podlings.xml file is independent of any layout changes.
> >> The idea here is to centralise and simplify maintenance of podling
> >> summary details.
> >
> > Yes I understand that. But this thread is/was about layout changes.
> > This xml can be used for many things.
> >
> >>
> >>> BTW, I have made a copy of the podlings.xml file because probably we
> >>> want to use that for some javascript magic. Of course, transforming it
> >>> to JSON would make things easier.
> >>
> >> Easier for Javascript maybe; not so easy for XSLT, and might be harder
> >> for clutch.
> >>
> >> However, we could easily convert to JSON for the published version of the file.
> >
> > Transformation to both formats are possible of course
> 
> It's really a question of which format is easiest to maintain.
> 
> Although JSON is simpler, it does not allow comments AFAIK, which I
> think rules it out as a suitable original source file.
> Also, there are currently more tools to work with XML, again AFAIK.
> 
> >
> >>>>
> >>>> And I won't now have time until Sunday earliest.
> >>
> >> Actually, I did already commit a sample XSLT, however it is not yet
> >> integrated into the build process.
> >
> > Yes saw it.
> >
> > I have added my layout changes too (website not updated). We need to
> > find a consens on the rh table. I am still not a fan of this, it
> > simply ugly. We have spoken on this thread about generating some kind
> > of projects list from the podlings.xml file. It could show a some kind
> > of dropdown menu from javascript. would you accept this als
> > alternative?
> 
> That would probably be fine - I'd like to see it before endorsing it fully.

It would have been better to do it in a branch.

The current half-finished changes have made it difficult for
the Incubator to operate. There are uncommitted generated docs
changes for all pages. So real content changes are troublesome.

-David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
On Fri, Oct 7, 2011 at 9:24 PM, sebb <se...@gmail.com> wrote:
> There ought to be a tapestry.html file locally; may need to generate a
> dummy one if the original cannot be recovered (or never existed).

Weird...there IS a Tapestry page: http://tapestry.apache.org

The URL on the podling page is just wrong.

Latest XML attached.

Don

Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 8 October 2011 02:17, Donald Whytock <dw...@gmail.com> wrote:
> On Fri, Oct 7, 2011 at 9:08 PM, sebb <se...@gmail.com> wrote:
>> It would be easier to edit and navigate if the attributes were all on
>> the same line as the <podling> tag
>
> Yeah, that's the plan.  I was just listing what attributes would be
> there.  I format the final file using XPontus.  I forgot sponsor, BTW;
> that'll be in there.
>
>> What do we do with projects such as "Manifold Connector Framework
>> (ManifoldCF)" ?
>>
>> That name is too long for a navigation list and probably some other places.
>>
>> Perhaps we need two types of name.
>> Probably better to use the short name by default, and allow the long
>> name to be used in some places.
>>
>> In that case, we would need to add an optional longName or fullName attribute.
>
> Okay.  Likewise, what about Tapestry?  It has a nonstandard
> "resource": http://jakarta.apache.org/tapestry/
>
> Optional website attribute?

No, because all the other websites point to the relevant Incubator
podling overview; Tapestry should too.

There ought to be a tapestry.html file locally; may need to generate a
dummy one if the original cannot be recovered (or never existed).

> I'm generating these with a PHP script that uses a chopped version of
> the podlings page as an XML source.  Single-item special cases will
> have to be manual for now.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
On Fri, Oct 7, 2011 at 9:08 PM, sebb <se...@gmail.com> wrote:
> It would be easier to edit and navigate if the attributes were all on
> the same line as the <podling> tag

Yeah, that's the plan.  I was just listing what attributes would be
there.  I format the final file using XPontus.  I forgot sponsor, BTW;
that'll be in there.

> What do we do with projects such as "Manifold Connector Framework
> (ManifoldCF)" ?
>
> That name is too long for a navigation list and probably some other places.
>
> Perhaps we need two types of name.
> Probably better to use the short name by default, and allow the long
> name to be used in some places.
>
> In that case, we would need to add an optional longName or fullName attribute.

Okay.  Likewise, what about Tapestry?  It has a nonstandard
"resource": http://jakarta.apache.org/tapestry/

Optional website attribute?

I'm generating these with a PHP script that uses a chopped version of
the podlings page as an XML source.  Single-item special cases will
have to be manual for now.

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
>>> However, we could easily convert to JSON for the published version of the file.
>>
>> Transformation to both formats are possible of course
>>
> It's really a question of which format is easiest to maintain.

XML of course.

> Although JSON is simpler, it does not allow comments AFAIK, which I
> think rules it out as a suitable original source file.
> Also, there are currently more tools to work with XML, again AFAIK.


Probably we are speaking of two different things.

Source: xml, transforms to html, json

podlings.xml -> podlings.html
podlings.xml -> podlings.json

No need to deal with json directly (except writing a json xslt)

Christian

>>>>>
>>>>> And I won't now have time until Sunday earliest.
>>>
>>> Actually, I did already commit a sample XSLT, however it is not yet
>>> integrated into the build process.
>>
>> Yes saw it.
>>
>> I have added my layout changes too (website not updated). We need to
>> find a consens on the rh table. I am still not a fan of this, it
>> simply ugly. We have spoken on this thread about generating some kind
>> of projects list from the podlings.xml file. It could show a some kind
>> of dropdown menu from javascript. would you accept this als
>> alternative?
>
> That would probably be fine - I'd like to see it before endorsing it fully.
>
>> Cheers
>>
>>
>>>
>>>> Perfect for me, I will try to commit the layout later today.
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>>> For additional commands, e-mail: general-help@incubator.apache.org
>>>
>>>
>>
>>
>>
>> --
>> http://www.grobmeier.de
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 9 October 2011 13:50, Christian Grobmeier <gr...@gmail.com> wrote:
>>>>> I've not started looking at generating projects/index.xml yet.
>>>
>>> Reading the past mails shows me you are +1 to commit the layout
>>> changes. You are already working on the next steps :-)
>>
>> I'm not keen on losing the RH podling list, if that's what you mean; I
>> think it's useful.
>
> You was the only one who said so so far. WIth the bootstrap layout the
> project/index.html is even more readable than before.
>
>> Introducing the podlings.xml file is independent of any layout changes.
>> The idea here is to centralise and simplify maintenance of podling
>> summary details.
>
> Yes I understand that. But this thread is/was about layout changes.
> This xml can be used for many things.
>
>>
>>> BTW, I have made a copy of the podlings.xml file because probably we
>>> want to use that for some javascript magic. Of course, transforming it
>>> to JSON would make things easier.
>>
>> Easier for Javascript maybe; not so easy for XSLT, and might be harder
>> for clutch.
>>
>> However, we could easily convert to JSON for the published version of the file.
>
> Transformation to both formats are possible of course
>

It's really a question of which format is easiest to maintain.

Although JSON is simpler, it does not allow comments AFAIK, which I
think rules it out as a suitable original source file.
Also, there are currently more tools to work with XML, again AFAIK.

>
>>>>
>>>> And I won't now have time until Sunday earliest.
>>
>> Actually, I did already commit a sample XSLT, however it is not yet
>> integrated into the build process.
>
> Yes saw it.
>
> I have added my layout changes too (website not updated). We need to
> find a consens on the rh table. I am still not a fan of this, it
> simply ugly. We have spoken on this thread about generating some kind
> of projects list from the podlings.xml file. It could show a some kind
> of dropdown menu from javascript. would you accept this als
> alternative?

That would probably be fine - I'd like to see it before endorsing it fully.

> Cheers
>
>
>>
>>> Perfect for me, I will try to commit the layout later today.
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>
>
>
> --
> http://www.grobmeier.de
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
>>>> I've not started looking at generating projects/index.xml yet.
>>
>> Reading the past mails shows me you are +1 to commit the layout
>> changes. You are already working on the next steps :-)
>
> I'm not keen on losing the RH podling list, if that's what you mean; I
> think it's useful.

You was the only one who said so so far. WIth the bootstrap layout the
project/index.html is even more readable than before.

> Introducing the podlings.xml file is independent of any layout changes.
> The idea here is to centralise and simplify maintenance of podling
> summary details.

Yes I understand that. But this thread is/was about layout changes.
This xml can be used for many things.

>
>> BTW, I have made a copy of the podlings.xml file because probably we
>> want to use that for some javascript magic. Of course, transforming it
>> to JSON would make things easier.
>
> Easier for Javascript maybe; not so easy for XSLT, and might be harder
> for clutch.
>
> However, we could easily convert to JSON for the published version of the file.

Transformation to both formats are possible of course


>>>
>>> And I won't now have time until Sunday earliest.
>
> Actually, I did already commit a sample XSLT, however it is not yet
> integrated into the build process.

Yes saw it.

I have added my layout changes too (website not updated). We need to
find a consens on the rh table. I am still not a fan of this, it
simply ugly. We have spoken on this thread about generating some kind
of projects list from the podlings.xml file. It could show a some kind
of dropdown menu from javascript. would you accept this als
alternative?

Cheers


>
>> Perfect for me, I will try to commit the layout later today.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 8 October 2011 08:49, Christian Grobmeier <gr...@gmail.com> wrote:
> On Sat, Oct 8, 2011 at 3:25 AM, sebb <se...@gmail.com> wrote:
>> On 8 October 2011 02:08, sebb <se...@gmail.com> wrote:
>>> On 8 October 2011 00:47, Donald Whytock <dw...@gmail.com> wrote:
>> Updated to use new format and committed.
>>
>> Output is to project-menu.tmp file currently; edit build.xml
>> generate-menu target to change this to .ent once podlings.xml is
>> updated.
>>
>>> I've not started looking at generating projects/index.xml yet.
>
> Reading the past mails shows me you are +1 to commit the layout
> changes. You are already working on the next steps :-)

I'm not keen on losing the RH podling list, if that's what you mean; I
think it's useful.

Introducing the podlings.xml file is independent of any layout changes.
The idea here is to centralise and simplify maintenance of podling
summary details.

> BTW, I have made a copy of the podlings.xml file because probably we
> want to use that for some javascript magic. Of course, transforming it
> to JSON would make things easier.

Easier for Javascript maybe; not so easy for XSLT, and might be harder
for clutch.

However, we could easily convert to JSON for the published version of the file.

>>
>> And I won't now have time until Sunday earliest.

Actually, I did already commit a sample XSLT, however it is not yet
integrated into the build process.

> Perfect for me, I will try to commit the layout later today.

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
On Sat, Oct 8, 2011 at 3:25 AM, sebb <se...@gmail.com> wrote:
> On 8 October 2011 02:08, sebb <se...@gmail.com> wrote:
>> On 8 October 2011 00:47, Donald Whytock <dw...@gmail.com> wrote:
> Updated to use new format and committed.
>
> Output is to project-menu.tmp file currently; edit build.xml
> generate-menu target to change this to .ent once podlings.xml is
> updated.
>
>> I've not started looking at generating projects/index.xml yet.

Reading the past mails shows me you are +1 to commit the layout
changes. You are already working on the next steps :-)

BTW, I have made a copy of the podlings.xml file because probably we
want to use that for some javascript magic. Of course, transforming it
to JSON would make things easier.

>
> And I won't now have time until Sunday earliest.

Perfect for me, I will try to commit the layout later today.

Cheers
Christian
>
>>
>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>>> For additional commands, e-mail: general-help@incubator.apache.org
>>>
>>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 8 October 2011 02:08, sebb <se...@gmail.com> wrote:
> On 8 October 2011 00:47, Donald Whytock <dw...@gmail.com> wrote:
>> On Fri, Oct 7, 2011 at 6:48 PM, sebb <se...@gmail.com> wrote:
>>> I'm now thinking it might be better to convert some of the tags to
>>> attributes, for example:
>>>
>>>    <podling name="Accumulo" resource="accumulo" status="current">
>>>
>>> These are all relatively short fields and I think it would make the
>>> file shorter and easier to read.
>>> I used "resource" rather than "id" because that seems to be what clutch uses.
>>
>> <podlings>
>>  <podling
>>    name="name"
>>    resource="resource"
>>    status="status"
>>    startdate="startdate"
>>    [enddate="enddate"]>
>>    <description>
>>      description
>>    </description>
>>    <mentors>
>>      <mentor>mentor</mentor>
>>    </mentors>
>      <sponsor>Sponsor (might be failrly long)</sponsor>
>>  </podling>
>> <podlings>
>>
>> Look good?
>
> It would be easier to edit and navigate if the attributes were all on
> the same line as the <podling> tag
>
> What do we do with projects such as "Manifold Connector Framework
> (ManifoldCF)" ?
>
> That name is too long for a navigation list and probably some other places.
>
> Perhaps we need two types of name.
> Probably better to use the short name by default, and allow the long
> name to be used in some places.
>
> In that case, we would need to add an optional longName or fullName attribute.
>
> BTW, I've created an XSL stylesheet that can generate project-menu.ent
> (which is how I found that Oozie was missing).
> It uses the original podlings.xml format (except I converted <website>
> into <resource>), but should be easy to change to use attributes
> instead.
> I'll commit it shortly.

Updated to use new format and committed.

Output is to project-menu.tmp file currently; edit build.xml
generate-menu target to change this to .ent once podlings.xml is
updated.

> I've not started looking at generating projects/index.xml yet.

And I won't now have time until Sunday earliest.

>
>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 8 October 2011 00:47, Donald Whytock <dw...@gmail.com> wrote:
> On Fri, Oct 7, 2011 at 6:48 PM, sebb <se...@gmail.com> wrote:
>> I'm now thinking it might be better to convert some of the tags to
>> attributes, for example:
>>
>>    <podling name="Accumulo" resource="accumulo" status="current">
>>
>> These are all relatively short fields and I think it would make the
>> file shorter and easier to read.
>> I used "resource" rather than "id" because that seems to be what clutch uses.
>
> <podlings>
>  <podling
>    name="name"
>    resource="resource"
>    status="status"
>    startdate="startdate"
>    [enddate="enddate"]>
>    <description>
>      description
>    </description>
>    <mentors>
>      <mentor>mentor</mentor>
>    </mentors>
      <sponsor>Sponsor (might be failrly long)</sponsor>
>  </podling>
> <podlings>
>
> Look good?

It would be easier to edit and navigate if the attributes were all on
the same line as the <podling> tag

What do we do with projects such as "Manifold Connector Framework
(ManifoldCF)" ?

That name is too long for a navigation list and probably some other places.

Perhaps we need two types of name.
Probably better to use the short name by default, and allow the long
name to be used in some places.

In that case, we would need to add an optional longName or fullName attribute.

BTW, I've created an XSL stylesheet that can generate project-menu.ent
(which is how I found that Oozie was missing).
It uses the original podlings.xml format (except I converted <website>
into <resource>), but should be easy to change to use attributes
instead.
I'll commit it shortly.

I've not started looking at generating projects/index.xml yet.


> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
On Fri, Oct 7, 2011 at 6:48 PM, sebb <se...@gmail.com> wrote:
> I'm now thinking it might be better to convert some of the tags to
> attributes, for example:
>
>    <podling name="Accumulo" resource="accumulo" status="current">
>
> These are all relatively short fields and I think it would make the
> file shorter and easier to read.
> I used "resource" rather than "id" because that seems to be what clutch uses.

<podlings>
  <podling
    name="name"
    resource="resource"
    status="status"
    startdate="startdate"
    [enddate="enddate"]>
    <description>
      description
    </description>
    <mentors>
      <mentor>mentor</mentor>
    </mentors>
  </podling>
<podlings>

Look good?

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 7 October 2011 23:09, Donald Whytock <dw...@gmail.com> wrote:
> On Fri, Oct 7, 2011 at 5:10 PM, sebb <se...@gmail.com> wrote:
>> However I think it would make sense to sort the entries by podling
>> name, rather than by name within status.
>> Otherwise it will be a pain when the status changes.
>>
>> Also, rather than use a <website> tag, I think it would be better to
>> use a tag which is the podling identity name (or whatever we call it).
>> For most podlings, this is just the name in lower-case, however there
>> are some exceptions that currently have to be hard-coded in clutch.py.
>> It's then easier to use the value to create the website and in other cases.
>
> Okay, so sorted by podling name, and instead of a website you'd like
> an "id" field that URLs and the like would be generated from?  I can
> kick that out this evening.

I'm now thinking it might be better to convert some of the tags to
attributes, for example:

    <podling name="Accumulo" resource="accumulo" status="current">

These are all relatively short fields and I think it would make the
file shorter and easier to read.
I used "resource" rather than "id" because that seems to be what clutch uses.

Also, XML editors / IDEs as Eclipse can show the attributes in the
outline, which makes it much easier to navigate the file

> Would it be desirable for this to be in a database?  Does Infra run a
> DBMS?  Either way, we can start with the XML.

Start with XML.

> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
On Fri, Oct 7, 2011 at 5:10 PM, sebb <se...@gmail.com> wrote:
> However I think it would make sense to sort the entries by podling
> name, rather than by name within status.
> Otherwise it will be a pain when the status changes.
>
> Also, rather than use a <website> tag, I think it would be better to
> use a tag which is the podling identity name (or whatever we call it).
> For most podlings, this is just the name in lower-case, however there
> are some exceptions that currently have to be hard-coded in clutch.py.
> It's then easier to use the value to create the website and in other cases.

Okay, so sorted by podling name, and instead of a website you'd like
an "id" field that URLs and the like would be generated from?  I can
kick that out this evening.

Would it be desirable for this to be in a database?  Does Infra run a
DBMS?  Either way, we can start with the XML.

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 7 October 2011 10:03, Christian Grobmeier <gr...@gmail.com> wrote:
> On Fri, Oct 7, 2011 at 5:25 AM, Donald Whytock <dw...@gmail.com> wrote:
>> Apologies.  Forgot the status field.
>>
>> On Thu, Oct 6, 2011 at 11:11 PM, Donald Whytock <dw...@gmail.com> wrote:
>>> Okay...attached is a very simple podlings.xml, made from the contents
>>> of the podlings page.
>>>
>>> I itemized mentors, and made start and end dates two separate fields.

That's good.

>>> However, I had to take anchors out of the descriptions.
>
> Actually looks pretty good Don thanks for doing it

Yes, thanks for doing it.

However I think it would make sense to sort the entries by podling
name, rather than by name within status.
Otherwise it will be a pain when the status changes.

Also, rather than use a <website> tag, I think it would be better to
use a tag which is the podling identity name (or whatever we call it).
For most podlings, this is just the name in lower-case, however there
are some exceptions that currently have to be hard-coded in clutch.py.
It's then easier to use the value to create the website and in other cases.

Accumulo => accumulo
OpenOffice.org => openofficeorg

> We need a good place for this. I suggest /site-author/podlings.xml

That seems OK.

> Christian
>
>>>
>>> Don
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>
>
>
> --
> http://www.grobmeier.de
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
On Fri, Oct 7, 2011 at 5:25 AM, Donald Whytock <dw...@gmail.com> wrote:
> Apologies.  Forgot the status field.
>
> On Thu, Oct 6, 2011 at 11:11 PM, Donald Whytock <dw...@gmail.com> wrote:
>> Okay...attached is a very simple podlings.xml, made from the contents
>> of the podlings page.
>>
>> I itemized mentors, and made start and end dates two separate fields.
>> However, I had to take anchors out of the descriptions.

Actually looks pretty good Don thanks for doing it

We need a good place for this. I suggest /site-author/podlings.xml

Christian

>>
>> Don
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
Apologies.  Forgot the status field.

On Thu, Oct 6, 2011 at 11:11 PM, Donald Whytock <dw...@gmail.com> wrote:
> Okay...attached is a very simple podlings.xml, made from the contents
> of the podlings page.
>
> I itemized mentors, and made start and end dates two separate fields.
> However, I had to take anchors out of the descriptions.
>
> Don
>

Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
Okay...attached is a very simple podlings.xml, made from the contents
of the podlings page.

I itemized mentors, and made start and end dates two separate fields.
However, I had to take anchors out of the descriptions.

Don

Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 6 October 2011 22:03, Donald Whytock <dw...@gmail.com> wrote:
> On Thu, Oct 6, 2011 at 6:46 AM, sebb <se...@gmail.com> wrote:
>> The registry would contain all podling names (current and previous)
>> together with state (active, dormant, graduated, retired) and other
>> basic information.
>> This would be used to generate the podling summary page(s) as well.
>
> Would said XML file then be manually edited?

Initially, yes.
But it should be easier to edit than the projects page source.

> Or could, say, a PHP app be set up for making changes to it?

Not sure it's worth the effort, as changes are not very frequent.
Might possibly be worth coding something like the DOAP form [1] to
create the initial section for a podling which could then be pasted in
place.

But the main benefit is that the registry could be used for multiple purposes:
- lists of podlings
- summary pages
- clutch

> Where would it reside?

The registry would reside in SVN somewhere near where the projects
source is currently located.

[1] http://projects.apache.org/create.html

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
On Thu, Oct 6, 2011 at 6:46 AM, sebb <se...@gmail.com> wrote:
> The registry would contain all podling names (current and previous)
> together with state (active, dormant, graduated, retired) and other
> basic information.
> This would be used to generate the podling summary page(s) as well.

Would said XML file then be manually edited?  Or could, say, a PHP app
be set up for making changes to it?  Where would it reside?

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 5 October 2011 20:06, Donald Whytock <dw...@gmail.com> wrote:
> What about storing the podling names in a table somewhere and using a
> Javascript fragment to read the table and populate the right-column
> list?  Pages that include the script therefore don't have to be
> updated at all when the podling list changes.

I like that.

It would fit in with the idea of maintaining a podling registry in an
XML file or similar.

The registry would contain all podling names (current and previous)
together with state (active, dormant, graduated, retired) and other
basic information.
This would be used to generate the podling summary page(s) as well.

> Don
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Donald Whytock <dw...@gmail.com>.
What about storing the podling names in a table somewhere and using a
Javascript fragment to read the table and populate the right-column
list?  Pages that include the script therefore don't have to be
updated at all when the podling list changes.

Don

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Christian Grobmeier <gr...@gmail.com>.
> The RH column is relatively narrow, so does not compress the main
> column too much.

Cannot agree here

> Indeed without it, the main column is too wide on my screen, making it
> more difficult to read, as the end of the line is so far from the
> beginning of the next.

I plan to work more on the layout in near future and make it more
readable (not so wide).
I just wanted to do this as first step.

> For my screen (1440x900), it would be necessary to split the main part
> into two columns to improve readability.
>
> The list of podling names-only is very easy to scan, whereas the
> summary page is hard work, and very long.
> Should probably be split into multiple pages for the different sections.

My plan is to make the table to divs and the change the size/color of
the project names (next step, because it is much work)

> If it is decided to drop the RH column, then I think it would be
> useful to have a multi-column list of the names on the home page.

+1

> But I totally agree with moving search and dropping the additional
> Thanks link; that would look a lot better.
>
> The need to update all the pages every time the list of podlings
> changes could be eliminated by using a frame or some other means.

I would prefer javascript, to be honest. Frames are so 80ties

Cheers + Thanks for the feedback

Christian

>
>> Cheers
>> Christian
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>



-- 
http://www.grobmeier.de

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by sebb <se...@gmail.com>.
On 5 October 2011 12:12, Christian Grobmeier <gr...@gmail.com> wrote:
> Hi,
>
> currently we use a three column model. On the right side is the search
> box, links to thanks page and all the projects listed. Everytime we
> add a new podling all podling pages need to be updated too.
>
> I we should remove the third (right) column, because:
> - the thanks page is already linked on the left side
> - the search box can be moved to the left side
> - a simple link to "Incubator Projects" can lead to the
> projects/index.html page, which already is cared about
>
> This will give us more space for the real content and we can play a
> little with the css (which I plan).
>
> Here is how it would look like:
>
> http://code.grobmeier.de/incubator-draft/
> http://code.grobmeier.de/incubator-draft/projects/index.html
> http://code.grobmeier.de/incubator-draft/projects/ognl.html
>
> Please let me know what you think about this change.

I quite like the 3 column layout, as it's very easy to find a specific podling.

The RH column is relatively narrow, so does not compress the main
column too much.

Indeed without it, the main column is too wide on my screen, making it
more difficult to read, as the end of the line is so far from the
beginning of the next.

For my screen (1440x900), it would be necessary to split the main part
into two columns to improve readability.

The list of podling names-only is very easy to scan, whereas the
summary page is hard work, and very long.
Should probably be split into multiple pages for the different sections.

If it is decided to drop the RH column, then I think it would be
useful to have a multi-column list of the names on the home page.

But I totally agree with moving search and dropping the additional
Thanks link; that would look a lot better.

The need to update all the pages every time the list of podlings
changes could be eliminated by using a frame or some other means.

> Cheers
> Christian
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Simone Tripodi <si...@apache.org>.
Hi Christian!
your proposal makes IMHO incubator page more clear and let eyes
"breathing" while reading the page :)
Just my 0.02 cents, all the best!
Simo

http://people.apache.org/~simonetripodi/
http://www.99soft.org/



On Wed, Oct 5, 2011 at 1:12 PM, Christian Grobmeier <gr...@gmail.com> wrote:
> Hi,
>
> currently we use a three column model. On the right side is the search
> box, links to thanks page and all the projects listed. Everytime we
> add a new podling all podling pages need to be updated too.
>
> I we should remove the third (right) column, because:
> - the thanks page is already linked on the left side
> - the search box can be moved to the left side
> - a simple link to "Incubator Projects" can lead to the
> projects/index.html page, which already is cared about
>
> This will give us more space for the real content and we can play a
> little with the css (which I plan).
>
> Here is how it would look like:
>
> http://code.grobmeier.de/incubator-draft/
> http://code.grobmeier.de/incubator-draft/projects/index.html
> http://code.grobmeier.de/incubator-draft/projects/ognl.html
>
> Please let me know what you think about this change.
>
> Cheers
> Christian
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Maurizio Cucchiara <mc...@apache.org>.
Definitely +1, it is undeniably more readable, furthermore, as you
pointed out, the update status of the other projects is out of date
and unmanageable.


Maurizio Cucchiara



On 5 October 2011 15:07, Shane Curcuru <as...@shanecurcuru.org> wrote:
> On 10/5/2011 7:12 AM, Christian Grobmeier wrote:
> ...
>>
>> Here is how it would look like:
>>
>> http://code.grobmeier.de/incubator-draft/
>> http://code.grobmeier.de/incubator-draft/projects/index.html
>> http://code.grobmeier.de/incubator-draft/projects/ognl.html
>>
>> Please let me know what you think about this change.
>
> +1, makes sense and is easier to read.
>
> - Shane
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: [DISCUSS] Layout change - remove the right table

Posted by Shane Curcuru <as...@shanecurcuru.org>.
On 10/5/2011 7:12 AM, Christian Grobmeier wrote:
...
> Here is how it would look like:
>
> http://code.grobmeier.de/incubator-draft/
> http://code.grobmeier.de/incubator-draft/projects/index.html
> http://code.grobmeier.de/incubator-draft/projects/ognl.html
>
> Please let me know what you think about this change.

+1, makes sense and is easier to read.

- Shane

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org