From davide at hibernate.org Wed Jul 20 06:06:37 2016 Content-Type: multipart/mixed; boundary="===============6552215852451760285==" MIME-Version: 1.0 From: Davide D'Alto To: hibernate-dev at lists.jboss.org Subject: Re: [hibernate-dev] People can't find our docs Date: Wed, 20 Jul 2016 11:06:16 +0100 Message-ID: In-Reply-To: CALt0+o9hA+aQ1feyLVf=+aB=4NMtJe8E2tGCjDJOae63MRS5AA@mail.gmail.com --===============6552215852451760285== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable I'll try to apply these changes on Friday. Davide On Tue, Jul 19, 2016 at 11:53 PM, Guillaume Smet wrote: > Hi Sanne, > > Thanks for your feedback. I was pretty sure I hadn't all the history! > > Getting Google to prioritize our latest doc is probably a long time goal. > > I played a bit with jQuery to suggest to the user to go to the latest > stable. Note that I only took into consideration the page for the time > being and didn't consider the anchor but it should be easy to add it > if we think it's worth it (it's a lot more work on the json descriptor > though). > > The following command for each version is all that is needed: > sed -i 's@@@' *.html > (or a find -exec to do it on all the versions at once) > > I attached the global json descriptor and the js file (with a .txt > extension as it didn't pass the mail filter). Both should be added to > /hibernate/search/. Note that I only did the work for version 4.5 in > the json descriptor. The work for other versions would mostly be a > copy/paste. > > I also attached a screenshot of how it looks like. Nothing fancy but > we can do whatever we want. > > Note that I only targeted the multi page HTML output as it was the > most interesting to prototype. > > When we release a new version, we would have to update the descriptor fil= e. > > Comments? > > -- > Guillaume > > On Tue, Jul 19, 2016 at 2:39 PM, Sanne Grinovero = wrote: >> Hi Guillaume, >> >> yes I'm aware of the issue; we discussed it before, I think on this >> same mailing list but maybe it was during our last meeting. >> >> We really need to fix that metadata; Stefania (my partner) is an SEO >> consultant and is shocked at how bad we do with this; apparently we >> are a funny example in her office but at least we're not the worst :) >> >> The problem is we can't change the headers as we don't control the >> Apache httpd configuraion on the documentation server, so the >> alternative is we'd need to rsync those docs locally, insert the right >> changes in the static files of the docs, and push them back. >> >> Needs a volunteer to find some time for this. >> >> Also related to SEO I recently opened some issues on our WEBSITE >> project, these should be easier to fix as it's directly under our >> control: >> - https://hibernate.atlassian.net/browse/WEBSITE-461 >> - https://hibernate.atlassian.net/browse/WEBSITE-460 >> - https://hibernate.atlassian.net/browse/WEBSITE-459 >> >> I've assigned them to Davide as he's usually quick with such things >> but anyone is welcome to take some. >> >> The metadata issue on the docs server is probably the most urgent / >> valuable though. >> >> Thanks, >> Sanne > > _______________________________________________ > hibernate-dev mailing list > hibernate-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/hibernate-dev --===============6552215852451760285==--