devdocs icon indicating copy to clipboard operation
devdocs copied to clipboard

Docker documentation seems broken

Open MichaelAquilina opened this issue 7 years ago • 3 comments

For all versions of docker, I simply get a small bar showing the license and a link to the docker documentation (docs.docker.com)

MichaelAquilina avatar Apr 24 '18 16:04 MichaelAquilina

That’s just the homepage — see http://devdocs.io/docker~17/compose/compose-file/compose-versioning/index for a working page.

j-f1 avatar Apr 24 '18 16:04 j-f1

oh right - Searching works correctly in fact. It's a bit confusing the first time you see it though. Would there be a better alternative for a homepage considering most of the other documentation packages contain detailed homepages?

MichaelAquilina avatar Apr 24 '18 16:04 MichaelAquilina

Seems for the root page we currently hardcode to just return a header thus why it's blank

https://github.com/freeCodeCamp/devdocs/blob/4c70959ee9bcf58b649ed4247bed0caab0418462/lib/docs/filters/docker/clean_html.rb#L5-L8

Possible solutions:

  • scrape the homepage and link out to the appropriate docs
  • redirect the root to to another page e.g. https://docs.docker.com/get-started/ and use that instead

thewheat avatar Oct 09 '22 03:10 thewheat