The tutorial requires files from repositories used as Submodules. The MkDocs Snippets extension requires files to be local, as would displaying documentation off-line.

Suggest downloading Submodules to consume but not update.

Cloning a Project with Submodules

Here we’ll clone a project with a submodule in it. When you clone such a project, by default you get the directories that contain submodules, but none of the files within them yet:

If you pass --recurse-submodules to the git clone command, it will automatically initialize and update each submodule in the repository, including nested submodules if any of the submodules in the repository have submodules themselves.

Pulling in Upstream Changes from the Submodule Remote

The simplest model of using submodules in a project would be if you were simply consuming a subproject and wanted to get updates from it from time to time but were not actually modifying anything in your checkout. ...

Recommendation? Best adding to wiki.

 * [libFuzzer](https://github.com/richelbilderbeek/cpp/blob/master/content/CppLibFuzzer.md): [a library for coverage-guided fuzz testing](http://llvm.org/docs/LibFuzzer.html)

This is 404 error and I also could not find that in your cpp repo. Could only find https://github.com/richelbilderbeek/cpp/blob/master/content/CppFuzzy_equal_to.md

USER = $$(USER)
contains(USER, p230198) {
  message(Richels computer)
}

!contains(USER, p230198) {
  message(Not Richels computer)
}

IS_ON_TRAVIS = $$(TRAVIS)

count(IS_ON_TRAVIS, 0) {
  message(Not building on Travis)
}

count(IS_ON_TRAVIS, 1) {
  message(Building on Travis)
}

Tutorial is difficult to work with because it is only available as a pdf which does not display well on the monitor. The mkdocs version displays well but must be maintained separately.

Some awesome feedback I got by email from flywire:

I'm interested in setting up Travis CI for LibreCad V3, a c++ program. Your tutorial (and blog etc) should be the ideal intro as it's the same environment but I'm having trouble following it. I'd like to provide feedback and ideally contribute to addressing these issues. (Maybe you're not so interested in this old project now.)

I'm using https://github.com/richelbilderbeek/travis_cpp_tutorial/blob/master/travis_cpp_tutorial.pdf

From Travis to source

So right from the start:

• 2.1 create https://github.com/flywire/cold_fusion_reactor

• 2.2 git clone https://github.com/richelbilderbeek/travis_cpp_tutorial

• 2.3 Create a Qt Creator project

  Why did we go from the cold_fusion_reactor repository to https://github.com/richelbilderbeek/travis_cpp_tutorial ?

I think @flywire has a point and I do not connect the chapters of the tutorial well enough.

What is Qt? (I know what it is but I don't see how it fits into the context of the tutorial.)

So I haven't got going yet but I can see from the code snippets this tutorial contains exactly what I'm after.

I find the font in the pdf to small to view on one side of a 22" monitor as I work through the tutorial. (I guess I'm getting spoilt with mkdocs.)

I see the point. As can be seen here, I tried to do a proper conversion, but fail for now. If anyone know how to properly run the script, we can adapt it to people's need. Now, I think I just used the LyX default setting.

btw, where does https://github.com/richelbilderbeek/simplify_cpp_travis_intro fit in?

AFAICS, I do not mention this in the tutorial. The tutorial is far from finished and I see what I intend it to become. The https://github.com/richelbilderbeek/simplify_cpp_travis_intro is a general article.

Hopefully you'll take these comments as constructive criticism as they are intended.

I definitely am! Thanks and please send more if needed :+1:

qmake defaults to adding -O2 when compiling, which can cause gcov to miss that some lines were optimised out.

I fixed this by adding this setting to my .pro file:

QMAKE_CXXFLAGS_RELEASE -= -O2