You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hc.apache.org by sebb <se...@gmail.com> on 2011/09/01 14:09:36 UTC

Duplicate mailing list pages

We have a general mailing list page [1], but we also generate
individual pages for each project [2].

The general page is very thorough, but does not contain a summary of
the lists and archives etc.
The individual pages have a neat summary, but don't include the
necessary information regarding posting etiquette etc.

So I think it would be helpful to users if we tidy this up.

It's now possible to customise Maven info reports, including the
mailing list page [3], so it is now possible to add more information
to the individual reports; for example I created a sample mail-list
page at:

http://people.apache.org/~sebb/hc/mail-lists.html

Unfortunately, it seems to be quite complicated to use the same
properties file for all modules, so this would involve adding the same
file to each project. [Tedious initially, and tedious to maintain, but
hopefully that would not be a frequent occurrence once the
wording/layout is agreed initially.]

Alternatively, we can just drop the auto-generated mail pages, which
all have the same body content anyway (I think).  If we do that, we
should probably add a table like the one from the generated page [2]
to the end of [1]

Thoughts?

[1] http://hc.apache.org/mail.html
[2] http://hc.apache.org/mail-lists.html
[3] http://maven.apache.org/plugins/maven-project-info-reports-plugin/examples/custom-report.html

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


Re: Duplicate mailing list pages

Posted by Oleg Kalnichevski <ol...@apache.org>.
On Thu, 2011-09-01 at 13:56 +0100, sebb wrote:
> On 1 September 2011 13:40, Oleg Kalnichevski <ol...@apache.org> wrote:
> > On Thu, 2011-09-01 at 13:09 +0100, sebb wrote:
> >> We have a general mailing list page [1], but we also generate
> >> individual pages for each project [2].
> >>
> >> The general page is very thorough, but does not contain a summary of
> >> the lists and archives etc.
> >> The individual pages have a neat summary, but don't include the
> >> necessary information regarding posting etiquette etc.
> >>
> >> So I think it would be helpful to users if we tidy this up.
> >>
> >> It's now possible to customise Maven info reports, including the
> >> mailing list page [3], so it is now possible to add more information
> >> to the individual reports; for example I created a sample mail-list
> >> page at:
> >>
> >> http://people.apache.org/~sebb/hc/mail-lists.html
> >>
> >
> > Looks really good!
> 
> Not all my own work - I just adapted the example.
> 
> >
> >> Unfortunately, it seems to be quite complicated to use the same
> >> properties file for all modules, so this would involve adding the same
> >> file to each project. [Tedious initially, and tedious to maintain, but
> >> hopefully that would not be a frequent occurrence once the
> >> wording/layout is agreed initially.]
> >>
> >> Alternatively, we can just drop the auto-generated mail pages, which
> >> all have the same body content anyway (I think).  If we do that, we
> >> should probably add a table like the one from the generated page [2]
> >> to the end of [1]
> >>
> >> Thoughts?
> >>
> >
> > How about just manually creating symlinks in all modules to one master
> > file residing at the project top level?
> 
> Wouldn't these get lost when redeploying the site?
> And if we drop the report from sub-modules then the link will
> disappear from the navigation.
> 
> We already have a master file at top-level which is in all the menus.
> 

It was just a thought. Feel free to implement whatever solution you deem
most appropriate and you have time for. I will not be of much help until
I am done with the next releases of HttpCore, HttpAsyncClient and
HttpClient.

Cheers

Oleg



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


Re: Duplicate mailing list pages

Posted by sebb <se...@gmail.com>.
On 1 September 2011 13:40, Oleg Kalnichevski <ol...@apache.org> wrote:
> On Thu, 2011-09-01 at 13:09 +0100, sebb wrote:
>> We have a general mailing list page [1], but we also generate
>> individual pages for each project [2].
>>
>> The general page is very thorough, but does not contain a summary of
>> the lists and archives etc.
>> The individual pages have a neat summary, but don't include the
>> necessary information regarding posting etiquette etc.
>>
>> So I think it would be helpful to users if we tidy this up.
>>
>> It's now possible to customise Maven info reports, including the
>> mailing list page [3], so it is now possible to add more information
>> to the individual reports; for example I created a sample mail-list
>> page at:
>>
>> http://people.apache.org/~sebb/hc/mail-lists.html
>>
>
> Looks really good!

Not all my own work - I just adapted the example.

>
>> Unfortunately, it seems to be quite complicated to use the same
>> properties file for all modules, so this would involve adding the same
>> file to each project. [Tedious initially, and tedious to maintain, but
>> hopefully that would not be a frequent occurrence once the
>> wording/layout is agreed initially.]
>>
>> Alternatively, we can just drop the auto-generated mail pages, which
>> all have the same body content anyway (I think).  If we do that, we
>> should probably add a table like the one from the generated page [2]
>> to the end of [1]
>>
>> Thoughts?
>>
>
> How about just manually creating symlinks in all modules to one master
> file residing at the project top level?

Wouldn't these get lost when redeploying the site?
And if we drop the report from sub-modules then the link will
disappear from the navigation.

We already have a master file at top-level which is in all the menus.

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

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


Re: Duplicate mailing list pages

Posted by Oleg Kalnichevski <ol...@apache.org>.
On Thu, 2011-09-01 at 13:09 +0100, sebb wrote:
> We have a general mailing list page [1], but we also generate
> individual pages for each project [2].
> 
> The general page is very thorough, but does not contain a summary of
> the lists and archives etc.
> The individual pages have a neat summary, but don't include the
> necessary information regarding posting etiquette etc.
> 
> So I think it would be helpful to users if we tidy this up.
> 
> It's now possible to customise Maven info reports, including the
> mailing list page [3], so it is now possible to add more information
> to the individual reports; for example I created a sample mail-list
> page at:
> 
> http://people.apache.org/~sebb/hc/mail-lists.html
> 

Looks really good!


> Unfortunately, it seems to be quite complicated to use the same
> properties file for all modules, so this would involve adding the same
> file to each project. [Tedious initially, and tedious to maintain, but
> hopefully that would not be a frequent occurrence once the
> wording/layout is agreed initially.]
> 
> Alternatively, we can just drop the auto-generated mail pages, which
> all have the same body content anyway (I think).  If we do that, we
> should probably add a table like the one from the generated page [2]
> to the end of [1]
> 
> Thoughts?
> 

How about just manually creating symlinks in all modules to one master
file residing at the project top level?

Oleg 



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