Skip to content

Instantly share code, notes, and snippets.

@sambacha
Last active November 25, 2020 00:05
Show Gist options
  • Star 2 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save sambacha/07c8580377cf7deec6be569322babcfd to your computer and use it in GitHub Desktop.
Save sambacha/07c8580377cf7deec6be569322babcfd to your computer and use it in GitHub Desktop.
A general Boilerplate README file for Improvement Proposals

Boilerplate Proposal README file

Changes

-- Added SECURITY section

-- Added 'Libraries' to ## Terminology

-- Added explicit ## LICENSE section

Improvement Proposal Overview Title

Boilerplate Improvement Proposal Project Git Repo README file

Overview

This is the overview explanation of the proposal project/improvement. Explain the purpose of the improvement.

Tested Against

Version Build Date
(yyyy-mm-dd)
Version 0.6.4 MDc6UmVsZWFzZTI0MzgwNTQ3 2020-03-10T15:26:16Z

Proposal Responsibility:

Person Contact Info Responsibility
@github_usrname usr@github_email.com Proposal Submitter
@github_dev1 posixmeharder@tycoon.com Developer

Files

Explain what is the purpose of each process and process related file in the project.

Click to see file details:

IYIPX.sol

This file does something and its purpose is to do abc.


deploy-mainnet.sh

This file deploys the contracts on mainnet


myEmailTemplate.ftl

This file does something and its purpose is to do abc.

Image example of the Rendered FreeMarker file (if applicable)


How to Deploy

Explanation of how to deploy this specific project goes here.

For further deployment templates and options see: Deployment Documentation

Method Trigger
Truffle On creation of a Production Release.
Deployed to mainnet chainid: 1
Web3 Provider On commit to branch with pattern build/development.
Deployed to testnet ropsten

Changelog

Store details about the releases of your improvement in the Change Log

Improvement Change Log

Informative / Additional Information

Explanation of other details about the project that may not have been included in the Overview.

Examples:

  1. Use cases.
  2. Error handling.
  3. If there is re-usable code that could be used for other purposes.
  4. Explanation of any specific configurations, in-line code or expressions in any of the process files.
  5. Explanation of designs and specific configurations.
  6. Related documentation that may be contained in another system or the /docs folder.

Additional Support documentation

See the following for additional support documentation related to building and managing process projects:

  1. Best Practices and Documentation Patterns
  2. Helper Scripts and Snippets

Terminology / Libraries

A list of terms and libraries used by this project.

Term Acronym Definition
Requestor
Initiator Another term used for requestor.
SafeMath Lib OpenZeppelin
Proxy
Margin Rate
Stablecoin
Tether USDT USDT Stablecoin

Security

Point of contact Method
persons name contact@method.com

Licenses

SPDX-License-Identifier: ISC

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment