The ECMA-335 specification is currently only available in PDF format. Other specifications from Microsoft, like the C# language specification, are available in Markdown format. Is there a plan to publish a plaintext version of ECMA-335, in a format like Markdown?
reflectronic
All 4 comments
@reflectronic Just tried to convert ECMA-335 using https://pdf2md.morethan.io/. Was a bit of a mess. Updating that document to markdown is probably a long thankless task. I don't believe we have any such plans. Unsure if we would want to put that in this repo though. Perhaps in https://github.com/dotnet/designs?
AaronRobinsonMSFT
on 22 May 2020
Well, whichever repo it goes in is ultimately not that important. There is already ECMA-335 related stuff in this repo though, and plenty of other design documents.
probably a long thankless task
Well, since I'm stuck at home, I've got time 馃槃 At least it will fix the unsightly use of Comic Sans
reflectronic
on 22 May 2020
Note that ECMA-335 has copyright license that has to be respected for anything derived from it.
jkotas
on 22 May 2020
FYI, as it happens, I have just recently begun a manual conversion of ECMA-335 to Markdown. It's mostly complete: https://github.com/stakx/ecma-335.
I'd be happy to contribute this to a more official repo if there is interest for it.
(I've also been considering using that Markdown version as a starting point for a Docbook version, which would be more suitable for preparing the standard in a variety of output formats.)
@jkotas, agreed about heeding the copyright. As I understand the ECMA-335 copyright notice, it explicitly allows conversions to different languages and formats, so this shouldn't be a roadblock in principle.
With regard to my Markdown version, I should mention that I did opt to fix some typos and make formatting more consistent in a very few places—those divergences from the original document could possibly be seen as copyright infringements, and may have to be reverted.
stakx
on 29 May 2020
Related issues
bencz
路
3Comments
omajid
路
3Comments
jamesqo
路
3Comments
jkotas
路
3Comments
GitAntoinee
路
3Comments
Most helpful comment
FYI, as it happens, I have just recently begun a manual conversion of ECMA-335 to Markdown. It's mostly complete: https://github.com/stakx/ecma-335.
I'd be happy to contribute this to a more official repo if there is interest for it.
(I've also been considering using that Markdown version as a starting point for a Docbook version, which would be more suitable for preparing the standard in a variety of output formats.)
@jkotas, agreed about heeding the copyright. As I understand the ECMA-335 copyright notice, it explicitly allows conversions to different languages and formats, so this shouldn't be a roadblock in principle.
With regard to my Markdown version, I should mention that I did opt to fix some typos and make formatting more consistent in a very few places—those divergences from the original document could possibly be seen as copyright infringements, and may have to be reverted.