commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Benedikt Ritter <brit...@apache.org>
Subject [SITE] Changing contents of project info pages (was: Re: svn commit: r1491175 - /commons/proper/csv/trunk/pom.xml)
Date Tue, 11 Jun 2013 10:34:48 GMT
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've moved this
discussion to a new topic, maybe one of the others has an 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.

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


>
> > 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

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message