[bisq-network/bisq-docs] Produce a 'getting started' guide (#45)

[Chris Beams]

cbeams commented on this pull request.



>  
-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.

I agree that "seriously impressive code" is a bit off, tone-wise. This is something that others can say, but that I'd prefer we do not say in our own official documentation. I like what you're attempting to do in this paragraph, getting the reader excited about the principles and technical foundation, while letting them know that "using Bisq won't hurt" but I'd say take another swing at it. It may not be necessary at all to assume that the reader needs Bisq to be "surprisingly approachable", really. You've done a good job in the doc of detailing what matters and leaving out what doesn't. For example, you just tell the reader to go to the downloads page, get the app and install it. You don't do screenshots there, etc, and treat them like children. Anyone who's going to use Bisq should know perfectly well how to handle that kind of stuff; explaining it would be tone-deaf at best, an insult at worst. So I'd say keep striking _that_ tone: one in which you assume the reader is woke AF about Bitcoin, but possibly still a bit new to the space, and wants to get off to a strong start buying and hodling. They've heard about Bisq, gotten that it's the way to go, and reading this now here to get the straight no-fluff from us on how to use it. Doesn't mean the doc can't also be friendly and a pleasure to read. It's both of those and should stay that way.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/bisq-network/bisq-docs/pull/45#discussion_r188728859
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bisq.network/pipermail/bisq-github/attachments/20180516/f4682229/attachment-0002.html>