1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
Received: from sog-mx-1.v43.ch3.sourceforge.com ([172.29.43.191]
helo=mx.sourceforge.net)
by sfs-ml-4.v29.ch3.sourceforge.com with esmtp (Exim 4.76)
(envelope-from <dave@dtrt.org>) id 1Wp22P-000270-K1
for bitcoin-development@lists.sourceforge.net;
Mon, 26 May 2014 21:02:29 +0000
X-ACL-Warn:
Received: from mail.dtrt.org ([207.192.75.234])
by sog-mx-1.v43.ch3.sourceforge.com with esmtps (TLSv1:AES256-SHA:256)
(Exim 4.76) id 1Wp22O-0004UT-5f
for bitcoin-development@lists.sourceforge.net;
Mon, 26 May 2014 21:02:29 +0000
Received: from harding by mail.dtrt.org with local (Exim 4.72)
(envelope-from <dave@dtrt.org>) id 1Wp1zX-0005qF-TW
for bitcoin-development@lists.sourceforge.net;
Mon, 26 May 2014 16:59:31 -0400
Date: Mon, 26 May 2014 17:01:28 -0400
From: "David A. Harding" <dave@dtrt.org>
To: bitcoin-development@lists.sourceforge.net
Message-ID: <20140526210128.GB24336@localhost.localdomain>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.5.21 (2010-09-15)
X-Spam-Score: -0.7 (/)
X-Spam-Report: Spam Filtering performed by mx.sourceforge.net.
See http://spamassassin.org/tag/ for more details.
-0.7 RP_MATCHES_RCVD Envelope sender domain matches handover relay
domain
X-Headers-End: 1Wp22O-0004UT-5f
Subject: [Bitcoin-development] Announce: Bitcoin.org Developer Documentation
Now Live
X-BeenThere: bitcoin-development@lists.sourceforge.net
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: <bitcoin-development.lists.sourceforge.net>
List-Unsubscribe: <https://lists.sourceforge.net/lists/listinfo/bitcoin-development>,
<mailto:bitcoin-development-request@lists.sourceforge.net?subject=unsubscribe>
List-Archive: <http://sourceforge.net/mailarchive/forum.php?forum_name=bitcoin-development>
List-Post: <mailto:bitcoin-development@lists.sourceforge.net>
List-Help: <mailto:bitcoin-development-request@lists.sourceforge.net?subject=help>
List-Subscribe: <https://lists.sourceforge.net/lists/listinfo/bitcoin-development>,
<mailto:bitcoin-development-request@lists.sourceforge.net?subject=subscribe>
X-List-Received-Date: Mon, 26 May 2014 21:02:29 -0000
Hi all,
The first version of the Bitcoin.org Developer Documentation is now
live. The main URL (below) provides a portal to two main documents, an
overview-level guide and a more detailed reference. The portal page also
links to individual sections of the documentation and noteworthy
off-site documentation:
https://bitcoin.org/en/developer-documentation
In printed pages, the current version is about 130 pages long in total.
Notable parts include:
* Technical, but still plain-English, descriptions of the block chain
and transactions, including several illustrations:
https://bitcoin.org/en/developer-guide#block-chain
https://bitcoin.org/en/developer-guide#transactions
* A description of several different "contracts", including arbitration
contracts, micropayment channels, and coinjoin:
https://bitcoin.org/en/developer-guide#contracts
* Information about wallet formats, including what we hope is a good
introduction to BIP32 HD wallets for people not already familiar with
ECDSA specifics:
https://bitcoin.org/en/developer-guide#wallets
https://bitcoin.org/en/developer-guide#hierarchical-deterministic-key-creation
* A considerable amount of payment processing detail, currently aimed
primarily at developers writing payment-receiving applications for
merchants. It includes a step-by-step description of the BIP70 Payment
Protocol using an actual CGI script example.
https://bitcoin.org/en/developer-guide#payment-processing
https://bitcoin.org/en/developer-guide#payment-protocol
* A description of every RPC included in Bitcoin Core 0.9
cross-referenced with the other sections of the documentation and
augmented with actual examples of the command in use.
https://bitcoin.org/en/developer-reference#remote-procedure-calls-rpcs
* Not a section, but still notable are the over 2,000 cross-references
in the text---there are so many that we hide them by default. Hover
your mouse over a paragraph to see the cross references (in blue) and
hover your mouse over the link to see more information.
Additions and improvements to the text are being worked on right
now, with an average of 200 lines of text being added each day.
We are, however, in need of expert reviewers. Issues can be opened on
the main Bitcoin.org repository:
https://github.com/bitcoin/bitcoin.org/issues/new
(If you find an issue while reading the documentation, please click the
Report An Issue link on the bottom left side---this will automatically
add the URL and nearest HTML anchor to your bug report so we know where
to find what you're talking about.)
We also welcome suggestions about what to write next:
https://github.com/bitcoin/bitcoin.org/wiki/Documentation-TODO
All work has been done by volunteers---and we're always looking for more
contributors. Please feel free to subscribe to our mailing list and say
hello.
https://groups.google.com/forum/#!forum/bitcoin-documentation
And, most importantly, thank you to everyone from the -dev mailing list
who has helped us produce this content over the last 80 days!
Sincerely,
-Dave Harding on behalf of Saïvann Carignan, Greg Sanders, and all the
documentation contributors
--
David A. Harding
|
