Skip to content

WP2: attaching structured content to any part of a document #93

@clange

Description

@clange

Conceptually this means that one should be able to make arbitrary, structured notations everywhere, which are permanent parts of the document (not as volatile as comments). Or, in terms of RDF:

  • it should be possible to have any part of the article as the subject (via the work-in-progress "anchor" mechanism)
  • for the predicate and object, the most generic solution is key/value pairs, where the key could be an arbitrary string, or a fixed value (mapped to the URI of some term from some vocabulary), and the value could be a URI (e.g. of a dataset or piece of source code) or a literal (string, number, date, …)

The UI for this could be reused from comments, with a key/value matrix like UI instead of a free-form text box.

For 2–3 common use cases there should be friendlier, less technical UIs. Let's collect some cases here.

  • citations (the SPAR ontologies might provide a suitable vocabulary for this)
    • state of the art is "article A cites article B"
    • importance of a citation
    • scientific vs. non-scientific citation targets (e.g. press/media)
    • citing something because it is a foundation of my work
  • tables/data (subject: a table in an article, or a range of rows/columns/cells in the table; object: a dataset or a subset of it)
    • simplest case: this (part of the) table literally copies data from the dataset
    • realistic case: the table represents f(D), i.e. the application of some function to the dataset. E.g. a cleaning process, a statistical analysis (regression, aggregation, …). We want to make explicit what function was used.
  • figures – same case as tables, e.g. "this figure shows clusters of the entities of type T in the dataset D"
  • source code: the full source of this code snippet can be found at <GitHub URL>

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions