Re: [hibernate-dev] People can't find our docs

2016-07-27 Thread Vlad Mihalcea
Great news! On Wed, Jul 27, 2016 at 9:56 AM, Davide D'Alto wrote: > Great :) > > now I need to do the same with hibernate.org. > > > On Tue, Jul 26, 2016 at 7:03 PM, Sanne Grinovero > wrote: > > The SEO expert liked the results :) > > > > On 22 July 2016 at 17:33, Emmanuel Bernard > wrote: > >

Re: [hibernate-dev] People can't find our docs

2016-07-26 Thread Davide D'Alto
Great :) now I need to do the same with hibernate.org. On Tue, Jul 26, 2016 at 7:03 PM, Sanne Grinovero wrote: > The SEO expert liked the results :) > > On 22 July 2016 at 17:33, Emmanuel Bernard wrote: >> Hibernate is fine. >> >> On Fri 2016-07-22 16:57, Davide D'Alto wrote: >>> I've updated

Re: [hibernate-dev] People can't find our docs

2016-07-26 Thread Sanne Grinovero
The SEO expert liked the results :) On 22 July 2016 at 17:33, Emmanuel Bernard wrote: > Hibernate is fine. > > On Fri 2016-07-22 16:57, Davide D'Alto wrote: >> I've updated the microdata on our blog. >> I used the google validation page to check the result: >> https://search.google.com/structure

Re: [hibernate-dev] People can't find our docs

2016-07-22 Thread Emmanuel Bernard
Hibernate is fine. On Fri 2016-07-22 16:57, Davide D'Alto wrote: > I've updated the microdata on our blog. > I used the google validation page to check the result: > https://search.google.com/structured-data/testing-tool/u/0/?hl=EN#url=http%3A%2F%2Fin.relation.to%2F > > I'm not familiar with mic

Re: [hibernate-dev] People can't find our docs

2016-07-22 Thread Davide D'Alto
I've updated the microdata on our blog. I used the google validation page to check the result: https://search.google.com/structured-data/testing-tool/u/0/?hl=EN#url=http%3A%2F%2Fin.relation.to%2F I'm not familiar with microdata, if you think that something is wrong let me know. I have a question

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Guillaume Smet
On Thu, Jul 21, 2016 at 3:06 PM, Sanne Grinovero wrote: > Maybe we could move that to the website, as similar metadata is > already being deployed, e.g. > - > https://github.com/hibernate/hibernate.org/tree/staging/_data/projects/search/releases We already need to update the /stable/ symlink on

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Sanne Grinovero
On 21 July 2016 at 13:52, Davide D'Alto wrote: > It should be easy for OGM, you need to update this file: > https://github.com/hibernate/hibernate-ogm/blob/master/src/main/release-scripts/upload-documentation.sh +1, no problems for Search either. It's not scripted yet, so I'll just need clear ins

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Davide D'Alto
It should be easy for OGM, you need to update this file: https://github.com/hibernate/hibernate-ogm/blob/master/src/main/release-scripts/upload-documentation.sh On Thu, Jul 21, 2016 at 1:46 PM, Guillaume Smet wrote: > @Davide, @Sanne: would it be an issue to include the sed lines in our > release

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Steve Ebersole
On Thu, Jul 21, 2016 at 6:36 AM Guillaume Smet wrote: > > @ORM: interested in me pursuing this for ORM too? It will probably be > a lot more work as the structure of the docs got changed a lot. > I would definitely be interested in a solution that finally allows us to fix this. If you are willi

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Guillaume Smet
@Davide, @Sanne: would it be an issue to include the sed lines in our release process to prepare the docs before uploading them to the doc server? If it's not, it's probably the best solution. I'll wait for your confirmation before polishing them. On Thu, Jul 21, 2016 at 2:38 PM, Emmanuel Bernard

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Emmanuel Bernard
On Thu 2016-07-21 14:20, Guillaume Smet wrote: > On Thu, Jul 21, 2016 at 2:07 PM, Emmanuel Bernard > wrote: > > Should we add a X or I got it button to remove this nagging when I have > > to read and stay on the old doc? > > I thought about it but I don't find it that invasive that we need to > a

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Guillaume Smet
On Thu, Jul 21, 2016 at 2:07 PM, Emmanuel Bernard wrote: > Should we add a X or I got it button to remove this nagging when I have > to read and stay on the old doc? I thought about it but I don't find it that invasive that we need to add a close button. But I can do it if people think it's neede

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Emmanuel Bernard
Nice, Should we add a X or I got it button to remove this nagging when I have to read and stay on the old doc? If that piece of code is in the xsl, how will it work when the doc is in the distribution? How screwed are you if we stop using these stylesheet and say embrace the Asciidoctor default

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Guillaume Smet
Iiiik, remove the .local suffix in the domain for the first example! On Thu, Jul 21, 2016 at 1:33 PM, Guillaume Smet wrote: > Hi all! > > So here is a status of what I did: > - I updated the /stable/ link of ogm from 3.0 (cough, cough) to 5.0: > http://docs.jboss.org/hibernate/stable/ogm/referenc

Re: [hibernate-dev] People can't find our docs

2016-07-21 Thread Guillaume Smet
Hi all! So here is a status of what I did: - I updated the /stable/ link of ogm from 3.0 (cough, cough) to 5.0: http://docs.jboss.org/hibernate/stable/ogm/reference/en-US/html/: we need to include this in our release process. - I updated the /current/ symlink of ORM to point to 5.2 instead of 5.1:

Re: [hibernate-dev] People can't find our docs

2016-07-20 Thread Davide D'Alto
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 jQ

Re: [hibernate-dev] People can't find our docs

2016-07-19 Thread Guillaume Smet
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 b

Re: [hibernate-dev] People can't find our docs

2016-07-19 Thread Guillaume Smet
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 b

Re: [hibernate-dev] People can't find our docs

2016-07-19 Thread Sanne Grinovero
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 exampl