Skip to content

Template for CBE Tool GitHub repos, including information to achieve consistent READMEs, front-end designs, and more.

Notifications You must be signed in to change notification settings

CenterForTheBuiltEnvironment/cbe-tool-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


CBE Tool Logo

CBE Tool README Template

- Short tool description -
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About the Tool
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About the Tool

Tool Banner

Briefly describe what your tool does and its purpose.

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

  • [![Next][Next.js]][Next-url]
  • [![React][React.js]][React-url]

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

Software or tools required before installation.
Make sure requirements.txt is up-to-date.

Installation

Step-by-step guide on how to install and set up the tool, incl. code blocks.

def welcome(tool-name):
    print(f"Welcome to the {tool-name} GitHub page!")

welcome("cbe-webtool-name")

(back to top)

Usage OR Documentation

Examples of how to run or use the tool, including commands and screenshots.

  • For smaller tools without Documentation this Section is called Usage and could contain a link to a local Markdown file with further explanations.
  • All larger tools should have a dedicated Documentation, ideally set up using GitBook and linked to the docs folder.

(back to top)

Roadmap

List any planned features or improvements.

EXAMPLE

  • Add Changelog
  • Add back to top links
  • Add Additional Templates w/ Examples
  • Add "components" document to easily copy & paste sections of the readme
  • Multi-language Support
    • Chinese
    • Spanish

See open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Thanks!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

The licensing information for the tool.
An overview of common licenses for open-source projects can be found here.

EXAMPLE
Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Information on how to contact the tool maintainer(s). We tend to not provide detailed contact information, but to use GitHub Discussions instead.

Your Name - @your_linkedin - email@example.com

Project Link: https://github.com/your_username/repo_name

(back to top)

Acknowledgements

Credits to those who have contributed to the tool or resources (e.g. libraries) that were helpful.

(back to top)

About

Template for CBE Tool GitHub repos, including information to achieve consistent READMEs, front-end designs, and more.

Resources

Stars

Watchers

Forks