Start to document branch coverage

1 files changed, 24 insertions, 0 deletions

diff --git a/doc/branch.rst b/doc/branch.rst
new file mode 100644
index 00000000..5419d1c1
--- /dev/null
+++ b/doc/branch.rst
@@ -0,0 +1,24 @@
+Coverage.py now supports branch coverage
+
+- How to use it.
+
+- Reporting
+
+- How it works
+
+- Odd cases
+
+    - yellow-pink syndrome:
+    
+        Y       if never_true:
+        P           never_executed()
+    
+    - while True is marked as yellow
+
+    - except ValueError will be marked as yellow if you never see a different exception.
+    
+- Exceptions?
+
+    - What should we do with the info about unpredicted arcs?
+
+- Excluding. Does it work?