The Official CMake Tutorial Is Intimidating

https://cmake.org/cmake/help/latest/guide/tutorial/index.html#id1

I’m trying to get my company to transition to using CMake.

I have found the official CMake tutorial to be intimidating to new users of CMake. (By the way the first time I started using CMake I felt the same way).

Here is my design suggestion.

Breakup the tutorial.

Currently there are different steps in the tutorial. However it’s all on the same page.

I think it should be broken up into more pages.

Because having Step1, Step2, etc. on the same page is scary or boring depending on the person.

1 Like

Thanks. I opened CMake Issue 21737 to track this. Splitting out each step into its own page sounds good to me.

2 Likes