This repository is an example for a good public repository README page, and is here to provide you with ideas and assets to use in your readme files. Readme files are critical for helping your users understand what you are offering, and helps make your repository appear more professional, well maintained, useful, and easy to use. You don't have to use all the elements on this readme, but the more information you provide in your readme file, the better.
Use one of these assets and texts in your readme.md file, to help your users get started quickly.
Let your users know you have paid item available by adding our banner, and change the URL to direct to your repository URL on xs:code.
Be sure to include an brief explantion on what you are offering.
Here's the markdown code for the banner:
[](https://xscode.com)
Let your users know you have paid item available by adding our badge, and change the URL to direct to your repository URL on xs:code.
Be sure to include an brief explantion on what you are offering.
Here's the markdown code for the badge:
[](https://xscode.com/)
Make sure to include an explantion on how you monetize your repository, and how your paid version is different than the one offered for free on Github. Use one of these assets and texts in your readme.md file, to help your users get started quickly.
Starting from version 0.0.0.0, this project is licensed under the GPLv3 license. For a MIT licensed version, visit xs:code
This project is offered as open-core, with the following extra features available on xs:code:
- Multi language support
- Framework compatibility
- Monthly updates
- Extra modules
- Etc.
Subscribe to this project on xs:code and get 5 monthly support hours.
Make it easy for users to see the project progress and other indicators, Check out Shields.io to use or make your own badges.
Additionally, use these badge options to provide more information about your project:
You can include a table of contents in order to allow other developers to navigate your readme file.
(especially if you have a long and detailed README).
- Public-README-Sample
- Prerequisites
- Installation
- Initial Configuration
- Usage
- Built With
- Documentaion
- What's Included? (Features)
- Configuration
- Contributing
- Links
- Support & Maintenance
- Licensing
Make a GIF with any GIF maker / screen recorder and show users how your project works.
via @Beedigital.net on GIPHY
Check out the Demo (Add a real link to your demo version)
State the prerequisites needed to use or install your project.
Step by step instullation explanation, or a quick introduction of the minimal setup you need to get a hello world up & running.
packagemanager install Public-README-Sample
Public-README-Sample start
Public-README-Samplet "Help mw promote my repo!" # prints "YES."Here you should say what actually happens when you execute the code above.
Some projects require initial configuration (e.g. access tokens or keys, npm i).
This is the section where you would document those requirements.
Instruct developers on how to use your project after they’ve installed it. This would also be a good place to include screenshots of your project in action.
Explain how to run the automated tests for this project
Tests example
- AngularJS - The web framework used
- Maven - Dependency Management
- FetchRSS - Used to generate RSS Feeds
If your project needs some additional steps for the developer to build the project after some code changes, state them here:
./configure
make
make installAdd a link to your Documentation. It's important to have a detailed and current documentation of your project. Check out this great and easy documentaion tool - docusaurus.io for easily creating documentation for your project.
Add a list of the features included in the project.
- The main functionality of this project
- Does another thing
- Also do this - Available only in the licensed version at xs:code
- And more - Available only in the licensed version at xs:code
*Note - Some features are only available in paid version at xs:code
Contributions are always welcome! If you'd like to contribute, please read our [contributors guidelines], fork the repository and use a feature branch.
IMPORTANT! Before contributions can be accepted, please fill and sign a CLA, and send it to [email protected]. Contributions without a signed CLA cannot be accepted. Find a CLA here:
*Note - Add a link to 'CONTRIBUTING.md' file for deatils on your code of conduct, and the process for submitting pull requests to you.
*Note - Support & Maintenance are only available in the Premmisive MIT license version at xs:code
A Huge thank you to all our contributors for maintaining and supporting this project.
*Note - You can also use the Emoji Key and all-contributors bot to automate acknowledging contributors to your projects.
This repository was made with 💙 by xs:code
This project is licensed under the MIT license.