[Esip-documentation] Question on licensing of "Attribute Convention for Data Discovery 1.3" wiki page content

[Martin Desruisseaux]

Le 27/05/2018 à 14:20, Ted Habermann a écrit :

> Not sure what this looks like in XML, JSON, or CSV… Would MarkDown
> work? Seems more natural…
>
The intent is not to replace the wiki. It would be a copy of tables
below "Global Attributes" section (only the tables, not the discussion
before it) for consumption by machines rather than human. It could be
something like that (other formats like CSV or XML would work as well,
I'm neutral on that):

    title = A short phrase or sentence describing the dataset. In many
    discovery systems (…)summary = A paragraph describing the dataset,
    analogous to an abstract for a paper.keywords = A comma-separated
    list of key words and/or phrases. Keywords may be (…)

It would allow external projects to insert automatically this
documentation in their project at build time (in Apache SIS, I would use
a custom javadoc tag for that purpose). If ESIP update their
documentation, the updates would be reflected in external project
documentation too.

The inconvenient is that if the wiki is updated, ESIP would need to
remember to update above file accordingly, and conversely.

    Martin


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.deltaforce.net/pipermail/esip-documentation/attachments/20180527/28fbb9d4/attachment.html>