Add opentelemetry.io docs

[austinlparker]

Per open-telemetry/opentelemetry.io#472, we're mirroring the docs content on the website to each SIG. When a release occurs and these docs are updated, please make an issue or PR mirroring them to their appropriate location in the website repo (https://github.com/open-telemetry/opentelemetry.io/tree/main/content/en/docs/collector).

[codecov]

Codecov Report

Merging #2839 (be47882) into main (39e0adc) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #2839   +/-   ##
=======================================
  Coverage   91.76%   91.76%           
=======================================
  Files         281      281           
  Lines       15149    15149           
=======================================
  Hits        13902    13902           
  Misses        853      853           
  Partials      394      394           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 39e0adc...be47882. Read the comment docs.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[tigrannajaryan]

@austinlparker please address the comment.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[austinlparker]

The link check is never gonna work on this, is there a way to ignore it for files in this path?

[shelbyspees]

@austinlparker it doesn't look like markdown-link-check supports ignoring files, just links on specific lines or in specific blocks of markdown.

<!-- markdown-link-check-disable --> and <!-- markdown-link-check-enable-->: Use these to disable links for all links appearing between these comments.

I don't love that option since it adds noise to the source files. It doesn't look like we currently use markdown-link-check in the main docs repo, but if we decide to in the future we'd have to deal with any disable/enable comments we add in here.

There's also an open issue to add an exclude parameter to the GitHub action config: gaurav-nelson/github-action-markdown-link-check#38. It looks like the maintainer wants to add it, but I'm not sure about their timeline for that.

[tigrannajaryan]

@austinlparker Is the docs content in this PR copied from https://github.com/open-telemetry/opentelemetry.io/tree/main/content/en/docs/collector ?

Do you also plan to add the update-docs job in a later PR like we have for Java https://github.com/open-telemetry/opentelemetry-java/blob/main/.github/workflows/docs-update.yml ?

[austinlparker]

@austinlparker Is the docs content in this PR copied from https://github.com/open-telemetry/opentelemetry.io/tree/main/content/en/docs/collector ?

Yeah, it's whatever was there when I made the PR.

Do you also plan to add the update-docs job in a later PR like we have for Java https://github.com/open-telemetry/opentelemetry-java/blob/main/.github/workflows/docs-update.yml ?

Yes, if it's desired.

[austinlparker]

I went ahead and pushed the update script in this PR as well, can be removed if desired.

[tigrannajaryan]

I went ahead and pushed the update script in this PR as well, can be removed if desired.

Thanks.

What's the plan with the failing link checks? Will you add <!-- markdown-link-check-disable --> annotations or you are looking for some other solution?

[austinlparker]

I'll add the annotations for now, I was hoping someone had a better idea on ignoring the path but this should at least unblock things for now.

[austinlparker]

I guess bounce the checks when the GitHub Actions incident is resolved?

[tigrannajaryan]

I assume once this PR is merged we will need to add the token, right? Let's do it after it is merged and do a test run of the workflow to see how it works.

[tigrannajaryan]

@austinlparker can you please add the token and let's see how the docs-update works.