commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: [SITE] Changing contents of project info pages (was: Re: svn commit: r1491175 - /commons/proper/csv/trunk/pom.xml)
Date Tue, 11 Jun 2013 10:56:24 GMT
On 11 June 2013 11:34, Benedikt Ritter <britter@apache.org> wrote:
> 2013/6/10 sebb <sebbaz@gmail.com>
>
>> On 10 June 2013 21:32, Benedikt Ritter <beneritter@gmail.com> wrote:
>> > Hey Sebb,
>> >
>> > Am 10.06.2013 um 21:31 schrieb sebb <sebbaz@gmail.com>:
>> >
>> >> On 9 June 2013 16:12, Benedikt Ritter <beneritter@gmail.com> wrote:
>> >>> Hello sebb,
>> >>>
>> >>> Am 09.06.2013 um 16:38 schrieb sebb <sebbaz@gmail.com>:
>> >>>
>> >>>> On 9 June 2013 11:18,  <britter@apache.org> wrote:
>> >>>>> Author: britter
>> >>>>> Date: Sun Jun  9 10:18:42 2013
>> >>>>> New Revision: 1491175
>> >>>>>
>> >>>>> URL: http://svn.apache.org/r1491175
>> >>>>> Log:
>> >>>>> Use viewvc instead of raw svn url
>> >>>>
>> >>>> How is the url used by plugins?
>> >>>>
>> >>>> Will using the viewvc URL mislead users into thinking they can
>> >>>> download the source from there using SVN?
>> >>>>
>> >>>> There are regular emails on the infra mailing lists where people
>> >>>> complain they cannot use the viewwc URL with svn.
>> >>>>
>> >>>> I suspect changing it may cause more issues than it resolves.
>> >>>
>> >>> This is the config that is used for example in [LANG]. It will cause
>> the Source Repository page to contain the viewvc link under the web access
>> section.
>> >>
>> >> Yes, I understand that.
>> >>
>> >>> The other sections on that page use the information from <connection>
>> and <developerConnection>
>> >>> There should not be any problems if users read the web site carefully…
>> >>
>> >> Sadly, that is often not the case... (otherwise the RTFM acronym would
>> >> not exist!)
>> >>
>> >> And even if they do, it's not made particularly obvious that the URL
>> >> is not suitable for SVN client access.
>> >>
>> >> The section says:
>> >>
>> >> "The following is a link to the online source repository." - that
>> >> could equally apply to SVN clients.
>> >>
>> >> The section header says "Web access" but "Web" does not always mean
>> >> HTTP(S); it's often used loosely to mean Internet.
>> >>
>> >> The fixed page text really ought to be clarified.
>> >
>> > I've done some research and I learned that the content of the Source
>> Repositories page is generated by the maven project info reports plugin [1].
>> > There is a HowTo on how to customize the static texts of the pages
>> generated by the plugin [2].
>> > I don't feel that it's necessary to do the customizing, because a lot of
>> the other proper components use the same default config of the plugin. For
>> the time I'm registered on the ML (which is quiet short, tbh) there has
>> never been a request from users about broken SVN links as far as I can
>> remember.
>> >
>> > But if you have the feeling that the information on our web sites is
>> insufficient, feel free to change this for CSV and all the other components
>> ;-)
>>
>> The docs only mention customisation via a file local to each build.
>> That would be extremely tedious for Commons.
>>
>> Is there a way to define the bundle in the parent somehow?
>>
>
> I don't know for sure, but think that is not possible.

I raised a JIRA to request it as enhancement; if the feature already
exists then the JIRA can be converted into a documentation omission!

> I've moved this discussion to a new topic, maybe one of the others has an idea...

Good idea.


>>
>> > An alternative would be to raise an issue to change the default settings
>> of the project info reports plugin.
>>
>> Yes, but that could take months or years to find its way into a release.
>>
>
> The mills of ASF grind slowly ;-) But I don't see a better solution.

Particularly some Maven plugins.
I've raised the JIRAs anyway.

> We could revert the commit, but that would imply to change all components
> websites to point to the raw svn URL in <url> tag.

I see that most poms already use the viewvc URL.
It's certainly useful to have that available.

So maybe a temporary solution is to copy the properties file to every component.

>
>>
>> > Benedikt
>> >
>> > [1] http://maven.apache.org/plugins/maven-project-info-reports-plugin/
>> > [2]
>> http://maven.apache.org/plugins/maven-project-info-reports-plugin/examples/custom-report.html
>> >
>> >>
>> >>> Benedikt
>> >>>
>> >>>>
>> >>>>> Modified:
>> >>>>>   commons/proper/csv/trunk/pom.xml
>> >>>>>
>> >>>>> Modified: commons/proper/csv/trunk/pom.xml
>> >>>>> URL:
>> http://svn.apache.org/viewvc/commons/proper/csv/trunk/pom.xml?rev=1491175&r1=1491174&r2=1491175&view=diff
>> >>>>>
>> ==============================================================================
>> >>>>> --- commons/proper/csv/trunk/pom.xml (original)
>> >>>>> +++ commons/proper/csv/trunk/pom.xml Sun Jun  9 10:18:42 2013
>> >>>>> @@ -94,7 +94,7 @@ CSV files of various types.
>> >>>>>  <scm>
>> >>>>>    <connection>scm:svn:
>> http://svn.apache.org/repos/asf/commons/proper/csv/trunk</connection>
>> >>>>>    <developerConnection>scm:svn:
>> https://svn.apache.org/repos/asf/commons/proper/csv/trunk
>> </developerConnection>
>> >>>>> -    <url>http://svn.apache.org/repos/asf/commons/proper/csv/trunk
>> </url>
>> >>>>> +    <url>http://svn.apache.org/viewvc/commons/proper/csv/trunk
>> </url>
>> >>>>>  </scm>
>> >>>>>
>> >>>>>  <issueManagement>
>> >>>>>
>> >>>>>
>> >>>>
>> >>>> ---------------------------------------------------------------------
>> >>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> >>>> For additional commands, e-mail: dev-help@commons.apache.org
>> >>>>
>> >>>
>> >>>
>> >>> ---------------------------------------------------------------------
>> >>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> >>> For additional commands, e-mail: dev-help@commons.apache.org
>> >>>
>> >>
>> >> ---------------------------------------------------------------------
>> >> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> >> For additional commands, e-mail: dev-help@commons.apache.org
>> >>
>> >
>> >
>> > ---------------------------------------------------------------------
>> > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> > For additional commands, e-mail: dev-help@commons.apache.org
>> >
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>
>
> --
> http://people.apache.org/~britter/
> http://www.systemoutprintln.de/
> http://twitter.com/BenediktRitter
> http://github.com/britter

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


Mime
View raw message