Welcome to Codidact Meta!
Codidact Meta is the meta-discussion site for the Codidact community network and the Codidact software. Whether you have bug reports or feature requests, support questions or rule discussions that touch the whole network – this is the site for you.
Add support for AsciiDoc syntax
Add support for AsciiDoc syntax.
I find their syntax very intuitive and enjoyable. For example, numbered lists start with just a period; bulleted, a star. Nested lists don't use whitespace. Links are less verbose. Have a look for yourself! This is a quick reference guide and this is a direct comparison to Markdown.
Asciidoctor has done a great job documenting everything. AsciiDoc syntax is automatically rendered on GitHub and GitLab files that have the .adoc extension.
I would expect a per-user default configuration and a possible toggle at the bottom of posts.
1 answer
I have some concerns:
Complexity
AsciiDoc is unnecessarily complicated. From what I have seen, Codidact runs just fine on Markdown. Even much larger platform Stack Overflow doesn't seem in that much need of it, despite AsciiDoc having more features.
Worth
Considering the votes on this feature request, it seems that not a lot of users are interested. It seems like something that requires high effort[1] but gives low value in return (considering not a lot of users will use this option).
So a question that may be considered is- Is it worth the limited developer time?
Editing
You mentioned that
I would expect a per-user default configuration and a possible toggle at the bottom of posts.
While it is nice to have a per-user default configuration - think about it. This will divide all the posts into Markdown ones and AsciiDoc ones.
This poses a problem for editing.
If someone fluent with Markdown (which I think most active users are by now) wants to help and make the site better, there will be a "formatting-language" barrier that they will have to overcome if they come across a poorly written AsciiDoc post. Vice-versa for when someone fluent with AsciiDoc wants to improve a poorly written Markdown post. While I guess this barrier will not be so big, but it certainly poses an inconvenience.
-
I'm not sure if this is just a two-minute implementation - but I think it will take time - to first add the option - then make the documentation for it in the Help Center - that too for all communities - and this isn't even taking into account the customizations some communities may have asked for. ↩︎
0 comment threads