This is a description of contents that idealy a repository or a package should have. Taken mainly from observation of projects designed by Joel Grus.
The following are sections that a README.md file should contain:
Section | Description |
---|---|
Project structure | main elements of a project structure |
Installation | How to install the package |
Overview | Overview of the package |
Usage | Quickstart examples |
Doc | Detailed documentation |
Examples | Detailed examples on how to fine-tune Bert |
Notebooks | Introduction on the provided Jupyter Notebooks |
PROJECT FOLDER CONTAINS:
\t-Examples
-Notebooks
-Project name (code)
-Samples?
-Tests
README.md
LICENSE
Requirements.txt
setup.py (this is to be able to pip install!)