Edit/Create links for docs pages should point to authoritative sources

[austinlparker]

Currently, on each doc page there's a set of links in the upper-right above the doc ToC for opening issues/creating child pages for a docs page.

It would be nice if these could point to the upstream source (i.e., open-telemetry/opentelemetry-java/website_docs) rather than the website repo itself.

This would require some Docsy hacking, as these are set in themes/docsy/layouts/partials/page-meta-links.html.

---

Edit(@chalin): tracking changes (as of 2021/08/18)

• Layout file update - Support GH links to canonical src in lang repo #687
• Collector - docs moved back into this repo - Website: support GH page links to canonical src opentelemetry-collector#3850
• C++ - unnecessary since, as of 2021/08/18, docs are only in this repo.
• .NET - unnecessary since, as of 2021/08/18, docs are only in this repo.
• Erlang - unnecessary since docs are moving back into this repo.
• Go - Website: support GH page links to canonical src opentelemetry-go#2189
• Java - Website: support GH page links to canonical src opentelemetry-java#3501
• JS - docs moved back into this repo - docs(website): support GH page links to canonical src opentelemetry-js#2421
• PHP - Update PHP docs #857 - Website: support GH page links to canonical src opentelemetry-php#454
• Python - Website: support GH page links to canonical src, and aliases opentelemetry-python#2224
• Ruby - docs: Fix compatibility issues with opentelemetry.io opentelemetry-ruby#953

[harshita19244]

@austinlparker I would like to work on it, could you assign it to me?

[harshita19244]

I had a question, to make these changes, do I need to directly modify the code in the Docsy repo? Since the themes/docsy points to the actual Docsy repo itself. Do I send a pr there? @austinlparker

[austinlparker]

I don't think we should change the underlying theme (as that means we wouldn't be able to update it easily) - Hugo has a lookup order for partials, so we could customize it by creating a copy of it then tweaking it. See https://gohugo.io/templates/partials/ for more information on how the template lookups work.

[chalin]

Hi all. Need a hand with this? I've implemented this in other website repos, and would be glad to set this up here too (once I'm done with basic infrastructure cleanup).

[chalin]

Mind if I pickup work on this issue @harshita19244?

[chalin]

@austinlparker - By the way, there's a "feature interaction" with multi-language support -- which the website is currently ready for, though currently on en is supported. That is, language repos should probably be setup for multi-language support as well. Thoughts?

[chalin]

Self-assigning. The first couple of PRs are landing soon.

[chalin]

Mind if I pickup work on this issue @harshita19244?

@harshita19244 - FYI, I'll be completing the resolution of this issue. Thanks for your original interest!

[chalin]

See #730