Skip to content

Collection of metadata files (gitignore, pyproject, editorconfig, license etc.) to be used for initializing workflow and project repositories

License

Notifications You must be signed in to change notification settings

core-unit-bioinformatics/template-metadata-files

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Template Metadata files

This repository is a collection of metadata files that should be used to initialize new repositories if appropriate (no strong arguments speak against it).

Repository-related metadata files

  • LICENSE: using this file is mandatory for all CUBI repositories
  • CITATION.md: using this file is mandatory for all CUBI repositories
    • if no other - more specific - citation information applies to a repository, a link to this CITATION file must be added at the end of the top-level repository README (same wording as at the end of this README).
  • .editorconfig: using this file is mandatory for all CUBI repositories
  • .gitignore: strongly recommended, contains ignore rules for Python, R and some custom entries by default. There must be a good reason not to use (an extended version of) this file.

CUBI metdata files

By convention, and for convenience, all CUBI metadata are organized in form of a pyproject.toml file containing a minimal amount of descriptive entries. This file must be located at the top-level of the respective repository. The "hierarchy" in these files is as follows:

  1. include Python tool settings for coherent formatting of Python code
    • if the repository does not contain any Python code, this may be omitted
  2. include the CUBI metadata information, i.e., the top-level pyproject.toml in this repository
  3. include specific metadata...

As a reminder, read the development guidelines to learn about key characteristics of workflows and projects, and naming conventions:

CUBI dev process in the knowledge base

CUBI naming conventions in the knowledge base

Citation

If not indicated otherwise above, please follow these instructions to cite this repository in your own work.

About

Collection of metadata files (gitignore, pyproject, editorconfig, license etc.) to be used for initializing workflow and project repositories

Resources

License

Stars

Watchers

Forks

Packages

No packages published