Proposal: Migrate docs from Markdown to AsciiDoc

16 views
Skip to first unread message

Claude

unread,
Mar 31, 2021, 2:18:19 AM3/31/21
to Smooks Development
Hello all,

I'm proposing that we migrate the website docs to AsciiDoc in order to set up multi-repo docs (i.e., collect docs from the cartridge repos and publish them all on the website). Markdown doesn't seem suited for this use case. For one thing, Markdown doesn't really support including an MD file within another MD. That's already a deal-breaker.

Migration should be easy because Jekyll has a plugin to support AsciiDoc and there are free tools to convert from Markdown syntax to AsciiDoc syntax.

Claude

Tom Fennelly

unread,
Apr 7, 2021, 9:28:44 AM4/7/21
to smook...@googlegroups.com
Sorry for the slow reply Claude.

adocs are great so it's a +1 from me !!

--
You received this message because you are subscribed to the Google Groups "Smooks Development" group.
To unsubscribe from this group and stop receiving emails from it, send an email to smooks-dev+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/smooks-dev/f47387f3-a49f-45b5-abe1-bfae62a23f02n%40googlegroups.com.
Reply all
Reply to author
Forward
0 new messages