Skip to content
/ repo-template Public template

This is a repository template, includes a defined directory structure and files.

License

Notifications You must be signed in to change notification settings

shirleyah/repo-template

Repository files navigation

[Software name]

Description

[High-level description, describing what exactly software does.]

Motivation

[Why the software does things the way it does and why it was designed in the first place. What problems are solved by it. Links to publications and comparisons to similar software.]

System requirements

[If the software does make high demand on particular resources, then this should be clearly advertised and explained.]

Install

[This may be described in a separate INSTALL file, but the README must then clearly state this.]

Quick start

[How the first task can be performed with the software, or, in the more extensive documentation, a link to the quick start. Outlines how to quickly get started with the software using a basic yet practical example]

Project website

[Website where the software is described and allows users to obtain it as well as its documentation.]

License

[Defines the set of rules and conditions for people who want to use the software.]

Support contact information

[It should be clear where to go for support, for example: alquicir@ccg.unam.mx.]

Software quality checklist

[This may describe the state of the code, providing the necessary guidance on which aspects could be improved]

Accessibility

  • Unique DOI identifier (Please update identifier and link)
  • Version control system

Documentation

  • README file

Learnability

  • Quick start

Buildability

  • INSTALL file

Identity

  • Website

Copyright & Licensing

  • LICENSE file

Portability

  • Multiple platforms
  • Browsers

Supportability

  • E-mail address
  • Issue tracker
  • Slack
  • Gitter

Analysability

  • Source code structured
  • Sensible names
  • Coding standards - style guides

Changeability

  • CONTRIBUTING file
  • Code of Conduct file
  • Code changes, and their authorship, publicly visible

Reusability

  • Source code set up in a modular fashion

Security & Privacy

  • Passwords must never be stored in unhashed form

About

This is a repository template, includes a defined directory structure and files.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published