Skip to content

Draft a literature evidence card template example #22

Description

@Permea-lab-admin

Summary

Draft a public-safe example evidence card from a public delivery-related paper.

The example should show how to preserve the difference between a source claim and Permea interpretation, including citation, assay context, limitations, evidence strength, and review status.

Why this matters

Delivery evidence is often scattered across papers, databases, and supplements. Evidence cards make that material easier to inspect without overstating what the source supports.

A template example gives contributors a concrete pattern for turning literature into structured, reviewable evidence objects.

Suggested scope

Create an example evidence card using a public delivery-related source. The example should include:

  • source paper or database
  • molecule, sequence, or material reference where appropriate
  • delivery task or barrier context
  • assay type and biological context
  • source-reported outcome
  • source claim text or paraphrase
  • Permea interpretation, clearly separated
  • evidence strength
  • limitations
  • citation
  • extraction method
  • human review status

Acceptance criteria

  • The source is publicly identifiable.
  • The source claim is separated from interpretation.
  • Assay context and limitations are preserved.
  • Evidence strength and review status are visible.
  • The example avoids strengthening the original source claim.
  • The example does not include restricted data or unsupported claims.

Claim boundaries

This issue does not ask contributors to establish scientific truth from a paper. It asks for a structured evidence-card example that supports review, provenance, and conservative interpretation.

References to relevant docs/files

  • docs/CONTRIBUTION_OBJECTS.md
  • docs/RESEARCH_INTELLIGENCE_LAYER.md
  • docs/DELIVERY_DATASET_COMMONS.md
  • docs/SCIENTIFIC_THESIS.md

Notes for contributors

Choose a narrow source and keep the first example small. Preserve uncertainty and mark anything requiring reviewer confirmation.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationevidence-cardLiterature evidence card contributions and examples.good first issueGood for newcomers

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions