Use Common Form tooling

.gitignore

@@ -1,3 +1,2 @@
-# build output
-*.docx
-*.pdf
+node_modules
+build

Dockerfile

@@ -0,0 +1,18 @@
+FROM node:dubnium-jessie
+
+# Accept EULA for Microsoft fonts
+RUN echo ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true | debconf-set-selections
+RUN echo deb http://httpredir.debian.org/debian jessie main contrib non-free > /etc/apt/sources.list
+RUN apt-get update
+RUN DEBIAN_FRONTEND=noninteractive apt-get install -y make unoconv ttf-mscorefonts-installer
+RUN fc-cache -f
+
+WORKDIR /workdir
+
+COPY package.json /workdir/package.json
+COPY package-lock.json /workdir/package-lock.json
+RUN npm install
+
+COPY . /workdir
+
+CMD /usr/bin/unoconv --listener && make

Makefile

@@ -0,0 +1,65 @@
+CFCM=node_modules/.bin/commonform-commonmark
+CFDOCX=node_modules/.bin/commonform-docx
+CFHTML=node_modules/.bin/commonform-html
+CRITIQUE=node_modules/.bin/commonform-critique
+JSON=node_modules/.bin/json
+LINT=node_modules/.bin/commonform-lint
+MUSTACHE=node_modules/.bin/mustache
+TOOLS=$(CFCM) $(CFDOCX) $(CFHTML) $(CRITIQUE) $(JSON) $(LINT) $(MUSTACHE)
+
+BUILD=build
+SOURCES=$(filter-out README.md,$(wildcard *.md))
+FORMS=$(addsuffix .form.json,$(addprefix $(BUILD)/,$(SOURCES:.md=)))
+TITLE=Open Use of Data Agreement
+
+all: docx pdf html
+
+docx: $(addprefix $(BUILD)/,$(SOURCES:.md=.docx))
+pdf: $(addprefix $(BUILD)/,$(SOURCES:.md=.pdf))
+html: $(addprefix $(BUILD)/,$(SOURCES:.md=.html))
+
+$(BUILD)/%.docx: $(BUILD)/%.form.json styles.json | $(CFDOCX) $(BUILD)
+	$(CFDOCX) --title "$(TITLE)" --edition "$(EDITION)" --number decimal --indent-margins --left-align-title --styles styles.json $< > $@
+
+$(BUILD)/%.md: $(BUILD)/%.form.json | $(CFCM) $(BUILD)
+	$(CFCM) stringify --title "$(TITLE)" --edition "$(EDITION)" < $< > $@
+
+$(BUILD)/%.html: $(BUILD)/%.form.json | $(CFHTML) $(BUILD)
+	$(CFHTML) --html5 --lists --title "$(TITLE)" --edition "$(EDITION)" < $< > $@
+
+$(BUILD)/%.form.json: %.md | $(JSON) $(CFCM) $(BUILD)
+	$(CFCM) parse --only form < $< | $(JSON) content.0.form > $@
+
+%.pdf: %.docx
+	unoconv $<
+
+$(BUILD):
+	mkdir -p $@
+
+$(TOOLS):
+	npm install
+
+.PHONY: clean docker lint critique
+
+lint: $(FORMS) | $(LINT) $(JSON)
+	@for form in $(FORMS); do \
+		echo ; \
+		echo $$form; \
+		cat $$form | $(LINT) | $(JSON) -a message | sort -u; \
+	done; \
+
+critique: $(FORMS) | $(CRITIQUE) $(JSON)
+	@for form in $(FORMS); do \
+		echo ; \
+		echo $$form ; \
+		cat $$form | $(CRITIQUE) | $(JSON) -a message | sort -u; \
+	done
+
+clean:
+	rm -rf $(BUILD)
+
+docker:
+	docker build -t open-use-of-data-agreement .
+	docker run --name open-use-of-data-agreement open-use-of-data-agreement
+	docker cp open-use-of-data-agreement:/workdir/$(BUILD) .
+	docker rm open-use-of-data-agreement

O-UDA-0.1_annotated_discussion-draft.md

@@ -1,64 +1,51 @@
-# Open Use of Data Agreement v0.1
-# Annotated-Discussion-DRAFT-20190722
+# Open Use of Data Agreement
 
