commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Benedikt Ritter <benerit...@gmail.com>
Subject Re: svn commit: r1491175 - /commons/proper/csv/trunk/pom.xml
Date Mon, 10 Jun 2013 20:32:50 GMT
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 ;-)
An alternative would be to raise an issue to change the default settings of the project info
reports plugin.

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


Mime
View raw message