Migrate Python docs to this repo

[chalin]

This is the Python part of

• Ensure non-API docs are hosted on opentelemetry.io #833

The decision to migrate the Python (non-API) docs was recorded in

• Non-API docs should be hosted on the website only opentelemetry-python#2172 (comment).

---

• Update Python submodule - Update opentelemetry-python #1110
• Handle website_docs (https://github.com/open-telemetry/opentelemetry-python/tree/main/website_docs) pages:
  • Move website_docs pages into this repo
    • Make Python doc pages local #1111
    • Python page refresh and cleanup #1112
    • Create and test a Hugo-shortcode equivalent of RTD literalinclude - Python Getting Started: read code from source files #1113
  • Remove website_docs from the Python repo - [website_docs] Drop website_docs folder opentelemetry-python#2452
• Migrate *.rst pages:
  • Create markdown versions (in this repo) of the Python *.rst doc pages
    • Python: add installation instructions, refine status info, and more #1116
    • Python: add automatic instrumentation and distro pages #1118
  • Remove the *.rst pages from the Python repo
    • [docs] Rework API docs opentelemetry-python#2453,
      the counterpart to Python: add installation instructions, refine status info, and more #1116
    • [docs] Remove / adjusted auto-instr and distro pages since they've moved opentelemetry-python#2498
      the counterpart to Python: add automatic instrumentation and distro pages #1118
    • [TBC, ... shim section pages]
  • Drop the scripts/generate_website_docs.sh script -- for context, see [website_docs] Drop website_docs folder opentelemetry-python#2452 (comment)

[chalin]

@cartermp - are there specific pages you wanted to see migrated? If so, after open-telemetry/opentelemetry-python#2453 lands (assuming it will), could you tell which pages you specifically require to be migrated? Otherwise, I'll just continue to migrate what seems most reasonable to move over. Thanks!

[cartermp]

Everything non-API docs, so the following will be off-limits to move:

• Core Packages (API and SDK)
• Exporters
• Shims

There are some module-level docs in each of those that might be useful to bring over, but we can do that in a phase 2 as needed.

[svrnm]

I argue this is complete? cc @open-telemetry/python-approvers

[cartermp]

I would say the same

[ocelotl]

Completed, closing.