docs: resource-detector should not be tied to tracing

[luizhlelis]

Fixes #3027
Design discussion issue #3027

Changes

1. Moving resource to its own section;
2. Add links to it in the trace, metric, and log sections.

Merge requirement checklist

• CONTRIBUTING guidelines followed (nullable enabled, static analysis, etc.)
• Unit tests added/updated
• Appropriate CHANGELOG.md files updated for non-trivial changes
• Changes in public API reviewed (if applicable)

[cijothomas]

Thank you for tackling this!
#5185 Is tweaking the wordings on Resource. Once that is merged, lets bring that as well to this PR before merging.

[utpilla]

@luizhlelis #5185 is merged. Please resolve the merge conflicts.

[cijothomas]

this section is tricky, as it is tied to Tracing signal.. We need to document all three with SDK.CreateProvider and the OTel.Ext.Hosting style of configuration of resource.

The env variables part is good for all three.

[cijothomas]

@luizhlelis See if you can fix this part too. If not, we can still merge, and do some follow ups later.

[luizhlelis]

hey @cijothomas, I've just removed that section from the resource doc. I left those definitions tied to the signals, for instance, trace, metrics, and logs. Please, let me know if that's what you want or if I should move them all to the new resource doc.

[utpilla]

I think it would be better to simply show the code snippet to create a custom ResourceDetector here instead of pointing to docs/trace/...

You could then add code snippets that show how to add this custom ResourceDetector to all the three signals using both Sdk.Create/LoggerFactory.Create and Extensions.Hosting approach.

[utpilla]

Let me know if you would like to address these in this PR itself.

[luizhlelis]

done

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (6250307) 83.38% compared to head (733f01c) 83.13%.
Report is 14 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5188      +/-   ##
==========================================
- Coverage   83.38%   83.13%   -0.26%     
==========================================
  Files         297      271      -26     
  Lines       12531    11970     -561     
==========================================
- Hits        10449     9951     -498     
+ Misses       2082     2019      -63     

Flag	Coverage Δ
unittests	?
unittests-Solution-Experimental	82.85% <100.00%> (?)
unittests-Solution-Stable	83.07% <100.00%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files	Coverage Δ
...tation.AspNetCore/Implementation/HttpInListener.cs	89.72% <100.00%> (+0.14%)	⬆️

... and 32 files with indirect coverage changes

[github-actions]

This PR was marked stale due to lack of activity and will be closed in 7 days. Commenting or Pushing will instruct the bot to automatically remove the label. This bot runs once per day.

[luizhlelis]

@cijothomas and @utpilla, when you have the chance, please review the PR again. Let me know if I need to do something else.

[luizhlelis]

hey @cijothomas, I've just removed that section from the resource doc. I left those definitions tied to the signals, for instance, trace, metrics, and logs. Please, let me know if that's what you want or if I should move them all to the new resource doc.

[luizhlelis]

done

[cijothomas]

Utkarsh and myself both were on vacation. I just came back today - will review by tomorrow. Thanks for waiting patiently!

[cijothomas]

it would be good to give a background on what is resource etc. here in a follow up.

[cijothomas]

This does make resource less tied to tracing, so approving to merge.
We need to have a follow up to move the Resource readme from individual docs to the newly created common place. Specifically, content from https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics/customizing-the-sdk#resource (and logs, traces too), should be moved to the common doc as much as possible