As Emmanuel mentioned, we are currently only publishing the docs for GA releases. We used to have also the beta docs online, but stopped that due to the way the different docs would get indexed by Google.
I agree with Sanne that we should upload the documentation for the beta releases. http://docs.jboss.org/hibernate/project/version works fine with me. Btw, Lucene also publishes multiple versions of their docs. Mind you, with Lucene I had actually cases were I needed some extra clicks and searching to get to the right version of the docs. One idea to solve the indexing problem would be to work with robots.txt. We could just disallow all beta documentations from indexing. This way only the latest GA release would be "searchable". For the beta docs we just provide some links from search.hibernate.org. There is already a robots file under http://www.jboss.org/robots.txt, but I am not sure how feasible it is with our current processes to get this file changed. Unfortunately, robots.txt does not allow wildcards or regular expressions, so we would have to explicitly exclude the versions we don't want to have indexed. Another problem with the documentation was that https://www.hibernate.org/5.html is complicated enough even without adding links to beta release docs. The good news is that with the new site (out soon hopefully) we will have a dedicated documentation page for Search where it would be much easier to provide some additional links. Regarding automated doc uploads - the first step here would be to actually get developer access to http://docs.jboss.org via ssh or similar. Unfortunately, that's not in place yet. --Hardy On Fri, 05 Mar 2010 07:13:36 -0300, Sanne Grinovero <sanne.grinov...@gmail.com> wrote: > I like http://docs.jboss.org/hibernate/project/version > most, as I guess I could browse available versions at > http://docs.jboss.org/hibernate/project/ > and see which modules do exist under http://docs.jboss.org/hibernate/ > > and so I'd vote for http://docs.jboss.org/hibernate/search/3.2.0-BETA1 > but have no strong feelings about it, just my 2c. > > About the docs, I was not thinking about the "trunk" releases of docs, > but the beta releases would be usefull; btw so you beta test the full > release cycle and maybe automate the documentation upload steps in > future. > > 2010/3/5 Emmanuel Bernard <emman...@hibernate.org>: >> That reminds me, I don't think we ever settled on the doc scheme >> http://docs.jboss.org/hibernate/stable/project >> vs >> http://docs.jboss.org/hibernate/project/version >> >> On 5 mars 2010, at 11:00, Emmanuel Bernard wrote: >> >>> They have never been published AFAIK, we tend to not publish docs on >>> non final. They are bundled in the distro though. >>> >>> We could change that provided we think it's useful and define some >>> publication scheme: >>> - http://docs.jboss.org/hibernate/search/x.y.z for stable versions >>> - http://docs.jboss.org/hibernate/search/trunk for the latest non >>> final version >>> >>> Thoughts? >>> >>> What I personally don't love with this approach is that google know >>> nothing about stable versus trunk works and don't favorite one over >>> the other. >>> >>> On 5 mars 2010, at 10:51, Sanne Grinovero wrote: >>> >>>> yes we're missing the docs of 3.2-beta >>>> There are questions on programmatic mapping API for example >>>> https://forum.hibernate.org/viewtopic.php?f=9&t=1003036 >>>> >>>> Sanne >>>> >>>> 2010/3/5 Emmanuel Bernard <emman...@hibernate.org>: >>>>> The docs lives in >>>>> http://docs.jboss.org/hibernate/stable/search/reference/en/html_single/ >>>>> http://docs.jboss.org/hibernate/stable/search/reference/en/ >>>>> >>>>> And the link is here https://www.hibernate.org/5.html#A21 >>>>> >>>>> Am I missing something? >>>>> >>>>> On 5 mars 2010, at 10:26, Sanne Grinovero wrote: >>>>> >>>>>> Hello, >>>>>> I am seeing an increasing rate of questions on the Search forum >>>>>> about >>>>>> well documented stuff; >>>>>> I just noticed that I can't point them to the documentation is it's >>>>>> not there. >>>>>> >>>>>> I could edit the wiki myself to add some URL, but I can't find out >>>>>> the >>>>>> missing link either as it's all redirecting now to jboss.org, >>>>>> and it appears to be missing. >>>>>> >>>>>> could someone look into this? >>>>>> >>>>>> Thanks, >>>>>> Sanne _______________________________________________ hibernate-dev mailing list hibernate-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev
