On 7 March 2015 at 00:40, Mads Kiilerich <[email protected]> wrote: >> How do other projects do this? Trac, Redmine, etc. all have some fancy >> formatting that seems to work-ish? > > > I remember Trac being annoying too. It might be work-ish but I think it > would work better without markup.
Not being able to do monospaced code in comments is a genuinely annoying limitation. The way Markdown handles this is quite nice, as it just assumes that any block indented 4+ spaces is code. To be honest, that plus automatically linkifying anything that looks like a URL, and having a regex that picks up references to issues, PRs and commits and also turns those into links would cover pretty much everything you really need. I agree with the notion that ReST is just a plain poor fit for comment formatting though - it's definitely more appropriate for "more complex than a single article" use cases, where you can actually make use of the role-based cross referencing capabilities. Cheers, Nick. -- Nick Coghlan | [email protected] | Brisbane, Australia _______________________________________________ kallithea-general mailing list [email protected] http://lists.sfconservancy.org/mailman/listinfo/kallithea-general
