Improve gitbook experience

orta · Mar 8, 2016 · 1965b38 · 1965b38
1 parent d8edff0
commit 1965b38
Show file tree

Hide file tree

Showing 5 changed files with 33 additions and 7 deletions.
diff --git a/README.md b/README.md
@@ -84,9 +84,9 @@ Or check [it on GitBook](https://www.gitbook.com/book/orta/pragmatic-ios-testing
 
 | Topics | Last Updated | Length | 
 | -------|----|-----|
-|[What And Why Of The Book](chapters/what_and_why_of_the_book.md)|2016-03-07|Words: 387|
-|[What Is Xctest How Does It Work](chapters/what_is_xctest_how_does_it_work.md)|2015-04-05|Words: 336|
+|[What And Why Of The Book](chapters/what_and_why_of_the_book.md)|2016-03-07|Words: 517|
 |[How Can I Be Pragmatic With My Testing](chapters/how_can_i_be_pragmatic_with_my_testing.md)|2016-03-07|Words: 370|
+|[What Is Xctest How Does It Work](chapters/what_is_xctest_how_does_it_work.md)|2015-04-05|Words: 336|
 |[Types Of Testing](chapters/types_of_testing.md)|2015-04-05|Words: 219|
 |[Unit Testing](chapters/unit_testing.md)|2015-04-05|Words: 0|
 |[Behavior Testing](chapters/behavior_testing.md)|2015-04-05|Words: 0|
@@ -136,9 +136,9 @@ Or check [it on GitBook](https://www.gitbook.com/book/orta/pragmatic-ios-testing
 |[Oss Testing In iOS](chapters/oss_testing_in_ios.md)|2015-04-05|Words: 0|
 |[Restkit Plus Afnetworking](chapters/restkit_plus_afnetworking.md)|2015-04-05|Words: 0|
 |[Moya And Eidolon](chapters/moya_and_eidolon.md)|2015-04-05|Words: 0|
-|[What And Why Of The Book](chapters/what_and_why_of_the_book.md)|2016-03-07|Words: 387|
-|[What Is Xctest How Does It Work](chapters/what_is_xctest_how_does_it_work.md)|2015-04-05|Words: 336|
+|[What And Why Of The Book](chapters/what_and_why_of_the_book.md)|2016-03-07|Words: 517|
 |[How Can I Be Pragmatic With My Testing](chapters/how_can_i_be_pragmatic_with_my_testing.md)|2016-03-07|Words: 370|
+|[What Is Xctest How Does It Work](chapters/what_is_xctest_how_does_it_work.md)|2015-04-05|Words: 336|
 |[Types Of Testing](chapters/types_of_testing.md)|2015-04-05|Words: 219|
 |[Unit Testing](chapters/unit_testing.md)|2015-04-05|Words: 0|
 |[Behavior Testing](chapters/behavior_testing.md)|2015-04-05|Words: 0|

diff --git a/SUMMARY.md b/SUMMARY.md
@@ -1,8 +1,8 @@
 ### Summary
 
 * [Chapters/What And Why Of The Book](chapters/what_and_why_of_the_book.md)
-* [Chapters/What Is Xctest How Does It Work](chapters/what_is_xctest_how_does_it_work.md)
 * [Chapters/How Can I Be Pragmatic With My Testing](chapters/how_can_i_be_pragmatic_with_my_testing.md)
+* [Chapters/What Is Xctest How Does It Work](chapters/what_is_xctest_how_does_it_work.md)
 * [Chapters/Types Of Testing](chapters/types_of_testing.md)
 * [Chapters/Unit Testing](chapters/unit_testing.md)
 * [Chapters/Behavior Testing](chapters/behavior_testing.md)

diff --git a/generators/generate_gitbook.rb b/generators/generate_gitbook.rb
@@ -15,5 +15,7 @@ def create
     end
 
     File.open("SUMMARY.md", 'w') { |f| f.write body }
+    File.open("gitbook_summary.md", 'w') { |f| f.write File.read("chapters/what_and_why_of_the_book.md") }
+
   end
 end
diff --git a/gitbook_summary.md b/gitbook_summary.md
@@ -1,3 +1,27 @@
-### Summary
+## What is this book?
 
-This book is a WIP. May ever get done.
+This is a book that aims to be a down to earth guide to testing iOS applications. It came out of a long period of writing tests to multiple non-trivial Apps whilst working at [Artsy](http://artsy.net). All of which are open source, and available for inspection on the [Artsy Open Source page](http://artsy.github.io/open-source/#ios).
+
+I found very few consolidated resources for testing in iOS general. A lot of the best book advice revolved around reading books about Java and C# and applying the techniques to Objective-C projects. Like any creative output this book does not live in a vacuum, the books I used to get to this point are in the recommendations section.
+
+Finally this is not a generic iOS Testing book. I will not be objective. This is a pragmatic book from a pragmatic programmer known for making things, not architecting beautiful concepts. There will be things you disagree with, and I'm of the _strong opinions, weakly held_ so you're welcome to send me feedback as issues on [orta/pragmatic-testing](https://github.com/orta/pragmatic-testing)
+
+I treat this book very similar to how I would a collection of smaller blog posts, so I aim to have it well hyperlinked. There are a lot of great resources out there, and this can spring you out into other resources. I'd rather not re-write someone when I can quote.
+
+## About the author, and contributors
+
+I'm the head of mobile at Artsy, and I gave myself the title Design Dictator at the open source project [CocoaPods](https://cocoapods.org). My interest in testing piqued when the entire Artsy mobile team became just me, and I realized that I'm going to get the blame for everything from this point forward. Better up my game.
+
+There are a lot of times that I say we, meaning the [Artsy Mobile team](https://github.com/artsy/mobile/). I don't think I would be writing this book without these people contributing testing ideas to our codebase. Thanks, Daniel Doubrovkine, Laura Brown, Ash Furrow, Eloy Durán, Sarah Scott, Maxim Cramer & Dustin Barker. I owe you all.
+
+Finally, I want to thank Danger. She gives me time and space to achieve great things. I wouldn't be the person I am without her.
+
+## Who is it for?
+
+Anyone interested in applying tests to iOS applications. Which hopefully should be a large amount of people. I'm trying to aim this book at myself back in 2012, new to the ideas of testing and seeing a whole world of possibilities, but not knowing exactly where to start or how to continue once I've made one or two tests.
+
+## Swift or Objective-C?
+
+It's easy to get caught up in what's new and shiny, but in reality there's a lot of existing Objective-C code-bases out there. I  will aim to try and cover both Swift and Objective-C. As we have test suites in both languages, some concepts work better in one language vs the other. If you can only read one language, I'm not apologising for that. It's not pragmatic to only focus like that.
+
+One great thing about writing examples in Swift though is that it's far more concise.
diff --git a/pragmatic_testing.epub b/pragmatic_testing.epub
-Original file line number
+Diff line change
@@ Expand Up / @@ -15,5 +15,7 @@ def create @@
         end
         File.open("SUMMARY.md", 'w') { |f| f.write body }
+        File.open("gitbook_summary.md", 'w') { |f| f.write File.read("chapters/what_and_why_of_the_book.md") }
       end
     end