I used the javadocs and reference from http://docs.jboss.org/hibernate/orm/3.5/ to generate redirects for:

• hib_docs/reference
• hib_docs/v3/reference
• hib_docs/v3/api

To do so I did first create a link list of reference and api and then used some command line tools to generate the yml files. Here is what I did (we might want to do this for entitymanager and annotations as well, but I am not sure which version we should use):

# get a list of links for a given part of the docs using httrack
> httrack -p0 -d http://docs.jboss.org/hibernate/orm/3.5/javadocs/

# use a command pipeline to generate the yml file
> awk '{ print $9 }' hts-cache/new.txt | grep "http://docs.jboss.org/hibernate/orm/3.5/reference" | grep -v "\?" | sort | uniq | sed -e 's@http://docs.jboss.org/hibernate/orm/3.5/reference\(.*\)$@hib_docs/v3/reference\1: http://docs.jboss.org/hibernate/orm/3.5/reference\1@g'