[docs] Prepare docs

[colleenmcginnis]

Closes elastic/observability-docs#4056
Closes https://github.com/elastic/obs-docs-team/issues/240

Builds out minimal viable docs.

What's included

This includes the overall structure of the initial doc set. There is some missing information. I've left code comments with questions to be answered throughout the files.

Read more about what needs to be included in these docs in Elastic Distributions for OpenTelemetry (Mini docs style guide) (internal doc).

To do

• @colleenmcginnis convert back to AsciiDoc
• @colleenmcginnis add initial outline with questions for the dev team in code comments
• @colleenmcginnis continue clean up / aligning across languages
• @elastic/apm-agent-net review content that's already there, add content that's missing (especially where there are questions in code comments)
  • Feel free to either commit directly to this PR or add suggestions in PR comments — whichever works best for you!
• @colleenmcginnis clean up content
• @elastic/obs-docs peer review
• @colleenmcginnis address feedback
• 🆕 @colleenmcginnis convert to Markdown
• 🆕 @colleenmcginnis reorganize content as needed to be consumed on GitHub
• 🆕 @colleenmcginnis slight content reframing
• 🆕 @colleenmcginnis update product naming as needed
• @elastic/apm-agent-net final review, approve
• @colleenmcginnis merge

[colleenmcginnis]

👋 @elastic/apm-agent-net can you please take an initial look here? I left many questions for you in code comments throughout the doc files. As you read through, if you have answers to questions, feel free to either commit directly to this PR or add suggestions in PR comments — whatever works best for you!

[Mpdreamz]

Hey @colleenmcginnis thanks for getting our docs in shape.

I addressed several questions but its hard to parse whats a question to us vs whats a structural comment that describes the paragraph.

Let me know if I missed any!

It would be good to get this in soonish so that we can do another pass over the content as part of #126.

[colleenmcginnis]

Thanks @Mpdreamz.

I addressed several questions but its hard to parse whats a question to us vs whats a structural comment that describes the paragraph.

Sorry for the confusion!

[colleenmcginnis]

@Mpdreamz one more question for now!

[Mpdreamz]

@colleenmcginnis let me know when you need us to do the final review for that 2nd last checkmark 😸

[colleenmcginnis]

Thanks for your patience here! I've updated the "To do" list above with some 🆕 items that reflect some recent changes to how we're approaching documenting Elastic Distributions for OpenTelemetry. This includes converting from AsciiDoc to Markdown. Users will be directed to this repo to read the docs on GitHub. We're not going to build and host these docs on elastic.co/guide right now.

[colleenmcginnis]

@Mpdreamz I split the naming changes into two commits: update naming (docs files) and update naming (non-docs files) so we can easily revert if you want to handle non-docs files separately.

[Mpdreamz]

@colleenmcginnis almost LGTM 😸 added a few spacing nitpicks.

[colleenmcginnis]

added a few spacing nitpicks.

Oh gosh this might have been my local whitespace settings. 🙈