Documentation links leads to 404 error page

[prasad15]

If you are reporting a problem, please make sure the following information are provided:

Expected behavior and actual behavior:
Clicking on Documentation link redirects to 404 page instead of actual docs page.

Steps to reproduce the problem:
The UserGuide Doc asks go to this link which in turn redirects to a 404 error page.

Versions:
Harbor 1.10 docs

• harbor version: [1.10]

[bitsf]

@xaleeks please help deal with document issue

[rowersteven]

Error trying to see 1.10 documentation
https://github.com/goharbor/harbor/blob/master/docs/1.10/index.md.

[rowersteven]

@bitsf @xaleeks Every topic link is broken in
https://github.com/goharbor/harbor/blob/master/docs/1.10/index.md.

[catlook]

Do you have an expected resolution time frame? I'd love to be able to link to your docs in mine!

[rowersteven]

Thanks for the response. I need to look at the documentation about Harbor replication functions quite urgently. It will be great if the documentation page can be restored completely over the next couple days.

[bitsf]

@rowersteven I think you can reference old doc, it's nothing different for replication
https://github.com/goharbor/harbor/blob/v1.10.0/docs/user_guide.md#replicating-resources

[bitsf]

@reasonerjt can you also help check who can fix this document asap, this would be quite bad experience for users after release.

[rowersteven]

@bitsf thank you Ziming for the URL. It serves my need for the time being, yet please help urge a fix of the documentation web page soonest.

[bitsf]

pr #10693 and #10695 seems help fix this

[stuclem]

@bitsf @rowersteven @reasonerjt this happened during a general overhaul of the docs, and it has now been fixed. The redirects in the old doc pages now point to https://github.com/goharbor/harbor/tree/master/docs/1.10, where you can access the new doc table of contents.

[rowersteven]

Very disappointing, click topic links give you 404 error.

…

On 11 Feb 2020, at 4:14 PM, Stuart Clements ***@***.***> wrote:  @bitsf @rowersteven @reasonerjt this happened during a general overhaul of the docs, and it has now been fixed. The redirects in the old doc pages now point to https://github.com/goharbor/harbor/tree/master/docs/1.10, where you can access the new doc table of contents. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or unsubscribe.

[catlook]

And why does the index file not have a TOC and serve as the root of the doc?

[rowersteven]

@bitsf @stuclem the issue is not yet fixed. You select any link in the ToC https://github.com/goharbor/harbor/tree/master/docs/1.10 and all return 404 :-(

[stuclem]

@rowersteven @catlook I see what you mean. It seems that all of the files have been renamed to use hyphens instead of underscores, again as a part of the big doc overhaul.

There is already a PR open to fix this: #10661

[stuclem]

@rowersteven @catlook #10661 is now merged, and I it looks like the TOC is now working again: https://github.com/goharbor/harbor/tree/master/docs/1.10

[rowersteven]

Hurray! It works now! Thanks a lot @stuclem

[stuclem]

@rowersteven you're welcome (although @jonasrosland is the one who fixed it). Apologies for the inconvenience, but we're going through a major overhaul of the docs, which is still ongoing. Hopefully we won't have any more glitches like this. We hope that you will appreciate the difference when we roll out the final version of the new doc.

[rowersteven]

Sorry to raise this again but it seems pictures in document are not displayed. E.g. docs/1.10/administration/configuring-replication/create-replication-rules.md