<h1>SUBJECT</h1>
<p>Kickstart the Bisq Knowledge Base</p>
<h1>OUTLINE</h1>
<h2>Problems</h2>
<ul>
<li>users raise issues on forum and/or keybase and don't get good responses (or any responses)</li>
<li>documentation is too convoluted, high level and not approachable enough for casual users - self service support is just impossible</li>
</ul>
<h2>Proposed Solutions</h2>
<ul>
<li>Have a knowledge base (<strong>core of this proposal</strong>)</li>
<li>have people who can regularly help users with support issues & an escalation process where higher impact cases are dealt with by Bisq contributors that have the appropriate experience for it (not in this proposal)</li>
<li>have a ticketing system (will be considered later, different proposal)</li>
</ul>
<h3>Knowledge Base</h3>
<ul>
<li>Build knowledge base to serve as practical, to-the-point guide to solve common issues.</li>
<li>Should use Zammad because: active, feature-rich project; multiple admin roles for support staff and translators; WYSIWYG editors (so no pull request workflow needed); self-hosted; has ticketing mechanism if we need it, etc.</li>
<li>Already have ~3 users interested in seeding content, which should cost at max. 2000 BSQ for seeding the content(assuming ~100 BSQ/hour rate for ~20 hours of work, capped at 500 BSQ per contributor)</li>
<li>Compensation and compensation guidelines - we don't yet have a proposal on how this work needs to be reported. We kindly ask contributors to show the value of the work provided (goes without saying: always keeping users' identities secret)</li>
<li>Initial deployment and ongoing hosting costs for this new infrastucture should cost ? BSQ.</li>
</ul>
<h4>How is KB different than Docs?</h4>
<p>KB is a more fluid and tactical set of content pieces. It is meant to be dynamic as the issues appear, more knowledge is gathered and they eventually get a solution in a release or a workaround, for example. Plus, KB articles are more like tutorials and Docs are more like higher level specification of how the system works (non-technically).</p>
<p>KB is also different in the sense that more people cna contribute to them as local relevance asks</p>
<h1>Final Remarks</h1>
<p>This proposal is not a complete solution to Bisq's support needs, but it should get support on the right track in the near-term. More proposals on this front will come regarding ticketing system and processes around managing the knowledge base and a possible support crew as well as related work</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/proposals/issues/156?email_source=notifications&email_token=AJFFTNTTBIVNK6RMRS4LDHDQZTEUXA5CNFSM4J56FGYKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4IB7CT6A">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AJFFTNRJIDMLL42STEWGG2TQZTEUXANCNFSM4J56FGYA">unsubscribe</a>.<img src="https://github.com/notifications/beacon/AJFFTNTUSAVA4NHHOZYYOFTQZTEUXA5CNFSM4J56FGYKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4IB7CT6A.gif" height="1" width="1" alt="" /></p>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/bisq-network/proposals/issues/156?email_source=notifications\u0026email_token=AJFFTNTTBIVNK6RMRS4LDHDQZTEUXA5CNFSM4J56FGYKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4IB7CT6A",
"url": "https://github.com/bisq-network/proposals/issues/156?email_source=notifications\u0026email_token=AJFFTNTTBIVNK6RMRS4LDHDQZTEUXA5CNFSM4J56FGYKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4IB7CT6A",
"name": "View Issue"
},
"description": "View this Issue on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>