Reorganize demo feature documentation

[flands]

• Create a nested section called features
• Organize feature index page
• Add feature flags under features subsection
• Add signal coverage under features subsection

[cartermp]

Content looks good overall. Could you run npm run fix to address formatting and stuff? Thanks!

[flands]

OK, I think I fixed the links - at least they appear to work with npm run serve:netlify but they don't work with npm run serve as hugo aliases appear to be disabled... Is there a different way to do this?

[cartermp]

Hmm, seems I still get these errors with npm run check:links:

blog/2023/demo-birthday/index.html
  target does not exist --- blog/2023/demo-birthday/index.html --> /docs/demo/feature-flags/
blog/2022/announcing-opentelemetry-demo-release/index.html
  target does not exist --- blog/2022/announcing-opentelemetry-demo-release/index.html --> /docs/demo/trace-features/
  target does not exist --- blog/2022/announcing-opentelemetry-demo-release/index.html --> /docs/demo/metric-features/
docs/demo/architecture/index.html
  target does not exist --- docs/demo/architecture/index.html --> /docs/demo/metric-features/
  target does not exist --- docs/demo/architecture/index.html --> /docs/demo/trace-features/
docs/demo/index.html
  target does not exist --- docs/demo/index.html --> feature-flags
  target does not exist --- docs/demo/index.html --> feature-flags/
  target does not exist --- docs/demo/index.html --> metric-features/
  target does not exist --- docs/demo/index.html --> trace-features/

[flands]

Yes, me too, and this appears to be because hugo.yaml has disableAliases: true # We do redirects via Netlify's _redirects file. If you want it to work, you have to run npm run serve:netlify instead of npm run serve. I'm not sure how to proceed here...

[cartermp]

Ergh, failed twice to push changes to your branch due to git permissions -- here's a patch file of the changes you need to make this work.
0001-fix-links.patch

[puckpuck]

I like some of where this is going, but I see it adding even more confusion.

The new section includes Telemetry coverage and Feature Flags. I don't believe they shouldn't be grouped. Should the new section be called "Telemetry Features" instead, and Feature Flags be moved back up? Also, I would like to see "Manual Span Attributes" pulled into this section.

Thinking into the future, we currently have a gap with manual metrics needing to be documented, and this section would be a great spot to add them.

[flands]

Ergh, failed twice to push changes to your branch due to git permissions -- here's a patch file of the changes you need to make this work. 0001-fix-links.patch

Thanks and yeah, I feared this was the answer - I'll file a bug about aliases not working properly. I'm not sure fixing all links is scalable long-term.

[cartermp]

@puckpuck any further thoughts on this PR?

[puckpuck]

This looks good.

[chalin]

What was the intent here? This added alias effectively pushes a page alias outside of the Demo section, which we don't want IMHO.

[chalin]

Let's track this via:

• [Demo] Aliases are bleeding out of the demo section #3801

[chalin]

Btw, thanks for the PR @flands, this slight reorg is an improvement IMHO! 👍🏻