Use of outdated collector API version in documentation

[Chinwendu20]

I can see the documentation is based on version 0.53 of the collector API. I have opened this issue to discuss if the documentation should just reflect the latest version of collector API or better still there should be documentation for every collector release.

[cartermp]

In general I think the docs should use only the latest APIs. Right now the collector is still (technically) pre-release, and so we can expect any number of further breaking changes to the API until such a time that it's considered stable. Since those older APIs won't be supported, it's not worth documenting how to use them.

[svrnm]

I can see the documentation is based on version 0.53 of the collector API.

where do you see use of 0.53 collector? We try to auto-update the collector versions on release, so if the version is hardcoded somewhere we should fix that.

[Chinwendu20]

I was following the tutorial for creating a trace receiver and I discovered a disparity between the collector API used and the most recent one the hyperlinks to the source code also points to v0.53:

It was also written here:

I have however implemented the trace receiver tutorial with v0.66 of the colector API

[svrnm]

thanks, we will need to take the collector version variable we have in the getting started and use it in that page as well

[chalin]

We should avoid duplicating version info. I've updated the following umbrella issue with proposed solutions:

• Create and use a config/section parameter for release versions for each language + collector #1194

[svrnm]

We should avoid duplicating version info. I've updated the following umbrella issue with proposed solutions:

• Create and use a config/section parameter for release versions for each language + collector #1194

Agreed.

[chalin]

I'm going to close this since the problems reported here will be addressed (in part) and/or tracked elsewhere:

• Building a Trace Receiver instructions only work with old versions of Collector #2260
• Alert that old vers of collector is used in Building a Trace Receiver #2261
• Building a custom collector refers to old collector version #2262

If you think that something isn't covered by the items above, comment here.