sr.yaml

sr.yaml is a file in every SRVC project that defines project configuration and the review flows. Here is a sample sr.yaml from the srvc-template repository:

reviewer: mailto:user@example.com

labels:
  category:
    question: Category
    type: categorical
    categories:
      - A
      - B
      - C

  include:
    question: Include?
    required: true
    type: boolean

flows:
  pubmed-search:
    steps:
      - uses: github:insilica/srvc-pubmed-search
        query: angry bees

  label:
    steps:
      - run-embedded: generator sink.jsonl

      - run-embedded: remove-reviewed

      - run-embedded: label-web
        labels: [include, category]
        port: 5005

reviewer

Whenever labels are answered, the reviewer is recorded as the one providing the answer. This is often mailto: followed by an email address, but it can also be a web address. For instance, the reviewer could be the URL of a GitHub project that uses a machine learning model to provide answers.

labels

This section defines two labels. The first is a categorical label, which allows a reviewer to select one of several pre-defined answers. The categories here are just examples with no real meaning. The second is a boolean label, which can have an answer of either true or false. In this case, it allows a reviewer to answer whether or not a document is relevant to the project.

flows

This section defines two flows. The first uses the PubMed search step to import documents. The second allows a reviewer to provide answers for each label and document combination. It uses the generator step to retrieve existing documents and answers, the remove-reviewed step to skip documents that have already been reviewed, and the label-web step to allow the reviewer to assign answers to documents.