Fix typos and grammar in the OTLP spec

[moonbox3]

Fixes #3120

Changes

This PR fixes typos and grammatical errors in the OTLP spec. Additionally, there were several places where text contained passive voice. These were updated to active voice to make them easier to follow.

[moonbox3]

Does this change require a changelog?

[tigrannajaryan]

Thank you for the fixes @moonbox3

Some of the changes DO change the meaning, so I am temporarily blocking to fix those.

[moonbox3]

Thank you for the fixes @moonbox3

Some of the changes DO change the meaning, so I am temporarily blocking to fix those.

Thank you for your review, @tigrannajaryan. I appreciate it. I have addressed your comments/suggestions.

[carlosalberto]

Btw we don't use comma after e.g. nor i.e. in general - according to Wiktionary:

"E.g." and its examples are typically set off from the rest of the sentence by punctuation. In US English, "e.g." is usually followed by a comma.[2] It is not followed by a comma in other English-speaking countries.

So we should probably stick to the comma-less form for now, given we already use that and, technically, it's not incorrect.

[moonbox3]

Btw we don't use comma after e.g. nor i.e. in general - according to Wiktionary:

"E.g." and its examples are typically set off from the rest of the sentence by punctuation. In US English, "e.g." is usually followed by a comma.[2] It is not followed by a comma in other English-speaking countries.

So we should probably stick to the comma-less form for now, given we already use that and, technically, it's not incorrect.

@carlosalberto Thank you for your comment. Is there a style guide I should be following?

[moonbox3]

@tigrannajaryan or @MrAlias can you please help review the final changes? Thank you.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[moonbox3]

I would prefer for this PR to not be closed due to lack of activity. Can I get some help on it, please? Thank you.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[carlosalberto]

Thanks @moonbox3 - looks good to go IMHO.

cc @tigrannajaryan

[tigrannajaryan]

Just 2 small comments left, the rest looks good to me.

[moonbox3]

Thank you all for the help. @tigrannajaryan I addressed your two final comments. Thank you.

[tigrannajaryan]

Thank you @moonbox3 for making the spec clearer.