Skip to content
/ fair-code Public template
forked from manuGil/fair-code

A template to make your software more FAIR compiant

License

Notifications You must be signed in to change notification settings

Metahofzicht/fair-code

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

[Repository Title]

Delete this text belowed when using this template in your repository

Purpose

This repository provide a template to make your software project more compliant with the FAIR principles.

How to use this template

  1. Create a new repository using this template.
  2. Clone your reposiotry.
  3. Edit the text between [ ] in the README and CONTRIBUTING file. Explanations of the expected content for each section appear between [ ], and they should be removed. Leave text ousite [ ] unchanged.
  4. Start coding

How to organize source code

[The organization of your source code depends on the progaming language and the purpose of the code. However, here are some general recommendations:

  1. Organize your source code in directories. Create a root-directory for the coder with the same name as repository.
  2. In the root directory include a tests directory for writing test for the source code. For example, in this template, source code should go in the repo-template directory.
  3. As the source code grows, keep scripts organized in sub-directories, the rule of thrumb here is to keep related scripts together.
  4. Use meaningful name for directories and scripts, and choose file names carefully.
  5. Separate data from source code.]

Important: when using this template, keep the stucture suggested in repo-template, but change the name to match you repository's name.

Delete this text above when this template in your repository

[Repository Description: In two or three sentences, describe the purpose of the repository: what is this repository for?]

Installation

[Describe the steps that users (not developers) should follow to install the code in each of the intended platforms (e.g. Window 10, MacOS, etc.).]

Requirements

  • [List the software, OS, and/or technologies on which the code depends, and add hyperlinks to the sources whenever possible.]
  • [State any relevant hardware requirements.]

[For Patform A]

[List and describe each step required to install the software. Use a description/example format. For example:]

[1. Install dependencies ]

[$ pip install -r requirements.txt]

[Contributing Guidelines]

[ Include a CONTRIBUTING.md files ]

License

  1. [Always decide on a license for your code. If no licensing is stated, the default of "no license" is "no one can make copies or derivative works of your code".]

[Under the current guidelines or research software, TU Delft encourages the use of open source licenses for research software. Use the decision three below to determine if the software you intend to develop can be published as Open Source Software (OSS). You can also ask for help to the Data Steward in your Faculty]

Open Source Software decision tree

[If using an open source license, select one of the followings pre-approved licences:]

License: CC0-1.0

License: MIT

License

License

EUPL-1.2

License: GPL v2

License: GPL v3

License: LGPL v3

  1. [If an OSS license will be used. Edit the LICENSE file to match your case. It is a good practice to include a copy of the license text in the LICENSE file.]

Copyright

[TU Delft owns the copyrights of any software developed by TU Delft researchers. However, if the software is published as OSS, TU Delft agrees to transfer such rights to the Author(s) of the software. If using an OSS license, you can claimed the copyright by using the following text:]

© (YEAR) [Author(s)], Deflt, The Netherlands.

Citation

[Include a CCF file (Citaion File Format). See example in this repo: CITATION.cff. You can easily create the content of a CCF using this tool. ]

[CCF files can be converted to a multitude of formats, including BibTex, EndNote, codemeta, plain JSON, schema.org, RIS, and Zenodo JSON ]

Acknowlegdements

[Name anyone who deserves it.]

About

A template to make your software more FAIR compiant

Resources

License

Stars

Watchers

Forks

Packages

No packages published