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

v.1.0.0 documentation is missing #28544

Closed
paul-hammant opened this issue Aug 9, 2018 · 9 comments
Closed

v.1.0.0 documentation is missing #28544

paul-hammant opened this issue Aug 9, 2018 · 9 comments

Comments

@paul-hammant
Copy link

  1. v.1.0.0 doco isn't up on the site.
  2. https://www.google.com/search?q=julialang+faq points to v0.6.2 not v0.7.0 (latest) so y'all should do that canonical-url stuff. Ref my friend's work towards the same for his Java tech - https://publicobject.com/2017/02/14/canonical-urls-for-javadocs/
  3. https://docs.julialang.org/en should redirect to latest.
@fredrikekre
Copy link
Member

Thanks, it should now be updated: https://docs.julialang.org/en/stable/

@paul-hammant
Copy link
Author

  1. up on site, affirmative
  2. Canonical URL work done? I don't think so that'd mean redeploying all the 0.6.2, 0.7.0 doco.
  3. https://docs.julialang.org/en still 404's.

:-(

@fredrikekre
Copy link
Member

@mortenpi ^

@mortenpi
Copy link
Contributor

mortenpi commented Aug 9, 2018

We should add a redirect to that directory too. https://docs.julialang.org/ redirects correctly. I can PR that.

@fredrikekre
Copy link
Member

@mortenpi
Copy link
Contributor

mortenpi commented Aug 9, 2018

As for canonical URLs: they were introduced with the 0.6.3 docs, but the older docs (0.6.2, release-0.5, release-0.4 etc.) don't have them, which is why they show up in google.

We could probably do a string replace in all the HTML pages from e.g. </head> to <link rel="canonical" href="..."></head>, with links translated from https://docs.julialang.org/en/vX.Y.Z/foo.html to https://docs.julialang.org/en/stable/foo/index.html.

An open question is how to handle pages that do not have a corresponding page under stable/ anymore (or the name has changed). I am not sure what the consequences of pointing to non-existing URLs is.

@o314
Copy link
Contributor

o314 commented Aug 10, 2018

@mortenpi
Copy link
Contributor

#27094 for the Markdown page.

The edit link is a good catch. Somehow the base URL got changed in the build.

@o314
Copy link
Contributor

o314 commented Aug 10, 2018

OK. It seems it's the only package of the stdlib without docs

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