On Tue, 2017-07-04 at 06:34 +0000, Steenbergen, Thomas wrote:
Hi all,

Wanted to let you all know that after several months in the making I pushed my 
MarkDown conversion of the SPDX specification 2.1 to  
https://github.com/spdx/spdx-spec/<https://emea01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fspdx%2Fspdx-spec%2F&data=01%7C01%7C%7Cf2120f455d4f4faac95608d4c2558dd9%7C6d4034cd72254f72b85391feaea64919%7C1&sdata=3L8REnWI8Ovt8OgAVdlA8t1DhAktLjgqQ1IqQjjAJ9g%3D&reserved=0>

This is great news! Thanks for doing this work, I will use this.

Regards,

Jeremiah


Benefits


·         Working on GitHub and using MarkDown should make it easier for people 
to contribute either via Git, editing files online or by filling issue

·         Specification now be build as HTML, PDF, ePUB or Mobipocket

·         HTML version is now mobile friendly and PDF has a table of contents

·         Every change on master branch is automatically build and deployed as 
HTML to 
https://spdx.github.io/spdx-spec/<https://emea01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fspdx.github.io%2Fspdx-spec%2F&data=01%7C01%7C%7Cf2120f455d4f4faac95608d4c2558dd9%7C6d4034cd72254f72b85391feaea64919%7C1&sdata=J8QzqaphIudJs%2FF60l6VrCbGB88bfmiGFlZrDAPKMbI%3D&reserved=0>
 (using Travis CI)

Limitations

·         Simplified lay-out as MarkDown has some limitations compared to 
Google Docs. See for example table of contents – no section included due not 
being able to directly link to sections within different chapters

To Do

·         Write CONTRIBUTING.md  - explain to contributors how they can 
participate in shaping future version of the specification. Propose we discuss 
best workflow in the next call.

·         Minor issues - broken links, lay-out issues or spelling mistakes in 
original specification

·         Introduce workaround for MarkDown shortcomings in HTML version

·         Automate publishing of PDF, ePUB, Mobipocket to GitHub Releases for a 
new version of specification

·         Upgrade to GitBook 4.x when it becomes available



All fixes will be made on the development/2.1.1 branch. If you find something 
feel free to send me an email or raise an issue.

Regards,

Thomas Steenbergen
Principal Engineer Open Source Governance and Policy

HERE Deutschland GmbH, Place of Business: Invalidenstraße 116, 10115 Berlin, 
Germany – Commercial Register: Amtsgericht Charlottenburg, HRB 106443B - 
USt-IdNr.: DE 812 845 193 - Managing Directors: Michael Bültmann, Robertus A.J. 
Houben




_______________________________________________
Spdx-tech mailing list
[email protected]<mailto:[email protected]>
https://lists.spdx.org/mailman/listinfo/spdx-tech


________________________________

This e-mail and any attachment(s) are intended only for the recipient(s) named 
above and others who have been specifically authorized to receive them. They 
may contain confidential information. If you are not the intended recipient, 
please do not read this email or its attachment(s). Furthermore, you are hereby 
notified that any dissemination, distribution or copying of this e-mail and any 
attachment(s) is strictly prohibited. If you have received this e-mail in 
error, please immediately notify the sender by replying to this e-mail and then 
delete this e-mail and any attachment(s) or copies thereof from your system. 
Thank you.
_______________________________________________
Spdx-tech mailing list
[email protected]
https://lists.spdx.org/mailman/listinfo/spdx-tech

Reply via email to