[hibernate-dev] Minor issues/questions about Hibernate Core/ORM documentation

[Gail Badner]

In case you missed my message...

I've kept http://docs.jboss.org/hibernate/core/ as is with 4.0.1.Final documentation and:
- added a symbolic link for http://docs.jboss.org/hibernate/orm/ that points to http://docs.jboss.org/hibernate/core/
- updated the symbolic link for http://docs.jboss.org/hibernate/stable/core/ to point to http://docs.jboss.org/hibernate/core/4.0/
- added a symbolic link http://docs.jboss.org/hibernate/stable/orm/ that points to http://docs.jboss.org/hibernate/stable/core/

Steve, are you thinking that the hem doc will be merged into main docs for 4.0.2 or for 4.1?

Regards,
Gail


----- Original Message -----
> From: "Steve Ebersole" <steve at hibernate.org>
> To: "Hardy Ferentschik" <hardy at hibernate.org>
> Cc: "Hibernate" <hibernate-dev at lists.jboss.org>
> Sent: Friday, January 13, 2012 5:07:42 AM
> Subject: Re: [hibernate-dev] Minor issues/questions about Hibernate Core/ORM documentation
> 
> 
> On 01/13/2012 01:58 AM, Hardy Ferentschik wrote:
> >>
> >> I agree, we should do a redirect.  I had not planned on changing
> >> the physical dir until 4.1 as that is when the new docs would be
> >> getting used.  6 in one... if you feel the itch, go for it.
> >
> > Changing the directory name is easy. For the redirects we will need
> > "service desk" to give us a hand (afaik).
> 
> If we use redirects specifically, yeah.  The other option is to use
> symlinks.
> 
> 
> > Speaking of re-directs, I thought I change the stable link, but
> > realized that we might need some more redirects.
> > Currently the main URL looks like this:
> >
> > http://docs.jboss.org/hibernate/stable/core/reference/en-US/html_single/
> >
> > In 4.0 the main docs are in 'manual' so the URL would be
> >
> > http://docs.jboss.org/hibernate/stable/core/manual/en-US/html_single/
> >
> > Do we want to stick with 'manual'? If so we might want to consider
> > another redirect. Or we just
> > rename manual to reference. Was the directory rename intentional?
> 
> Well we currently have 4 docs uploaded.  That needs to get whittled
> down
> to 2.  'manual' specifically points to doc that will be going away.
>  I
> think for "stable", we are only ever really going to be able to
> guarantee up to that point in the path in terms of book-marking.
> Anything else "below" that is too dependent on the specific versions.
> In fact we maybe want(ed) "current" instead of "stable"
> 
> The other thing I noticed is core/orm.  This rename is creeping up in
> a
> lot of places ;)
> 
> 
> --
> steve at hibernate.org
> http://hibernate.org
> _______________________________________________
> hibernate-dev mailing list
> hibernate-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hibernate-dev
>