Skip to content

adhere to NLeSC software checklist #23

@bakhshir

Description

@bakhshir

Version control

  • version control from the beginning of the project
  • use git as version control system (vcs)
  • choose one branching model
  • public vcs repository
  • meaningful commit messages need to work on this

Releases

  • semantic versioning
  • tagged releases
  • CHANGELOG.md
  • one command install
  • package in package manager
  • discuss release cycle with coordinator
  • release quick-scan by other engineer
  • Citeable
  • Dissemination

Licensing

  • Apache 2 license
  • compatible license of all libraries
  • NOTICE(.txt|.md)

Communication

  • home page
  • discussion list
  • demo docker image in dockerhub (with Dockerfile)
  • an online demo
  • screencast

Code Quality

  • use editorconfig
  • code style applied in automated way

Testing

  • unit tests
  • continuous integration
  • continuous code coverage
  • end2end test
  • dependencies tracking

Documentation

  • README.md
  • well defined functionality
  • source code documentation
  • usage documentation
  • documented development setup
  • contribution guidelines
  • code of conduct
  • documented code style
  • how to file a bug report
  • explained meaning of issue labels
  • DOI or PID
  • CITATION file
  • print software version

Development setup

  • dev environment docker images in Dockerhub (with Dockerfile)

Standards

  • Exchange formats
  • Protocols

NOTE: we can check master branch of TNO CS repo for missing components of our repo
see https://github.com/TNOCS/csWeb/

More comment in checklist.txt

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions