+1 for Markdown, and +2 for reStructuredText :-) I would see the field list feature of rst to be useful when describing the attributes.
-- zvr -----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of Philippe Ombredanne Sent: Wednesday, December 16, 2015 9:33 AM To: Manbeck, Jack <[email protected]> Cc: [email protected] Subject: Re: Using markdown for the SPDX Specs On Tue, Dec 15, 2015 at 9:27 PM, Manbeck, Jack <[email protected]> wrote: > Kate, > We have been kicking around how to do a web version of the specification. > Using markdown may be the answer. We could convert that to HTML or > even PDF, etc. for the website. I’ve copied the list as well as > others may have some thoughts. We’ve been using it internally here at > TI to generate documents and like it but maybe nothing as large as the > spec itself. That might take a bit of discipline on our part. The link > below is an overview of markdown see what you think. > > https://daringfireball.net/projects/markdown/ Big +1 for markdown or reStructuredText. reStructuredText may be more adapted to complex spec documents. In any case one or the other would much better than the current approach. And pandoc and a legion of tools can easily convert to any format. [1] https://en.wikipedia.org/wiki/ReStructuredText -- Cordially Philippe Ombredanne _______________________________________________ Spdx-tech mailing list [email protected] https://lists.spdx.org/mailman/listinfo/spdx-tech Intel Deutschland GmbH Registered Address: Am Campeon 10-12, 85579 Neubiberg, Germany Tel: +49 89 99 8853-0, www.intel.de Managing Directors: Christin Eisenschmid, Christian Lamprechter Chairperson of the Supervisory Board: Nicole Lau Registered Office: Munich Commercial Register: Amtsgericht Muenchen HRB 186928 _______________________________________________ Spdx-tech mailing list [email protected] https://lists.spdx.org/mailman/listinfo/spdx-tech
