[zeromq-dev] RFC in Markdown?
Yurii Rashkovskii
yrashk at gmail.com
Wed May 18 06:07:14 CEST 2016
Hi,
I was wondering if any thought has been given to (potentially) using
Markdown as a format for RFCs? Pieter asked me if I can ask this question
on the mailing list (https://twitter.com/hintjens/status/732779844107415552)
I know Markdown isn't perfect in more than one way, but given its
widespread adoption and support by different tools (of most importance
being GitHub, probably), was there any consideration to switch over or to
duplicate them in Markdown (if there are automated converters between the
syntaxes)?
In another project's RFC repository, I've decided to use it and it is
giving me immediate results, such as:
1. Being able to preview resulting markdown when editing using GitHub
editing tools (great way to contribute to RFCs quickly without having to go
through branching on a laptop)
2. Being able to see the formatted text of the RFC right on GitHub:
https://github.com/eventsourcing/rfc/tree/master/1
3. Being able to use gitbooks to enable even nicer layout and beautiful
search: http://rfc.eventsourcing.com/1/
4. Being more open for contributions as a lot more people are familiar and
comfortable with Markdown (totally an unscientific observation!).
Thanks!
--
Y.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.zeromq.org/pipermail/zeromq-dev/attachments/20160517/ab3b3b5a/attachment.htm>
More information about the zeromq-dev
mailing list