[github.io] Convert acle rst to md

[ValeriaDaneva]

No description provided.

[fpetrogalli]

Hi @ValeriaDaneva - unfortunately this PR needs some re-work. There are too many changes in the rst-to-md content change (the second commit) that are unrelated to the syntax change. The huge amount of changes that are not really needed makes it quite difficult to review.

Most of the unrelated changes seems to be coming from situations like the following:

In cases like this, a simple change like replacing the syntax for fixed font text, which would have resulted in one line change in the patch, have become a 4 or 5 line change for a simple rearrangement of the text in the lines. This is (probably) due to the script that you have used to remove the wrong syntax generated by pandoc?

Please go through the rst-to-md content change again and minimize the amount of changes that need to be done for these kind of things. This will make it easier to review, and will also increase the guarantee that what we have is just a syntax change and not a content change. Right now I would have to go through all the paragraphs to make sure that the text is correct to be able to tell if we can merge the patch. Too risky and error prone.

There are also paragraphs that show as changed although there are no real changes in it, just a different length of the line. We better keep those paragraphs to the original version.

I suspect that these useless changes have been introduced by the automatic line justification introduced by pandoc in the conversion process...

[fpetrogalli]

Hi @ValeriaDaneva - thank you for simplifying the changes, this made it much easier to review.

Now, I have left many comments, but most of them are duplicate instances of two issues.

1. The syntax for wrapping C code is not c ... , but triple , followed by c. However, we don't want to introduce C syntax highlighting in this change, just wrap the code with triple
2. Some code (mostly intrinsic definitions) was originally written in rst with the syntax that uses ::. This syntx renders the text as a separate paragraph, not inline. You have replaced this rst syntax with single wrapping, which renders it inline. You have to change these instances by wrapping them with a triple.

There are many instances of both 1. and 2., I haven't marked them all.

Thank you for your patience, we are getting there!

Francesco

[fpetrogalli]

Thank you @ValeriaDaneva ! LGTM