Adding a "HOW-TO: Building your own collector" tutorial to the collector

[rquedas]

Hoping to start a series of "HOW-TO" docs in the collector to help developers learning how to build components like the one I am proposing here Tutorial on how to build a trace receiver #1265

This would be the step one in the journey for component developers.

---

Preview: https://deploy-preview-1277--opentelemetry.netlify.app/docs/collector/howto-custom-collector/

[jpkrohling]

Similar to the other PR, just wanted to mention that you might want to compare this with the blog post I published some time ago, and which is certainly outdated by now:

https://medium.com/opentelemetry/building-your-own-opentelemetry-collector-distribution-42337e994b63

[rquedas]

Absolutely! Your blog is a more complete walkthrough, this one is using the builder tool so people can quickly bootstrap for component development. I would say they are actually complimentary.

[austinlparker]

Some grammar nits

[rquedas]

thank you @austinlparker ! I merged all your suggestions.

[svrnm]

Added a few recommendations

[rquedas]

@austinlparker and @svrnm, can you take a look at the latest update and tell me if there is anything else we need to address?
Thanks!

[austinlparker]

@svrnm lmk if this is g2g

[svrnm]

@austinlparker , all my issues have been addressed, leaving it to the expert @jpkrohling with the remaining open issues :-)

[austinlparker]

@jpkrohling is this good to go?

[jpkrohling]

I'm still not 100% happy with this. @rquedas, is this OK if I send another commit to your PR?

[rquedas]

I'm still not 100% happy with this. @rquedas, is this OK if I send another commit to your PR?

Absolutely!

[rquedas]

@jpkrohling, I will start refactoring the trace receiver tutorial to support 0.50.0 model changes, so when you are finished with this one we can have both available. Does that sound like a plan?

[cartermp]

@jpkrohling would you still prefer to commit against this branch and then merge, or merge now and contribute a change later?

[rquedas]

@austinlparker, @svrnm and @jpkrohling, just merged changes to reflect "v0.53.0".
Please review and let me know if there is anything you would like me to change.

[austinlparker]

Added several suggestions, but otherwise lgtm. As a general tip, you don't need to add qualifiers to statements ('where you basically pass' vs. 'where you pass') in docs.

[rquedas]

@austinlparker, thank you for taking the time in reviewing it and making the suggestions. I merged all of them.
If you think we are ready, we should also update the index to make the tutorial visible

[austinlparker]

Docs automatically get added to the sidebar when they're added. @jpkrohling you have a requested change; Would you like to commit that directly or add a PR after the merge?

[chalin]

Rebased since this PR has been open for a while and needed to catch up.

[chalin]

See inline comments

[chalin]

@rquedas - see my inline comments for possible final changes
@austinlparker - you had requested changes; are you ready to approve now?

bouncing review

[chalin]

Made it! Woohoo! Thanks all!