On 27/07/2014 15:15, Phil Steitz wrote: > On Sun, Jul 27, 2014 at 4:24 AM, sebb <[email protected]> wrote: > >> On 26 July 2014 19:09, Phil Steitz <[email protected]> wrote: >>> >>> >>>> On Jul 26, 2014, at 6:16 AM, Gary Gregory <[email protected]> >> wrote: >>>> >>>> OK, so do we want: >>>> >>>> - Always have the release site be the "main" site. >>>> - Optionally have a separate SNAPSHOT site. >>>> >>>> Do we put this magic in commons-parent? >>> >>> I prefer the opposite - site is current dev. >> >> That is of little use to end users. >> > > I think it is important that the site shows what is going on in the project > - that is *current dev*. As long as end users can get the latest release > easily and the latest javadoc is linked, their needs are met and more > importantly if we keep the site up to date they can see *where the project > is going*. I guess I see the site as more a *project site* rather than > an archive. Our "end users" are developers and we want to encourage them > to get involved via the web sites.
I disagree. I suspect most users go to the web site looking for information on how to use the (hopefully current) version of the software they are using. Having the docs for the next version causes confusion when the docs refer to a feature that is only on trunk. > That means putting documentation on the > latest, greatest, not-yet-released stuff up for them to look at. There is a place for that sort of information as well. Taking Tomcat as an example, the web site has the docs for the latest releases but we also have links to the CI system that builds the docs as part of the CI builds so we can point folks to the bleeding edge docs if necessary. > I would > not be opposed to publishing a commons archive site somewhere if someone > wants to scratch that itch; but the component sites should not try to be > that, IMO. I don't think we need to provide the docs for every release but I do think docs for the latest release are more useful than docs for the current trunk. Of course, the more frequently we release, the smaller the delta anyway. Mark --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
