summaryrefslogtreecommitdiff
path: root/36/b173fade44542c13d3190a575892e00ac04ff4
blob: e6782edc7f30a3663618b9fd9c7bf64eee43a5b4 (plain)
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