Merge pull request #451 from bast/chapter-15-readme

provide context for chapter 15; closes #394

Author: bast

README.md

@@ -166,4 +166,4 @@
 - [Using the ThreadSanitizer and reporting data races to CDash](chapter-14/recipe-04/README.md)
 
 
-### [Chapter 15: Porting a Project to CMake](https://github.com/dev-cafe/vim/compare/master...cmake-support)
+### [Chapter 15: Porting a Project to CMake](chapter-15/README.md)

chapter-15/README.md

@@ -0,0 +1,16 @@
+
+
+# Chapter 15: Porting a Project to CMake
+
+The final chapter of the cookbook demonstrates step-by-step how to port a
+non-trivial project to CMake.
+
+The example project is the source code behind the popular editor Vim
+(https://www.vim.org) in which we port the configuration and compilation from
+Autotools to CMake.
+
+Here we link to the diff between "before" and "after":
+https://github.com/dev-cafe/vim/compare/b476cb7...cmake-support
+
+However, this diff probably only makes sense in combination with the textbook
+in contrast to all other recipes which can be reused also independently.

contributing/generate-readmes.py

@@ -88,7 +88,7 @@ def generate_main_readme(directory_of_this_script, chapters, chapter_titles,
         # chapter 15 is hard-coded
         # since it points to an outside diff
         f.write(
-            '\n\n### [Chapter 15: Porting a Project to CMake](https://github.com/dev-cafe/vim/compare/master...cmake-support)\n'
+            '\n\n### [Chapter 15: Porting a Project to CMake](chapter-15/README.md)\n'
         )
 
 
@@ -99,6 +99,10 @@ def locate_chapters_and_recipes(directory_of_this_script):
     paths = (directory_of_this_script.parent).glob('chapter-*')
     chapters = sorted((path.parts[-1] for path in paths))
 
+    # chapter 15 is different and "hardcoded"
+    # so we remove it from the list of chapters to process
+    chapters.remove('chapter-15')
+
     recipes = {}
     for chapter in chapters:
         paths = (directory_of_this_script.parent / chapter).glob('recipe-*')