Title: Review for bitcoin.org FAQ Post by: blockgenesis on August 24, 2013, 03:32:02 AM I have just completed a second draft for a FAQ on bitcoin.org.
The result can be previewed live here : ---- Edit : After weeks of review, the FAQ is live: http://bitcoin.org/en/faq. Thanks everyone! More reviews will be useful. If you wish to, please leave a comment and concrete suggestions of improvement if you find: - More or less accurate or ambiguous assertions. - Texts that you think are unrelevant. - Sentences that are poorly written or typos. - Missing important informations. -- The goal for this FAQ is to remain an accessible, objective and concise informative resource with a special interest about recurring myths and concerns. Once completed and published, it will also be possible to translate this FAQ just like the rest of the website, allowing us to potentially have a good international FAQ. Thanks in advance Title: Re: Review for bitcoin.org FAQ Post by: ANX_Service on August 24, 2013, 04:01:57 AM A very thorough update. Thank you. Will review properly in the coming days.
Cheers ANX.HK (http://ANX.HK) Title: Re: Review for bitcoin.org FAQ Post by: 🏰 TradeFortress 🏰 on August 24, 2013, 04:17:21 AM Quite nice. I've got a suggestion for "I'd like to learn more. Where can I get help?" through - when people want to get help, they probably don't want to go through a couple of resources. I suggest linking to #bitcoin's freenode webchat and bitcoin.stackexchange directly.
Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on August 24, 2013, 02:11:14 PM A very thorough update. Thank you. Will review properly in the coming days. Cheers ANX.HK (http://ANX.HK) Thanks! Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on August 24, 2013, 02:14:23 PM Quite nice. I've got a suggestion for "I'd like to learn more. Where can I get help?" through - when people want to get help, they probably don't want to go through a couple of resources. I suggest linking to #bitcoin's freenode webchat and bitcoin.stackexchange directly. Perhaps integrating the Freenode webchat there could make sense. Though what I appreciated with the idea of linking the community and resources pages, since these pages are aimed to show different communities and websites based on the language of the user reading the FAQ in the future. Also, it gives users more than just one choice in case they don't like IRC for example and prefer live meetups, or then again, if they don't get a satisfying answer on IRC they can try elsewhere. Title: Re: Review for bitcoin.org FAQ Post by: giszmo on August 24, 2013, 04:20:39 PM The who invented Bitcoin section dives right into defending foss. I would split that into why should people trust an anonymous inventor?
Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on August 30, 2013, 03:43:37 AM Anyone else want to review and comment?
Title: Re: Review for bitcoin.org FAQ Post by: remotemass on September 01, 2013, 10:13:14 PM Many people ask:
How do bitcoins look like? Title: Re: Review for bitcoin.org FAQ Post by: Mike Hearn on September 04, 2013, 08:52:28 AM Could someone please help Saivann by proof-reading the latest draft? It has got some typos and spelling issues in it, and someone needs to go over it carefully to ensure we found them all.
Title: Re: Review for bitcoin.org FAQ Post by: runam0k on September 04, 2013, 09:19:06 AM I can take a look but the page is blocked here at work. Any alt url or cached copy? Or can someone paste it into an email and send to runam0k at outlook dot com?
Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on September 04, 2013, 03:06:08 PM I can take a look but the page is blocked here at work. Any alt url or cached copy? Or can someone paste it into an email and send to runam0k at outlook dot com? I just sent you the FAQ by email, thanks! Title: Re: Review for bitcoin.org FAQ Post by: Jan on September 04, 2013, 05:58:44 PM I just read through the FAQ. Kudos to blockgenesis. I couldn't have done it any better.
Title: Re: Review for bitcoin.org FAQ Post by: d'aniel on September 05, 2013, 10:49:36 AM Just gave the FAQ a read-through, content looks pretty good. Here are my notes (they're in order, but ctrl-f should find the relevant spots - sorry, I would've edited the full document in retrospect):
I only made it to the "Is Bitcoin mining a waste of energy?" section. I have to go to bed now, but I'll try to finish the rest off tomorrow if nobody else does. Thanks for writing this blockgenesis! Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on September 05, 2013, 01:13:12 PM Just gave the FAQ a read-through.. Thank you so much for this help, I started applying your changes and they should be in the pull request later today. Title: Re: Review for bitcoin.org FAQ Post by: saif313 on September 05, 2013, 01:47:39 PM its very helpful good work
Title: Re: Review for bitcoin.org FAQ Post by: Mike Hearn on September 05, 2013, 05:52:15 PM d'aniel, you rock as always.
The 'existence proof' thing actually came from me (I wrote the answer to that question). It's a term I've seen used a few times, but you're right that it's probably a bit weird/unusual for the FAQ. Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on September 05, 2013, 06:26:27 PM Thanks for your appreciation and for your help. I received another set of fixes from runam0k by email. I'll report there once I've completed this work. Nearly all d'aniel fixes are now already merged and pushed. The live preview should always be up to date with the latest changes. If you want to give help, I'd say, start with the end (since most reviewers often don't get to this part).
It is worth noting that many people deserve credits for this work, including Mike Hearn, Trace Mayer and the people who wrote the existing Wiki FAQ. Not to mention various quotes from respected people in this community ( Gavin Andresen, Patrick Murck, Roger Ver, Tony Gallippi and so on.. ) on which many texts are based or important projects like Andreas mobile wallet app, usebitcoins.info or blockchain.info that are adding pictures and reality to words. While I wrote many parts of this FAQ, the real value of this work resides in the rich ecosystem around Bitcoin and I hope that once published, this FAQ will serve as a good explanation for the most amazing invention of our times. Title: Re: Review for bitcoin.org FAQ Post by: d'aniel on September 06, 2013, 04:01:48 AM Here are my edits to the rest of the FAQ:
Isn't Bitcoin mining a waste of energy? Spending energy Bitcoin mining has been designed to become more optimized over time with specialized hardware How does mining help secure Bitcoin? Mining creates the What do I need to start mining? In the early days, anyone could find new blocks using standard computers['] CPUs. As more and more people started mining, the difficulty of finding new blocks has greatly increased to the point where the only cost-effective method of mining is using specialized hardware (ASICs). You can visit BitcoinMining.com for more information. Security Is Bitcoin secure? The Bitcoin technology - the protocol and the cryptography - has a strong security track record[,] and the Bitcoin network is probably the biggest distributed computing project in the world. Bitcoin's vulnerability is in user error. Bitcoin wallet files that store the necessary private keys can be accidentally deleted, lost or stolen. This is pretty similar to physical cash Hasn't Bitcoin been hacked in the past? The Bitcoin protocol There Could users collude against Bitcoin? It isn't possible to change the Bitcoin protocol with a majority of users or miners. Any miner that doesn't comply with the protocol immediately generates a chain fork[,] as the rest of the network [- non-mining nodes included -] However, a majority of miners could arbirarily choose to block or reverse targeted recent transactions. This could be used for censorship purposes or to defraud Is Bitcoin vulnerable to quantum computing? Yes, and so are all systems relying on cryptography in general[,] including current banking systems. However, quantum computers don't yet exist and probably won't for a while. In the event that quantum computing could be an imminent threat to Bitcoin, the protocol could be upgraded to use new algorithms. Given the importance that this update would have, it can be safely expected that it would be highly reviewed by developers and adopted by all Bitcoin users. Can't Bitcoin be cracked or shutdown? Bitcoin is likely to survive almost anything. The real question is Even though technical failures are possible, Bitcoin has demonstrated its ability to withstand various forms of attacks for years[,] and the discovery of new technical issues would likely only lead to further improvements. Bitcoin use could however be made difficult by restrictive regulations, in which case it would be hard to determine what percentage of users would keep using the technology. A government that chooses to make Bitcoin illegal would prevent many domestic businesses and markets from developing, shifting innovation to other countries. Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on September 06, 2013, 04:08:23 AM Thanks a lot d'aniel, that's really appreciated. I will review and merge your last proposed changes tomorrow.
Title: Re: Review for bitcoin.org FAQ Post by: d'aniel on September 06, 2013, 04:24:17 AM The 'existence proof' thing actually came from me (I wrote the answer to that question). It's a term I've seen used a few times, but you're right that it's probably a bit weird/unusual for the FAQ. Perhaps it was just sounding weird to me, but I've always heard a proof that a conjecture is false referred to as a counterexample. When I read "existence proof", it made me think "existence theorem".Title: Re: Review for bitcoin.org FAQ Post by: Mike Hearn on September 06, 2013, 09:32:05 AM Great! I'm hoping we can launch this soon.
Saivann, it might be cool to have HTML anchors for each question so it's possible to link inside the document, as it's quite large now. Title: Re: Review for bitcoin.org FAQ Post by: amincd on September 06, 2013, 10:31:18 AM Here's what I have so far:
Who created Bitcoin? Bitcoin is The anonymity of Satoshi often raise Who controls the Bitcoin network? Just like nobody owns the technology behind email, nobody owns the Bitcoin network. Bitcoin is controlled by all Bitcoin users around the world. While developers are improving the software, they can't force a change in the Bitcoin protocol because all users are free to choose what software and version they use. In order to stay compatible with each other, all users need to use software complying with the same rules. Bitcoin can only work correctly with a complete consensus between all users. Therefore, all users and developers have a strong incentive to adopt and protect this consensus. This also means that if something is wrong, all users and developers have a strong incentive to help fix How does Bitcoin work? From a user perspective, Bitcoin is simply a mobile app or computer program that provides personal Bitcoin addresses and allows one to send and receive bitcoins with them. That pretty much sums up how Bitcoin works for most users. Behind the scenes, the Bitcoin network is sharing a public ledger called the "block chain". This ledger contains every transaction ever processed, allowing a user's computer to verify the validity of each transaction. Users can create an unlimited number of Bitcoin addresses. These addresses are used to define where bitcoins are sent to and where they come from. The authenticity of each transaction is protected by digital signatures corresponding to the sending address, allowing all users to have full control over sending bitcoins from their own Bitcoin addresses. In addition, anyone can process transactions using the computing power of specialized hardware and earn a reward in bitcoins for this service. This is often called "mining". To learn more about Bitcoin, you can consult the dedicated page and the original paper. Is Bitcoin really used by people? Yes. There is a growing number of businesses and individuals using Bitcoin, including brick and mortar businesses like restaurants and popular online services such as Namecheap, Reddit, WordPress and Flattr. While Bitcoin remains a relatively new phenomenon, it is growing fast. At the end of August 2013, the value of all bitcoins in circulation was in excess of US$ 1.5 billion with millions of dollars exchanged daily through up to 70,000 transactions. ** How difficult is it to make a Bitcoin payment? Bitcoin payments are easier to make than debit or credit card purchases, and can be received without any merchant account. Payments are made from a wallet application, either on your computer or smartphone, by entering the recipient's address, the payment amount, and pressing send. To make it easier to enter a recipient's address, many wallets can obtain the recipient's address by scanning a QR code or touching two phones together with NFC technology, and Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on September 06, 2013, 02:17:23 PM Mike Hearn: Absolutely, there is already a table of content at the beginning of the page with anchor links to each question. The anchor links can be translated like the rest of the FAQ. I wanted each question to be linkable and referenced on Google individually. Just let me know if you see that I'm missing something.
amincd: Thanks! Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on September 06, 2013, 05:37:13 PM Ok, I have reviewed all proposed changes from runam0k, d'aniel, Mike Hearn, amincd and other people at the Foundation. Most of them are merged. I will look back at these changes later today or tomorrow to check if some of them would be worth some more discussion.
Meanwhile I've updated the branch and the live preview, feel free to provide additional suggested improvements, it's always useful. Title: Re: Review for bitcoin.org FAQ Post by: blockgenesis on September 13, 2013, 05:34:38 PM Well thank you very much everyone for your help. After weeks of continuous reviews and improvements, the FAQ is now live!
http://bitcoin.org/en/faq |