= Joint CMDI & Curation taskforces virtual meeting 2018-04-05 =
----

* What?
 * CMDI 1.2 best practices
* Who?
 * Members of the [[Taskforces/CMDI|CMDI]] or the [[Taskforces/Curation|Curation]] taskforces and other people involved/interested in the specification of best practices for CMDI
* When? 
 * 5 April 2018, 14:00 - 16:00 CEST (on basis of [https://doodle.com/poll/g7672pedmwt2h2gd doodle])
* Where?
 * Zoom: https://clarin.zoom.us/j/534115968
 * Note: If using Zoom for the first time, **allow for some setup time before the meeting**. The above link should get you started. See [https://support.zoom.us/hc/en-us/categories/200101697-Getting-Started documentation] for more information.

== Documents ==
 - [https://www.gitbook.com/book/cmdi-taskforce/cmdi-best-practices/ CMDI Best Pratices draft] on !GitBook
 - [[Taskforces/CMDI/BestPracticesEditing|Best Practices editing guide]]
 - [https://docs.google.com/document/d/1Cr_UqoQFPLt3ucovUuCxne7XVSMZ4awUupev2bTzewc/edit?usp=sharing **OLD** draft CMDI Best Practices doc] on Google Docs (please do not edit!)
 - [https://docs.google.com/document/d/1ENLqNEseaFfYuel3eUYYFYMb0ioU_Ue59qvqpBswAzw/edit?usp=sharing Proposal for a recommended general info profile] (work in progress)

== Preparation ==
 * {all} Common approaches section of the document: contribute and/or read contributions
 * {all} Work on (other) [https://www.gitbook.com/book/cmdi-taskforce/cmdi-best-practices/changes change requests]
 * {all} Read up on [https://www.gitbook.com/book/cmdi-taskforce/cmdi-best-practices/discussions open discussions]
 * {Thomas, Susanne, Twan} Evaluate proposed [https://docs.google.com/spreadsheets/d/1v0FmwYojN4Z_85GbETlIonokXKUXeQJe0tQ-7Rstn2U/edit?usp=sharing GitBook alternatives] (HackMD, !StackEdit, new version of !GitBook)

== Agenda ==

(Tentative)

* !GitBook
  * Status
  * Evaluation of [https://docs.google.com/spreadsheets/d/1v0FmwYojN4Z_85GbETlIonokXKUXeQJe0tQ-7Rstn2U/edit?usp=sharing alternatives] (`TODO` **Thomas, Susanne, Twan**)
    * HackMD
    * !StackEdit
    * new version of !GitBook
* Recommendations
  * 'General info' components (see [https://docs.google.com/spreadsheets/d/10JrWFmzc95tszWleaWvgv0bUNRyHWSqKbcFEtIb1kmw/edit?usp=sharing general component comparison sheet])
    * See [https://docs.google.com/document/d/1ENLqNEseaFfYuel3eUYYFYMb0ioU_Ue59qvqpBswAzw/edit?usp=sharing first draft for aggregated version of this] (`TODO` **Twan**)
  * Look at [https://github.com/fxru/blam-metadata Basic Language Archive Metadata (BLAM)] effort 
* Common approaches section
* (Other) open [https://www.gitbook.com/book/cmdi-taskforce/cmdi-best-practices/changes change requests]
* Open [https://www.gitbook.com/book/cmdi-taskforce/cmdi-best-practices/discussions discussions]
* Planning
  * Next/first 'release'?

== Notes ==

=== !GitBook alternatives ===
* HackMD (Susanne)
    * Looks quite straightforward
    * Everyone has an account, there is a history
    * Colour scheme for collaboration.
    * View with markdown
    * Markdown comments
    * Syntax highlighting for code snippets
    * Features added in pro version probably not needed
    * Publishing: export to Gist
    * Might get more messy, no change requests
    * Susanne will try to import, publish
* !StackEdit (Thomas)
    * Google doc syncing worked
    * GitHub syncing did not work but should
    * Export to HTML (and PDF in 'sponsored' mode)
    * Thomas will test some more
* New !GitBook
 * beta.gitbook.com available now
 * books can be converted to new !GitBook
 * Twan will test with a fork of our book

Susanne, Thomas, Twan will report at the next meeting

=== Recommendations ===
* Menzo: align with generic concepts (CCR coordinators)
* BLAM
 * We will get in touch with Felix et al to see if they are interested in discussing this further

=== Common approaches section ===

Sections that have been worked on:
* Modelling for metadata conversion (merge next time?)
* Optimising for discoverability (perhaps turn into CAC submission)
* Dealing with changes
* Multilingual metadata

=== Discussions ===

* [https://www.gitbook.com/book/cmdi-taskforce/cmdi-best-practices/discussions/24 #24] priority of C13 and C14 has to be aligned (both high), Menzo will take care of this and add some text to indicate that missing concepts should be requested

=== Planning ===
* 'Release'
 * Replace link at https://www.clarin.eu/content/cmdi-best-practice-guide with link to !GitBook (and add PDF)
 * Resove in-line notes and TODOs first
 * Any notes/todos that cannot be resolved need to be discussed
* Next meeting
 * [https://doodle.com/poll/ke5u6skkinfh6cx6 Doodle]