From e9066d0f3db775b25d4d3f713de20f2466b5f7a2 Mon Sep 17 00:00:00 2001
From: Fabian Schuh <mail@xeroc.org>
Date: Mon, 28 Dec 2015 09:42:18 +0100
Subject: [PATCH] bsip#1/template: added summary for shareholders

---
 BSIPs-Template.md | 9 +++++----
 bsip-0001.md      | 9 ++++++++-
 2 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/BSIPs-Template.md b/BSIPs-Template.md
index 789ba0f..237ec61 100644
--- a/BSIPs-Template.md
+++ b/BSIPs-Template.md
@@ -1,18 +1,19 @@
     BSIP: <BSIP number>
     Title: <BSIP title>
     Authors: <list of authors' real names and optionally, email addrs>
-    Status: [ Draft | Accepted | Final | Withdrawn | Deferred | Rejected | Superseded]
+    Status: [ Draft | Accepted | Final | Withdrawn | Deferred | Rejected | Superseded ]
     Type: [ Informational | Protocol ]
     Created: <date created on, in ISO 8601 (yyyy-mm-dd) format>
-    Replaces: <BSIP number>
-    Superseded-By: <BSIP number>
     Discussion: <url>
-    Worker: <Id of worker proposal>
+    Replaces: <BSIP number> (optional)
+    Superseded-By: <BSIP number> (optional)
+    Worker: <Id of worker proposal> (optional)
 
 # Abstract
 # Motivation
 # Rational
 # Specifications
 # Discussion
+# Summary for Shareholders
 # Copyright
 # See Also
diff --git a/bsip-0001.md b/bsip-0001.md
index aceabb8..b9a33e1 100644
--- a/bsip-0001.md
+++ b/bsip-0001.md
@@ -130,13 +130,20 @@ Each BSIP *should* have the following parts:
 * Specification -- The technical specification should describe the syntax and
   semantics of any new feature. The specification should be detailed enough to
   allow competing, interoperable implementations for any of the current
-  BitShares platforms (Satoshi, BitSharesJ, BitShares-js, libBitShares).
+  BitShares platforms.
 
 * Discussion -- The BSIP shall include a discussion on positive and negative
   effects on the BitShares ecosystem shall it be accepted by shareholders. This
   section is supposed to be the most important section for shareholders to grasp
   the full impact of the BSIP and help shareholders to make a decision.
 
+* Summary for Shareholders -- Most BSIPs will probably be of technical nature.
+  However, many shareholders are not as technical as the author of a particular
+  BSIP. This non-technical paragraph serves as a place which can be used to
+  to interact with shareholders and help them form their opinion. It is not
+  meant to be a marketing driven paragraph to convince shareholders to vote
+  **for** or **against** a proposal, though.
+
 # BSIP Formats and Templates
 
 BSIPs should be written in mediawiki or markdown format. Image files should be