Dictionary: logbook

Dictionary logbook

It is critical to record all information that leads to the creation and modification of a dictionary.

method

Each change to a dictionary should have a complete record of what was done. Any raw files should be preserved, and any manual edits described in sufficient detail.

proposal

Dictionary creation should be proposed on the Wiki and solicit community comments

template for incremental modification

modification

This should use the controlled vocabulary:

CREATION

(Only applies to the first entry).

EDIT

This text represents an edit which potentially applies to all entries or only selected. Examples:

manual

The author has edited all appropriate entries. Examples:

• "edited <metadata> to include authors"
• "removed typos from descriptions"

automatic

A script or program has been applied. Examples:

• ran foo.py to move attribute

   <entry bar="value" ...>
 to 
   <entry ...>
      <related wikidata="P123" name="bar">value</related>

a total of 456 edits were made

diff

We should compute the diff (Github should be able to do this).

date

date of work

author

person or group carrying out the work

input

ALL Inputs, whether automatic or manual must be described in detail. Examples:

• The Wikipedia list of parasitic plants (give URL) was used manually to create a list of 123 entries.
• amidict was run with the following command (give URL targets)
• A "seed list" of the 123 commonest plants in biorxiv was created (list filename) and expanded with amidict
• the SPARQL query (myplant.sparql) was run on Wikidata to give 234 entries

We shall need more detail as we proceed.