-This is the Open Use of Data Agreement, Version 0.1 (the "O-UDA").  Capitalized terms are defined in Section 5. Data Provider and you agree as follows.
+This is the Open Use of Data Agreement, Version 0.1 (the **O-UDA**).   Capitalized terms are defined in [Definitions](#definitions).   _Data Provider_ and you agree as follows.
 
-**Comment**: _The O-UDA is intended for use by a Data Provider that owns (or has sufficient rights from a data owner) to distribute data for unrestricted uses, subject to applicable laws governing the use of datasets of the type distributed. The O-UDA is not intended for a use of Data that may include personal data, or data not owned by a data provider. To be precise, it is not appropriate for data sets that include any data that might include materials subject to privacy laws such as the GDPR or HIPAA, or third party materials subject to copyright laws that have not been licensed for unrestricted use or dedicated to the public domain._
+## Provision of the Data
 
-1. **Provision of the Data**
+1.  You may use, modify, and distribute the _Data_ made available to you by the _Data Provider_ under this _O-UDA_ if you follow the _O-UDA_'s terms.
 
-    1.1. You may use, modify, and distribute the Data made available to you by the Data Provider under this O-UDA if you follow the O-UDA's terms.
+2.  _Data Provider_ will not sue you or any _Downstream Recipient_ for any claim arising out of the use, modification, or distribution of the _Data_ provided you meet the terms of the _O-UDA_.
 
-      **Comment**: _The O-UDA permits very broad use of Data, and also modification and redistribution of the Data, so long as the recipient meets the O-UDA's requirements (and there are only a few of these). It is styled as a "permission to use" rather than a grant of specific rights, because the rights that may be applicable to any given database (whether copyright, database rights, or merely access rights) may vary around the world._
+## No Restrictions on Use or _Output_
 
-    1.2. Data Provider will not sue you or any Downstream Recipient for any claim arising out of the use, modification, or distribution of the Data provided you meet the terms of the O-UDA.
+The _O-UDA_ does not impose any restriction with respect to:
 
-      **Comment**: _This is a promise by the Data Provider not to sue the user so long as the user complies with O-UDA’s requirements. It doesn't allow a Data Provider to terminate a permitted use of the Data, but it does allow the Data Provider to bring an action to enforce the O-UDA’s terms._
+1.  the use or modification of _Data_; or
 
+2.  the use, modification, or distribution of _Output_.
 
-2. **No Restrictions on Use or Output**
+## Redistribution of Data
 
-    2.1. The O-UDA does not impose any restriction with respect to:
+You may redistribute the _Data_ under terms of your choice, so long as:
 
-      2.1.1. the use or modification of Data; or
+1.  You include with any _Data_ you redistribute all credit or attribution information that you received with the _Data_, and your terms require any _Downstream Recipient_ to do the same; and
 
-      2.2.2. the use, modification, or distribution of Outputs.
+2.  Your terms include a warranty disclaimer and limitation of liability for _Upstream Data Providers_ at least as broad as those contained in [General Disclaimer](#general-disclaimer) and [Limit on Liability](#limit-on-liabililty) of the _O-UDA_.
 
+## No Warranty, Limitation of Liability
 
-3. **Redistribution of Data**
+### No Warranty of Rights
 
-    3.1. You may redistribute the Data under terms of your choice, so long as:
+_Data Provider_ does not represent or warrant that it has any rights whatsoever in the _Data_.
 
-      3.1.1. You include with any Data you redistribute all credit or attribution information that you received with the Data, and your terms require any Downstream Recipient to do the same; and
+### General Disclaimer
 
-      3.1.2. Your terms include a warranty disclaimer and limitation of liability for Upstream Data Providers at least as broad as those contained in Section 4.2 and 4.3 of the O-UDA.
+!!! The _Data_ are provided on an "as is" basis, without warranties or conditions of any kind, either express or implied including, without limitation, any warranties or conditions of title, non-infringement, merchantability or fitness for a particular purpose.
 
-      **Comment**: _The only requirements for redistributing Data are to maintain attribution (if any) and use an agreement that contains Section 4’s disclaimers and limitations on liability, so that Downstream Recipients are bound by it for their use. These two restrictions apply only to the Data, but not to Output. Maintaining attribution is an accepted practice for sharing data to indicate its source or provenance. Requiring the use of disclaimers and liability limitations for subsequent distribution provides further certainty to a Data Provider._
+### Limit on Liability
 
-4. **No Warranty, Limitation of Liability**
+!!! Neither _Data Provider_ nor _Upstream Data Providers_ shall have any liability for any direct, indirect, incidental, special, exemplary, or consequential damages (including without limitation lost profits), however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the _Data_ or _Output_, even if advised of the possibility of such damages.
 
-    4.1. Data Provider does not represent or warrant that it has any rights whatsoever in the Data.
+## Definitions
 
-      **Comment**: We have chosen a broad disclaimer of representations and warranties, which may not be appropriate in commercial contexts. These disclaimers are common in the open data context to encourage possessors of data to share the data without requiring them to make promises about the data. Because the Data Provider makes no claims that they have rights in the data, the Downstream Recipient must ensure that its use of the Data conforms to applicable laws or regulations. A Data Provider should not use the O-UDA for Data that it knows should not be distributed, or data that contains sensitive or private information._
+1.  **Data** means the material you receive under the _O-UDA_ in modified or unmodified form, but not including _Output_.
 
-    4.2. THE DATA IS PROVIDED ON AN “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+2.  **Data Provider** means the source from which you receive the _Data_ and with whom you enter into the _O-UDA_.
 
-    4.3. NEITHER DATA PROVIDER NOR ANY UPSTREAM DATA PROVIDER SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE DATA OR OUTPUTS, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+3.  **Downstream Recipient** means any person or persons who receives the _Data_ directly or indirectly from you in accordance with the _O-UDA_.
 
-      **Comment**: _These disclaimers are necessary to limit Data Provider’s liability. They disclaim both express and implied warranties or representations, and the  disclaimer applies to all Upstream Data Providers. These limitations of liability are common in the open data context to encourage possessors of data to share the data without requiring them to accept liability to a user for downstream uses of the data, but may not be appropriate in commercial contexts._
+4.  **Output** means the outcomes or results that you obtain from your use of _Data_ that do not include more than a de minimis portion of the _Data_ on which the use is based.  _Output_ may include de minimis portions of the _Data_ necessary to report on or explain use that has been conducted with the _Data_, such as figures in scientific papers, but do not include more.  Artificial intelligence models trained on _Data_ (and which do not include more than a de minimis portion of _Data_) are _Output_.
 
-5. **Definitions**
-
-    5.1. "Data" means the material you receive under the O-UDA in modified or unmodified form, but not including Output.
-
-      **Comment**: _The term "Data" encompasses both the initial data made available to "you" as well as any later modifications made to that data by a Data Provider or a Downstream Recipient that redistributes the data. This also means that Downstream Recipients remain free to modify the data. Data specifically excludes Outputs._
-
-    5.2. "Data Provider" means the source from which you receive the Data and with whom you enter into the O-UDA.
-
-    5.3. "Downstream Recipient" means any person or persons who receives the Data directly or indirectly from you in accordance with the O-UDA.
-
-    5.4. "Output" means the outcomes or results that you obtain from your use of Data that do not include more than a de minimis portion of the Data on which the use is based.  Output may include de minimis portions of the Data necessary to report on or explain use that has been conducted with the Data, such as figures in scientific papers, but do not include more.  Artificial intelligence models trained on Data (and which do not include more than a de minimis portion of Data) are Output.
-
-      **Comment**: _The O-UDA defines “Output” to clarify that any AI model produced from the use of the Data (e.g., as a training set) should not typically be considered to be subject to the O-UDA's restrictions. The O-UDA considers that Outputs are not a "derivative" or a "modification" of the Data if they don't contain more than a de minimis portion of the Data. This is also intended to clarify that research papers and accompanying figures that may include only a de minimis part of the Data are not subject to any restriction in the O-UDA._
-
-    5.5. "Upstream Data Providers" means the source or sources from which the Data Provider directly or indirectly received, under the terms of the O-UDA, material that is included in the Data.
+5.  **Upstream Data Providers** means the source or sources from which the _Data Provider_ directly or indirectly received, under the terms of the _O-UDA_, material that is included in the _Data_.