[CI/infra] Doc file names: use kebab-case not snake_case

[chalin]

We need a consistent naming convention for doc file names. I suggest adopting kebab-case over other cases, snake_case in particular.

In particular note that we have some Getting started pages in getting_started.md files and other in getting-started.md files. These should be consistently named.

• JS
  • JS docs: path rename getting_started to getting-started #841
  • content/en/docs/js/instrumentation_examples.md - JS examples: copyedits and file rename #1095
• PHP
  • [website_docs] Fix page meta links and rename file opentelemetry-php#578
  • Update PHP docs #1119
• Ruby
  • [website_docs] fix broken links, copyedits and file renames opentelemetry-ruby#1120
  • Update Ruby docs 2022/02/04 #1098
• Demo: Demo docs: rename pages to follow website conventions #2293
• Updating diagrams with new styles #2869
• Enforce kebab-case in file and folder names for main content and drops unused assets #3019
• All that might be left are the files in iconography.
• Another thing to consider might be enforcing lowercase letters too
• Spec -- probably won't want to changes these. Note that semconv are moving to a separate repo, and so the semantic_conventions directory names might be disappearing:

  $ find content -name "*_*" -type f | perl -pe 's|/_index.md||' | grep -e _
  ...
  content/en/docs/reference/specification/metrics/semantic_conventions
  content/en/docs/reference/specification/trace/semantic_conventions
  content/en/docs/reference/specification/schemas/file_format_v1.0.0.md
  content/en/docs/reference/specification/logs/semantic_conventions
  content/en/docs/reference/specification/resource/semantic_conventions/deployment_environment.md
  content/en/docs/reference/specification/resource/semantic_conventions/cloud_provider/aws
  content/en/docs/reference/specification/resource/semantic_conventions

[austinlparker]

kebabs sound good to me

[himanshu007-creator]

Hi , I would like to work on this issue

[chalin]

Come to think of it, this is interdependent with other issues I need to address in parallel. Thanks for the offer @himanshu007-creator, I'll let you know if/when you can contribute.