<p><b>@cbeams</b> commented on this pull request.</p>

<hr>

<p>In <a href="https://github.com/bisq-network/bisq-docs/pull/45#discussion_r188728859">getting-started.adoc</a>:</p>
<pre style='color:#555'>>  
-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.
</pre>
<p>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 <em>that</em> 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.</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/bisq-network/bisq-docs/pull/45#discussion_r188728859">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AkpZtoN0TrBmqeeAKzKHVXrV8uXMFm0kks5tzHDNgaJpZM4TxXG2">mute the thread</a>.<img src="https://github.com/notifications/beacon/AkpZtgwzKx_FP1PL92mb15E672L8FjGoks5tzHDNgaJpZM4TxXG2.gif" height="1" width="1" alt="" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
  <link itemprop="url" href="https://github.com/bisq-network/bisq-docs/pull/45#discussion_r188728859"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>

<script type="application/json" data-scope="inboxmarkup">{"api_version":"1.0","publisher":{"api_key":"05dde50f1d1a384dd78767c55493e4bb","name":"GitHub"},"entity":{"external_key":"github/bisq-network/bisq-docs","title":"bisq-network/bisq-docs","subtitle":"GitHub repository","main_image_url":"https://cloud.githubusercontent.com/assets/143418/17495839/a5054eac-5d88-11e6-95fc-7290892c7bb5.png","avatar_image_url":"https://cloud.githubusercontent.com/assets/143418/15842166/7c72db34-2c0b-11e6-9aed-b52498112777.png","action":{"name":"Open in GitHub","url":"https://github.com/bisq-network/bisq-docs"}},"updates":{"snippets":[{"icon":"PERSON","message":"@cbeams commented on #45"}],"action":{"name":"View Pull Request","url":"https://github.com/bisq-network/bisq-docs/pull/45#discussion_r188728859"}}}</script>
<script type="application/ld+json">{"@type":"MessageCard","@context":"http://schema.org/extensions","hideOriginalBody":"false","originator":"37567f93-e2a7-4e2a-ad37-a9160fc62647","title":"@cbeams commented on 45","sections":[{"text":"","activityTitle":"**Chris Beams**","activityImage":"https://avatars0.githubusercontent.com/u/301810?s=160\u0026v=4","activitySubtitle":"@cbeams","facts":[]}],"potentialAction":[{"targets":[{"os":"default","uri":"https://github.com/bisq-network/bisq-docs/pull/45#discussion_r188728859"}],"@type":"OpenUri","name":"View on GitHub"},{"name":"Unsubscribe","@type":"HttpPOST","target":"https://api.github.com","body":"{\"commandName\":\"MuteNotification\",\"threadId\":331706806}"}],"themeColor":"26292E"}</script>