<p>AsciiDoc is a pleasure to write in, but Asciidoctor is drastically limited in format and features—it's just a big wall of text, no matter what. Most notably, there is no way to provide search, and no way to adjust the UI without tons of work.</p>
<p>Instead of wrestling with this limited framework, it makes more sense to me to consider migrating to another framework that's more feature-rich from the start.</p>
<p>I don't have any specific ideas at the moment, and I don't think this is an urgent priority, but as we have more docs over the next few months (roles docs in particular), the front page will start to get unwieldy.</p>
<p>Therefore I'm creating this issue as a starting point for suggestions and consideration, so that more concrete action can be taken in the next 5-7 months (probably after making a more specific proposal in <a href="https://github.com/bisq-network/proposals">bisq-network/proposals</a> once details are known).</p>
<p>cc <a class="issue-link js-issue-link" data-error-text="Failed to load issue title" data-id="433795632" data-permission-text="Issue title is private" data-url="https://github.com/bisq-network/bisq-docs/issues/128" data-hovercard-type="issue" data-hovercard-url="/bisq-network/bisq-docs/issues/128/hovercard" href="https://github.com/bisq-network/bisq-docs/issues/128">#128</a></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/issues/131">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AJFFTNU4BDER6RA6YDTMYGLPSHFR3ANCNFSM4HIOJ3IQ">mute the thread</a>.<img src="https://github.com/notifications/beacon/AJFFTNVL5FAII5P4YA4MNLDPSHFR3ANCNFSM4HIOJ3IQ.gif" height="1" width="1" alt="" /></p>
<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://github.githubassets.com/images/email/message_cards/header.png","avatar_image_url":"https://github.githubassets.com/images/email/message_cards/avatar.png","action":{"name":"Open in GitHub","url":"https://github.com/bisq-network/bisq-docs"}},"updates":{"snippets":[{"icon":"DESCRIPTION","message":"Migrate Bisq docs to more feature-rich platform (#131)"}],"action":{"name":"View Issue","url":"https://github.com/bisq-network/bisq-docs/issues/131"}}}</script>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/bisq-network/bisq-docs/issues/131",
"url": "https://github.com/bisq-network/bisq-docs/issues/131",
"name": "View Issue"
},
"description": "View this Issue on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>