[hibernate-dev] Hibernate site SEO optimization

[Steve Ebersole]

I am not really sure what "have their headers patched to declare that the
new guides are the canonical version" means in practical terms...

On Wed, Dec 9, 2015 at 10:55 AM Sanne Grinovero <sanne at hibernate.org> wrote:

> On 9 December 2015 at 16:36, Steve Ebersole <steve at hibernate.org> wrote:
> > We could leave the ones that are on docs.jboss.org in place and just
> move
> > the current stable ones.  I see no benefit to moving ORM 3.2 docs over
> e.g.
>
> I'm ok to leave them there, but if we do they at least need to have
> their headers patched to declare that the new guides are the canonical
> version.
> Otherwise they might be flagged "duplicated content" as I guess many
> paragraphs didn't change much over time (or at all), and since the
> position on docs.jboss.org is much older than the copy on
> hibernate.org, that would penalize the score of hibernate.org
>
> >
> > On Wed, Dec 9, 2015 at 10:08 AM Sanne Grinovero <sanne at hibernate.org>
> wrote:
> >>
> >> On 9 December 2015 at 13:54, Hardy Ferentschik <hardy at hibernate.org>
> >> wrote:
> >> > Hi,
> >> >
> >> > On Wed, Dec 09, 2015 at 03:12:54PM +0200, Vlad Mihalcea wrote:
> >> >> Is there any change we host the docs on hibernate.org and simply
> >> >> redirect
> >> >> the old pages from
> >> >>
> >> >> http://docs.jboss.org/hibernate
> >> >>
> >> >> to
> >> >>
> >> >> http://hibernate.org/orm/documentation
> >> >
> >> > That would be an option I guess. Host the documentation somewhere
> else.
> >> > I am sure
> >> > we discussed this before, but I cannot remember the outcome.
> >>
> >> Right, this isn't new but for some reason (probably time?) we never got
> to
> >> it.
> >> I thought the outcome was that we couldn't move the docs away from the
> >> jboss.org servers, but Emmanuel just told me there's no such rule.
> >>
> >> So let's plan to move them all!
> >>
> >> I think we need:
> >>  - redirects in place from the previous location
> >>  - make/update/verify a sitemap for hibernate.org
> >>  - get the docs on hibernate.org
> >>  - insert the right metadata in the older docs so to point to the
> >> latest as their "canonical form"
> >>
> >> And like Vlad suggested, let's simply exclude from indexing all very
> >> old guides and docs which aren't easily patched to have the right
> >> pointers to their latest version (I'm thinking especially about old
> >> guides which don't have a 1:1 match).
> >>
> >> I could spend a bit of time on this during Christmas, not before.
> >>
> >> Sanne
> >>
> >> >
> >> > Regarding hibernate.org. The website is build via Awestruct from this
> >> > repo
> >> > https://github.com/hibernate/hibernate.org and pushed to GitHub Pages
> >> > for hosting.
> >> > The simplest solution would be to add the documentation to the site,
> but
> >> > that might blow up the repository too much and make syncs to
> production
> >> > too slow.
> >> >
> >> > I am not familar whether one could upload the documentation to GitHub
> >> > Pages
> >> > into a separate directory. I am not familiar on what and what not can
> be
> >> > done
> >> > here.
> >> >
> >> > Either way, the upload of new documentation needs to be scriptable,
> >> > since pretty
> >> > much all Hibernate projects have a script of some form to upload the
> >> > documentation
> >> > of a release to documentation server.
> >> >
> >> > --Hardy
> >> >
>