<p><a class="user-mention" data-hovercard-type="user" data-hovercard-url="/hovercards?user_id=49204861" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/lyyva">@lyyva</a> agree, but the framework we currently use for documentation (AsciiDoctor) doesn't make this easy. Almost anything that isn't offered by default is a big pain to integrate.</p>
<p>AsciiDoc poses other significant limitations as well. Most notably, interface options are very limited, which you can see in a front page that is extremely dense with text. This will get progressively worse as the number of docs grows over time.</p>
<p>It makes more sense to me to migrate the whole docs repository away from AsciiDoc to another framework altogether, instead of wrestling with AsciiDoctor for features that are already integrated in other frameworks. When we do this, search will certainly be a required feature.</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/128#issuecomment-486720210">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AJFFTNSJ2XOHZJHCIY677ITPSHEJBANCNFSM4HGJHZIQ">mute the thread</a>.<img src="https://github.com/notifications/beacon/AJFFTNTI3MEXYJMAWVBBUD3PSHEJBANCNFSM4HGJHZIQ.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":"PERSON","message":"@m52go in #128: @lyyva agree, but the framework we currently use for documentation (AsciiDoctor) doesn't make this easy. Almost anything that isn't offered by default is a big pain to integrate.\r\n\r\nAsciiDoc poses other significant limitations as well. Most notably, interface options are very limited, which you can see in a front page that is extremely dense with text. This will get progressively worse as the number of docs grows over time.\r\n\r\nIt makes more sense to me to migrate the whole docs repository away from AsciiDoc to another framework altogether, instead of wrestling with AsciiDoctor for features that are already integrated in other frameworks. When we do this, search will certainly be a required feature.\r\n"}],"action":{"name":"View Issue","url":"https://github.com/bisq-network/bisq-docs/issues/128#issuecomment-486720210"}}}</script>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/bisq-network/bisq-docs/issues/128#issuecomment-486720210",
"url": "https://github.com/bisq-network/bisq-docs/issues/128#issuecomment-486720210",
"name": "View Issue"
},
"description": "View this Issue on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>