Misc doc updates

Co-Authored-By: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>

docs/source/theory/philosophy.rst

@@ -2,28 +2,30 @@ Philosophy
 ==========
 
 
-We Provide a Single Static Binary
----------------------------------
+Single Static Binary
+--------------------
 
-- Because it makes deployments easier.
+- Deployment is then as simple as it gets.
+
+- Docker-friendly.
 
 
 Shell Agnostic
 --------------
 
-- Kapow! knows nothing about the shell you are using.
-- It only spawns executables.
-- You can use anything you want that ends interacting with the `data
-  api`.
-- This helps with multiplatform and with future higher level tools.
+- Kapow! knows nothing, and makes no assumptions, about the shell you are using.
+  It only spawns executables.
+
+- You are free to implement a client to the Data API directly if you are so
+  inclined. The spec provides all the necessary details.
 
 
 Not a Silver Bullet
 -------------------
 
-You should not use Kapow! for projects with complex business logic.
+You should not use Kapow! if your project requires complex business logic.
 
 If you try to encode business logic in a shell script, you will **deeply**
 regret it.
 
-Kapow! is for automating simple stuff.
+Kapow! is designed for automating simple stuff.