I've created this issue to offset solving this problem until later, rather than trying to solve it during the lifespan of #4.
There's presumably something in the docs toolchain that is doing some additional magic that's beyond RedCloth's basic capabilities, or I've missed something in terms of how I've configured RedCloth, or perhaps how my Ruby code is treating the textile content. Either way, this does not need to be a blocker for the aforementioned pull request to land.
To see what I'm talking about, take a look at my current rendering of the IDL section of the features spec.. The code-fence is rendering to HTML literally:
If I look at our current docs site rendering then it renders a code element within a pre element (which, in itself seems a bit curious) producing the desired result:
I've created this issue to offset solving this problem until later, rather than trying to solve it during the lifespan of #4.
There's presumably something in the docs toolchain that is doing some additional magic that's beyond RedCloth's basic capabilities, or I've missed something in terms of how I've configured RedCloth, or perhaps how my Ruby code is treating the textile content. Either way, this does not need to be a blocker for the aforementioned pull request to land.
To see what I'm talking about, take a look at my current rendering of the IDL section of the features spec.. The code-fence is rendering to HTML literally:
If I look at our current docs site rendering then it renders a
codeelement within apreelement (which, in itself seems a bit curious) producing the desired result: