The Official CMake Tutorial Is Intimidating

Site Feedback
1

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.

2 Likes
2

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

3 Likes
3

Please have a look at CMake MR 6217 for a splitted tutorial.

1 Like
4

So … here’s an even more basic question, possibly I should just start a new topic but whatever.
Where is this tutorial test code? Step1? Step2? I would expect to find it at the tutorial site as shown above or something.

5

The tutorial says at the beginning:

The tutorial documentation and source code for examples can be found in the Help/guide/tutorial directory of the CMake source code tree.

So you need to download the CMake source as zip/tar.gz or clone from the git repository. Here’s the online Gitlab link:
https://gitlab.kitware.com/cmake/cmake/-/tree/master/Help/guide/tutorial

6

Got it, thanks. I can see now that my problem is that I downloaded the Binary Distribution rather than the Source because I thought … well, never mind what I thought. :roll_eyes:

Thanks a lot.