metron-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Otto Fowler <>
Subject Re: Site-book broken in master
Date Thu, 20 Dec 2018 03:51:50 GMT
Maybe we should consider ascii doc, it shows in github, and can generate
multiple formats.

On December 19, 2018 at 22:49:26, Otto Fowler (

What would help is an automated test the tests all the links as well.

On December 19, 2018 at 19:55:03, Michael Miklavcic ( wrote:

I'd also like to submit a call for suggestions for making this process
simpler. I think we've made some excellent progress towards getting an
html-generated version of our documentation, but it's also proving to be
somewhat error-prone. Github and Doxia have different expectations as to
formatting, and most devs are generally looking at Github rendering only
because we get that for free as part of the Github PR lifecycle. In
addition, images are managed independently. Missing a reference, getting
the relative path wrong, or getting the rewrite rules incorrect will result
in a bad time. I've seen at least a few PR's in recent memory unwittingly
fall into this trap.

On Wed, Dec 19, 2018 at 5:47 PM Michael Miklavcic <> wrote:

> Fix is out in this PR:
> Jira:
> It ended up being a bit bigger than I hoped because we had some remaining
> incompatibilities between our Github markdown and the Doxia-expected
> formatting. This caused a cascade of inconsistent results for anyone
> attempting to generate a page that works in both Github markdown and
> The latest fixes here should address all of this in the parsers
> documentation. I suspect we may have other markdown pages out there that
> will have similar issues, so this PR/Jira/notice should serve as a recipe
> for remedying them in the future.
> Best,
> Mike
> On Wed, Dec 19, 2018 at 3:46 PM Michael Miklavcic <
>> wrote:
>> FYI, site-book is currently broken in master. I think I've found the
>> source of the issue and will be issuing a fix shortly.
>> Best,
>> Mike

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message