yes, major.minor is good enough, you are right. For trunk, I was not really planning on a nightly build. I was more thinking of (manually) pushing the docs as they are in the project trunk if there is a noticeable difference with the latest stable. But as Sanne said, he is more interested in pushing docs for beta / cr versions, not necessarily what's in trunk.
On 5 mars 2010, at 20:55, Steve Ebersole wrote: > Wrt https://www.hibernate.org/5.html.. the plan is to eventually use > index pages on docs.jboss.org/hibernate. We have not to date simply > because its way too difficult managing resource on that site. > > Yes i would like to see is just the most recent docs indexed. No clue > how/if possible. > > WRT the suggestion to use x.y.z I think we should be careful here. I do > not see benefit from keeping, say, 3.2.3, 3.2.4, 3.2.5, 3.2.6, 3.2.7 > docs all around. IMO 3.2 is enough (latest 3.2 docs). > > What is the thought process of /trunk ? Nightly builds? Perhaps we > could do that just in english? The build jobs already take long enough. > Maybe even just english/html or english/html_single. > > > On 03/05/2010 05:46 AM, Hardy Ferentschik wrote: >> 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 > > -- > st...@hibernate.org > http://hibernate.org > _______________________________________________ > hibernate-dev mailing list > hibernate-dev@lists.jboss.org > https://lists.jboss.org/mailman/listinfo/hibernate-dev _______________________________________________ hibernate-dev mailing list hibernate-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev
