bisq-network · cbeams · May 28, 2018 · May 3, 2018 · May 2, 2018 · May 2, 2018
diff --git a/getting-started.adoc b/getting-started.adoc
@@ -1,3 +1,229 @@
 = Getting Started with Bisq
+:toc: left
+:sectanchors:
+:imagesdir: images
+:!figure-caption:
+:btc-deposit: 0.01
+:btc-deposit-plus-fees: 0.011
 
-COMING SOON. Subscribe to https://github.com/bisq-network/bisq-docs/issues/37[bisq-network/bisq-docs#37] for updates.
+Bisq is built on some https://bisq.network/philosophy/[serious principles^] and some https://github.com/bisq-network[seriously impressive code^], but it's surprisingly approachable. This guide will help you get up & running quickly.
+
+Here we're going to assume you want to trade a national currency for bitcoin, since that's how most people get started with Bisq. But keep in mind Bisq offers trading for a range of other coins too—the only constraint is that one side of the trade must always be in bitcoin.
+
+== Download & install
+
+To run Bisq, download it from https://bisq.network/downloads/[the Bisq downloads page^]. _Optional:_ before installing, verify the signatures of the downloaded file (https://www.torproject.org/docs/verifying-signatures.html.en[instructions here^]) to be sure the file you downloaded is genuine.
+
+[NOTE]
+.Why do I need to download software? Why can't I just trade on your website?
+====
+Unlike most exchanges, Bisq doesn't run a central server to take/place offers, so trading on a website isn't possible.
+
+Instead, Bisq routes trades through a peer-to-peer network—a global network of people who are also running Bisq's software on their own computers.
+
+If you want to tap into this network, you've got to download & run the software too!
+====
+
+Once the installer is done, go ahead and open Bisq. It'll take a few moments to open as it connects to Tor and Bisq's peer-to-peer trading network.
+
+When that's done, feel free to have a look around Bisq. You can browse buy offers, sell offers, and tweak your account settings.
+
+== Configure a national currency account
+
+Since we're looking to buy bitcoin, let's take a look at the Buy BTC panel. You should see a list of offers, but you'll notice all the orange Buy BTC buttons are disabled:
+
+.Before configuring a payment account: all offers are disabled.
+image::before-adding-fiat-account.png[Offers disabled before configuring national currency account]
+
+That's because we haven't set a way to actually pay for the bitcoin we want to buy. So let's set up a payment method. Bisq works with many different payment methods, so you can choose those you already have access to & are most comfortable using. Keep in mind payment methods determine:
+
+* which offers you can take right now (e.g., in the image above, Zelle has many outstanding offers, so if we set up Zelle, we could immediately take any of those offers)
+* how quickly a trade can be completed (e.g., a bank transfer will go through quicker than a money order sent by mail; see https://bisq.network/faq/#5[details here^])
+
+[NOTE]
+.What if there are no outstanding offers for the payment method I want to use?
+====
+If you don't see any offers for the payment method you want to use, consider checking back later. A Bisq offer is only available while the user making the offer is online and running Bisq, so you'll see offers come and go as Bisq users around the world go online and offline throughout the day.
+
+You can also create your own buy offer with the "Create New Offer to Buy BTC with USD" button on the bottom-right, but we won't go into those details here.
+====
+
+[NOTE]
+.Where is my payment account data stored?
+====
+On your computer *only* (i.e., the computer on which Bisq is installed). Only your trading partner (and your arbitrator, if there's a dispute) will ever see your payment details.
+====
+
+In this tutorial, we're going to configure a Zelle account. You can adapt the instructions that follow to the payment method you choose.
+
+Go to the Account panel and click "Add New Account." Pick Zelle from the dropdown and enter your details. 
+
+For Zelle, we need to enter Full Name and Email/Mobile Number.
+
+.Configuring a Zelle account.
+image::configure-fiat-account.png[Configuring a national currency account]
+
+You don't need to edit the "Salt" field. You can keep the "Account Name" unchanged or make it whatever you like: it's just a label only you will ever see, so there's no right or wrong value for it.
+
+IMPORTANT: It's *crucial* the information you enter here is correct. Your trading partner can only acknowledge your payment if it's from the account detailed here. Once you've created an account, you cannot edit its information (if you need to make a change, you can delete & add the account again).
+
+Once you're done, hit the "Save New Account" button and go back to the Buy BTC panel. Offers requiring the payment method you just configured should now be enabled:
+
+.After configuring a payment account: we picked Zelle, so Zelle offers are now enabled.
+image::after-adding-fiat-account.png[Configuring a national currency account]
+
+== Get a security deposit
+
+Just 1 more thing to do before we can trade with Bisq: we need to obtain enough bitcoin for a security deposit.
+
+To prevent fraud, Bisq requires buyers and sellers to post a security deposit in bitcoin for every trade. On the buy side, it's {btc-deposit} BTC, along with a trading fee & mining fees for the transfers.
+
+As of this writing, that means you'll need {btc-deposit-plus-fees} BTC.
+
+If you don't already own this bitcoin, you'll need to obtain it. How? You've got options. Do you have any friends or family who could help? Otherwise, you can try a local bitcoin ATM (many don't require ID for small transactions), vouchers, or bitcoin meetups/events.
+
+[WARNING]
+.How about getting bitcoin through an exchange like Coinbase?
+====
+Most centralized exchanges (like Coinbase, Binance, Kraken, etc) track your personal information, putting you at risk by tying your identity with your bitcoin.
+
+Bisq is built from the ground up to avoid this privacy fiasco, so we highly recommend you get your first bitcoin through one of the other channels mentioned above.
+====
+
+Once you've gotten enough bitcoin for your security deposit, you can move it into Bisq's built-in wallet. This isn't required, but it'll be more convenient because it'll make the security deposit & fees that Bisq needs to accept an offer readily available.
+
+IMPORTANT: If you decide to use a Bisq wallet, make sure you write down its seed words. Seed words will allow you to recover the funds in your wallets in case of disaster. You'll find them in the "Wallet Seed" section of the Account panel. Learn more about wallet security https://bitcoin.org/en/secure-your-wallet[here^].
+
+To send bitcoin to your Bisq wallet, go to the Funds panel and click the Receive tab. Send your 0.011 BTC to one of the addresses listed there.
+
+.You can send your security deposit to an address listed here (yours will be different from the one in this image).
+image::fund-bisq-wallet.png[Fund your Bisq wallet]
+
+If you'd rather not hold any bitcoin in Bisq, that's fine, but you'll need to transfer your security deposit & fees to Bisq yourself when you take an offer (more on this below).
+
+== Take an offer
+
+:figure-caption: Figure
+
+Now that we've gotten setup out of the way, let's do a trade!
+
+=== 1. Select an offer
+
+[.float-group]
+--
+[.right.text-center]
+.Select an offer you like.
+image::select-an-offer.png[Select an offer,400,400]
+
+Back in the Buy BTC panel, click the orange "Take Offer" button for the offer you'd like to take.
+
+--
+
+=== 2. Send deposit to trade wallet
+
+[.float-group]
+--
+[.right.text-center]
+.Send this much bitcoin to this address.
+image::deposit-details.png[Deposit details,400,400]
+
+Once you choose an offer, Bisq creates a special trade wallet to hold both parties' bitcoin (your security deposit, the seller's security deposit, and the seller's bitcoin) while you send payment to the seller.
+
+It works like an escrow account: funds in the wallet can only be released once you and the seller have satisfied your ends of the deal.
+
+Bisq will tell you the address of the trade wallet & exactly how much to send it. 
+
+* If you already have enough bitcoin in a Bisq wallet, click "Transfer Funds From Bisq Wallet" and the funds will automatically transfer to the trade wallet.
+* If not, go ahead and send the amount required ("Funds Needed") to the specified address ("Trade Wallet Address"). See Figure 2.
+--
+
+[NOTE]
+.An escrow account? How does that work?
+====
+Bisq never holds any bitcoin or national currency. The trade wallet is actually a 2-of-3 multisignature setup involving you, the seller, and a https://bisq.network/faq/#8[bonded arbitrator^]. More details are https://bisq.network/faq/#18[here^] and you can read more about multisig wallets https://en.bitcoin.it/wiki/Multisignature[here^].
+====
+
+=== 3. Confirm trade
+
+Once you've funded your trade wallet, you'll see a "Review: Take Offer to Buy Bitcoin" button appear.
+
+Click it, and Bisq will then show you all the details of the offer you're about to take.
+
+.Look over these details carefully.
+image::confirm-deal.png[Confirm deal details]
+
+*Make sure these details are correct.* After you confirm these details, there's no backing out—you must follow through (or risk losing your deposit).
+
+If it all looks good, go ahead and hit "Confirm: Take Offer to Buy Bitcoin."
+
+Your deal is now officially happening!
+
+=== 4. Send payment
+
+[.float-group]
+--
+
+[.right.text-center]
+.Payment details pop-up.
+image::seller-payment-details.png[Seller payment details,400,400]
+
+Now that you've taken an offer, it's time to pay the seller. Almost.
+
+First, before showing you the seller's payment details, Bisq will wait for the Bitcoin network to confirm the trade's transactions. On average, this takes 10 minutes.
+
+Then, you'll see a pop-up with the seller's details. Go ahead and pay the seller through the agreed payment method.
+
+[NOTE]
+.Confirmations?
+====
+Each confirmation makes a bitcoin transaction exponentially harder to reverse. You can wait for as many confirmations as you like before sending payment—just note the remaining time indicator. The seller must _receive_ your payment before that timer runs out.
+
+.Make sure the seller receives your payment before this timer runs out.
+image::remaining-time-to-pay.png[Send payment quickly]
+
+Learn more about confirmations https://en.bitcoin.it/wiki/Confirmation[here^].
+====
+
+--
+
+=== 5. Mark payment as sent
+
+[.float-group]
+--
+
+[.right.text-center]
+.Mark payment as sent.
+image::mark-payment-sent.png[Mark payment as sent,400,400]
+
+Once you've sent your payment, be sure to mark the payment as sent in Bisq.
+
+It's easy to forget this step, but remember: to maximize your privacy, Bisq doesn't actually integrate with national currency payment methods—so it won't know you've sent your payment until you tell it.
+
+--
+
+=== 6. Complete trade
+
+[.float-group]
+--
+
+[.right.text-center]
+.Trade complete!
+image::complete-trade.png[Complete trade,400,400]
+
+When the seller receives your payment, they'll mark it as received in Bisq. Bisq will then complete the trade by releasing the bitcoin you bought to you (along with your deposit).
+
+You can keep your new bitcoin in a built-in Bisq wallet (click "Move Funds to Bisq Wallet"), or send it somewhere else (click "Withdraw to External Wallet").
+
+--
+
+Congratulations. You've just completed your first trade on Bisq!
+
+== Get help
+
+If you get stuck, reach out! There's a community of people to help you on https://bisq.community/[the forums^], https://www.reddit.com/r/bisq//[/r/bisq on reddit^], and https://t.me/bisq_p2p[Telegram^].
+
+== Stay in touch
+
+If Bitcoin's motto is "be your own bank" then Bisq's motto is "be your own exchange." It's an exciting concept, it's growing fast, and it's something you'll want to follow.
+
+Get Bisq updates on https://twitter.com/bisq_network[Twitter^], https://www.facebook.com/bisqnetwork/[Facebook^], and https://www.youtube.com/c/bisq-network[YouTube^].
diff --git a/images/after-adding-fiat-account.png b/images/after-adding-fiat-account.png
diff --git a/images/before-adding-fiat-account.png b/images/before-adding-fiat-account.png
diff --git a/images/configure-fiat-account.png b/images/configure-fiat-account.png
diff --git a/images/confirm-deal.png b/images/confirm-deal.png
diff --git a/images/deposit-details.png b/images/deposit-details.png
diff --git a/images/fund-bisq-wallet.png b/images/fund-bisq-wallet.png
diff --git a/images/mark-payment-sent.png b/images/mark-payment-sent.png
diff --git a/images/remaining-time-to-pay.png b/images/remaining-time-to-pay.png
diff --git a/images/select-an-offer.png b/images/select-an-offer.png
diff --git a/images/seller-payment-details.png b/images/seller-payment-details.png