How did Numpy get its latest version of the documentation to appear at the top of Google search results?

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

How did Numpy get its latest version of the documentation to appear at the top of Google search results?

efremdan1
I'm working with Bokeh (https://docs.bokeh.org/en/latest/), another
open-source Python package. The developers would like to have the latest
version of their documentation appear at the top of Google search results
when users search for information, but knowledge of how to do this is
lacking.

I've noticed that Numpy seems to have gotten this problem figured out, e.g.,
googling "numpy interpolate" results in the first hit being
https://numpy.org/doc/stable/reference/generated/numpy.interp.html. This is
unlike Python itself, where googling "python string formatting" results in
the first hit being https://docs.python.org/3.4/library/string.html.

So apparently someone in the Numpy developer world knows how to setup the
doc pages in a manner that allows for this. Would that person be willing to
post to the Bokeh message board on the topic
(https://discourse.bokeh.org/t/some-unsolicited-feedback/6643/17) with some
advice?

Thank you!



--
Sent from: http://numpy-discussion.10968.n7.nabble.com/
_______________________________________________
NumPy-Discussion mailing list
[hidden email]
https://mail.python.org/mailman/listinfo/numpy-discussion
Reply | Threaded
Open this post in threaded view
|

Re: How did Numpy get its latest version of the documentation to appear at the top of Google search results?

Ilhan Polat
Have a look at here for "some" background https://github.com/scipy/docs.scipy.org/issues/39

On Fri, Nov 13, 2020 at 5:37 PM efremdan1 <[hidden email]> wrote:
I'm working with Bokeh (https://docs.bokeh.org/en/latest/), another
open-source Python package. The developers would like to have the latest
version of their documentation appear at the top of Google search results
when users search for information, but knowledge of how to do this is
lacking.

I've noticed that Numpy seems to have gotten this problem figured out, e.g.,
googling "numpy interpolate" results in the first hit being
https://numpy.org/doc/stable/reference/generated/numpy.interp.html. This is
unlike Python itself, where googling "python string formatting" results in
the first hit being https://docs.python.org/3.4/library/string.html.

So apparently someone in the Numpy developer world knows how to setup the
doc pages in a manner that allows for this. Would that person be willing to
post to the Bokeh message board on the topic
(https://discourse.bokeh.org/t/some-unsolicited-feedback/6643/17) with some
advice?

Thank you!



--
Sent from: http://numpy-discussion.10968.n7.nabble.com/
_______________________________________________
NumPy-Discussion mailing list
[hidden email]
https://mail.python.org/mailman/listinfo/numpy-discussion

_______________________________________________
NumPy-Discussion mailing list
[hidden email]
https://mail.python.org/mailman/listinfo/numpy-discussion
Reply | Threaded
Open this post in threaded view
|

Re: How did Numpy get its latest version of the documentation to appear at the top of Google search results?

bashtage
In reply to this post by efremdan1

I’m not sure if NumPy got these in place, but you could add a canonical link to each page that has

 

<link rel="canonical" href="https://docs.bokeh.org/en/latest/{MODULE}/{SUBMODULE}/{FUNCTION}.html" />

 

If your pages.  Would require some sphinx mods to your theme.

 

This would tell all search engines that they should refer to the latest as the authoritative page for competing pages.

 

See https://yoast.com/rel-canonical/

 

Kevin

 

 

 

From: [hidden email]
Sent: Friday, November 13, 2020 4:36 PM
To: [hidden email]
Subject: [Numpy-discussion] How did Numpy get its latest version of the documentation to appear at the top of Google search results?

 

I'm working with Bokeh (https://docs.bokeh.org/en/latest/), another

open-source Python package. The developers would like to have the latest

version of their documentation appear at the top of Google search results

when users search for information, but knowledge of how to do this is

lacking.

 

I've noticed that Numpy seems to have gotten this problem figured out, e.g.,

googling "numpy interpolate" results in the first hit being

https://numpy.org/doc/stable/reference/generated/numpy.interp.html. This is

unlike Python itself, where googling "python string formatting" results in

the first hit being https://docs.python.org/3.4/library/string.html.

 

So apparently someone in the Numpy developer world knows how to setup the

doc pages in a manner that allows for this. Would that person be willing to

post to the Bokeh message board on the topic

(https://discourse.bokeh.org/t/some-unsolicited-feedback/6643/17) with some

advice?

 

Thank you!

 

 

 

--

Sent from: http://numpy-discussion.10968.n7.nabble.com/

_______________________________________________

NumPy-Discussion mailing list

[hidden email]

https://mail.python.org/mailman/listinfo/numpy-discussion

 


_______________________________________________
NumPy-Discussion mailing list
[hidden email]
https://mail.python.org/mailman/listinfo/numpy-discussion
Reply | Threaded
Open this post in threaded view
|

Re: How did Numpy get its latest version of the documentation to appear at the top of Google search results?

Aaron Meurer
In reply to this post by Ilhan Polat
I'm unclear from that issue what exactly was done that ended up
working. Was it the "moved permanently" redirect, or something else?
Did you use the webmaster tools? "Moved permanently" redirects aren't
an option if you want to host old version docs but still have Google
default to "latest".

For SymPy we got so tired of people ending up at old docs versions
that we just removed them (so now we only have "latest" and "dev"). We
don't support old versions anyway. But another problem I noticed is
that I had a fork of our docs repo on GitHub with the gh-pages branch,
and people were ending up at the version of the docs on my fork (I
discovered this from looking at the webmaster tools for my domain and
seeing that those pages were being clicked on from search results).

But two things I can recommend:

- Make sure the latest version of your docs use "latest" in the URL,
instead of a version number. That way when people copy the URL to
create a link, it will always point to the latest version (it looks
like Bokeh already does this).

- Poke around at the Google webmaster tools. There's a lot of good
stuff there, including a lot of good data on how people end up on your
site via Google searches.

Aaron Meurer

On Fri, Nov 13, 2020 at 9:43 AM Ilhan Polat <[hidden email]> wrote:

>
> Have a look at here for "some" background https://github.com/scipy/docs.scipy.org/issues/39
>
> On Fri, Nov 13, 2020 at 5:37 PM efremdan1 <[hidden email]> wrote:
>>
>> I'm working with Bokeh (https://docs.bokeh.org/en/latest/), another
>> open-source Python package. The developers would like to have the latest
>> version of their documentation appear at the top of Google search results
>> when users search for information, but knowledge of how to do this is
>> lacking.
>>
>> I've noticed that Numpy seems to have gotten this problem figured out, e.g.,
>> googling "numpy interpolate" results in the first hit being
>> https://numpy.org/doc/stable/reference/generated/numpy.interp.html. This is
>> unlike Python itself, where googling "python string formatting" results in
>> the first hit being https://docs.python.org/3.4/library/string.html.
>>
>> So apparently someone in the Numpy developer world knows how to setup the
>> doc pages in a manner that allows for this. Would that person be willing to
>> post to the Bokeh message board on the topic
>> (https://discourse.bokeh.org/t/some-unsolicited-feedback/6643/17) with some
>> advice?
>>
>> Thank you!
>>
>>
>>
>> --
>> Sent from: http://numpy-discussion.10968.n7.nabble.com/
>> _______________________________________________
>> NumPy-Discussion mailing list
>> [hidden email]
>> https://mail.python.org/mailman/listinfo/numpy-discussion
>
> _______________________________________________
> NumPy-Discussion mailing list
> [hidden email]
> https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________
NumPy-Discussion mailing list
[hidden email]
https://mail.python.org/mailman/listinfo/numpy-discussion