Michael Baessler wrote: > Some time ago we discussed another way to access the current "trunk" version > of the documentation. > For some projects this was already enabled, but it seems that it never works > :-( > > We agreed to check-in the current pdf version of the documentation for a > component and link this > file directly in the Sandbox description. This was done for example for the > RegexAnnotator, > DictionaryAnnotator, SimpleServer, ... > > Not sure if we need both ways, I don't think so. So I'm fine with Marshall's > suggestion but in that > case we should remove the old links that for some reasons are broken for some > components. > > -- Michael > > Marshall Schor wrote: >> I plan to make a modification to the web-site to host all the sandbox >> documentation, similar to how we host the base UIMA documentation. Any >> objections? >> >> In preparation for this I'll be updating the builds for the sandbox >> documentation to update a directory in the uima-website project. I plan >> to add a directory named >> uima-website/docs/downloads/next-release/sandbox/<artifactId>. >> >> After the release is approved, we can move the stuff in next-release to >> the current place: uima-website/docs/downloads/sandbox/<artifactId>. >> >> The website will only host the "current" release. People wanting older >> ones, can always download the distribution. >> >> -Marshall
+1 to Marshall's plan in principle. I think one reason we created this special sandbox documentation that Michael refers to is that we have sandbox projects that have not seen a release yet; but we still want people to be able to get to the documentation so we can possibly get early adopters and feedback. What's your thought on that issue? Create a subsection for non-released sandbox artifacts, where we follow the "link to checked in docs" procedure that Michael is alluding to? --Thilo
