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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions