Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Google is not indexing our docs #79

Open
bittrance opened this issue Jan 10, 2022 · 2 comments
Open

Google is not indexing our docs #79

bittrance opened this issue Jan 10, 2022 · 2 comments
Assignees

Comments

@bittrance
Copy link
Contributor

The following search https://www.google.com/search?q=site%3Axenitab.github.io+ingress should reasonably find something, but does not. I think this is because Docusaurus requires JavaScript to render the page, which Google probably refuses to do (nominally, Google does render JavaScript, but it has to be careful and I would not hold it against them if they simply skipped low-pagerank sites that present no content at all before rendering). Also, Docusaurus will not materialize menu tree nodes until the user clicks the parent, so Google would anyway not see more than a few top pages.

@NissesSenap
Copy link
Contributor

I have spoken to @CalleB3 and asked him to look in to this.
The plan is as follows:

So if there is a simple config value that we can set in Docusaurus that makes it possible to index the homepage.
If that is not the case we will leave Docusaurus and instead go over to https://gohugo.io/

Going over to hugo is obviously a much bigger task.

  • Find a good base theme for our docs page https://themes.gohugo.io/tags/docs/ and make sure that we can adopt it to our graphical profile
  • Adapt to our graphical profile, It don't have to look exactly like docusarus but similar.
  • Put in all our docs in a good way
  • Create a CI/CD solution that auto builds the new hugo page and publishes it when merged to main.
  • Create a PR and perform the switch.

My recommendation is to play with a repo in your own github or if you use a new branch for this repo to save your ongoing work.

@ahockersten
Copy link
Contributor

It may be worth noting that Bing appears to be indexing our site, so it's not "unindexable" by any means (which I don't think anyone has claimed - obviously other Docusaurus sites seem to be indexed). https://www.bing.com/search?q=site%3Axenitab.github.io+kubernetes&form=QBLH&sp=-1&pq=site%3Axenitab.github.io+kubernete&sc=0-32&qs=n&sk=&cvid=2CC6A3B590764A50B049A528AF1456A3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants