updated version of the C++ Getting Started with a Roll The Dice

[Akhaled19]

This is to solve issue #3345.
Unfortunately, it's not quite ready yet as I'm currently encountering some challenges while configuring OpenTelemetry with my oatpp Application. I would greatly appreciate any tips or assistance in this matter.

---

Preview:

• https://deploy-preview-3423--opentelemetry.netlify.app/docs/instrumentation/cpp/getting-started-new/
• https://deploy-preview-3423--opentelemetry.netlify.app/docs/instrumentation/cpp/getting-started/

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: Akhaled19 / name: Azal Khaled (2210283, 7138098, af083d6, fbad7e1, 2e4bed9, bd9af38, 9bf5b22, 47c7c32, f48a51c, 612c6a2, f215cd9, bf4e9e2, 44a04ae, ff5d9dd, 59f6ba6, 12e580c, 3b00e96, f323352, 891ac24, 0b2d9c7, 93dba8a, 5b5abb8, 31ed747, 0f4f445, c8bdac8, 16eaa6b, e578e69, a50d1bf, bde090b, a802826, e181b92, 7da7542, 643d6a6, 3739d78, 1c7d608, 50f7998, d383f7b, 7479bb0, 7d4c91b, f9fe617, 12c60f0, 03c12b7, b2ed603, 310af3e, eb11179, 69c6fea, 15bfab0, 5c7eeae, 30abfbe, 093d9a7, 11bc416, 5741082, 14982cf, 2aa6b0e, 8bbfaf3, 7160fe3, 062b00b, 1158b10, 0827b50, dc0142d, cbb32a0, faec45f, 77399f6)
• ✅ login: svrnm / name: Severin Neumann (f48a51c, 612c6a2, f215cd9, bf4e9e2, ff5d9dd, 59f6ba6, 5b5abb8, 31ed747, 0f4f445, c8bdac8, 16eaa6b, e578e69, a50d1bf, bde090b, a802826, e181b92, 7da7542, 643d6a6, 3739d78, 1c7d608, 50f7998, d383f7b, 7479bb0, 7d4c91b, f9fe617, 12c60f0, 03c12b7, b2ed603, 310af3e, eb11179, 69c6fea, 15bfab0, 5c7eeae, 30abfbe, 093d9a7, 11bc416, 5741082, 14982cf, 062b00b, 1158b10, 0827b50, dc0142d, cbb32a0, faec45f, de050fc, b215ddc, 42744df, 19de742, be7dec5)

[svrnm]

thanks for taking the time and effort to write this down @Akhaled19! My first review is just from taking a look at the text, I will try out what you have created so far and will provide additional feedback

[Akhaled19]

Hello @svrnm! I made the switch from conan to source code and fixed up the instructions. I made a rookie mistake of not unstaging some of those files and keeping only content/en/docs/instrumentation/cpp/getting-started-new.md before my commit. I apologize for the messy pull request.

[svrnm]

Hello @svrnm! I made the switch from conan to source code and fixed up the instructions.

thanks, let me take another look!

I made a rookie mistake of not unstaging some of those files and keeping only content/en/docs/instrumentation/cpp/getting-started-new.md before my commit. I apologize for the messy pull request.

No worries, we will squash merge the PR at the end, so no mess to see :-)

[svrnm]

Hey @Akhaled19, first of all: it works! 🎉 -- I could follow those instructions and got "myapp" export a span to the console, that's really big progress.

I struggled with the locations of the dependencies a little bit, we need to tune that in a way that it is easy for end-users to consume. Speaking as a non-C++-expert I am wondering if instead of running a make install just build them and load the include files and libraries from the build folders, that way you can provide a path to the end users, because they should have a folder with the following structure:

oatpp
opentelemetry-cpp
roll-dice

And in the CMakeLists for roll-dice they should be able to use ../oatpp/<path-to-lib|include> and ../opentelemetry-cpp/<path-to-lib|include>

[chalin]

A few initial comments.

[svrnm]

It works 🎉 ... some minor comments, but overall this is looking really good!

[svrnm]

@open-telemetry/cpp-approvers please take a look

[lalitb]

LGTM with suggestions.

[svrnm]

@lalitb @marcalff thanks for taking a look! @Akhaled19 please take a look at the open conversations & the conflict, let me know if you need any assistance to fix them.

[svrnm]

thank you soo much for your work on this issue @Akhaled19 !!!

https://opentelemetry.io/docs/languages/cpp/getting-started/

[Akhaled19]

Thank you for making my first issue a pleasant experience @svrnm!!

[svrnm]

Thank you for making my first issue a pleasant experience @svrnm!!

Happy to hear that! This PR was really a big challenge due to the complexity of the task, so I am glad you had a great experience!