diff --git a/contributing.md b/contributing.md index 64b4f7b..5ee56dd 100644 --- a/contributing.md +++ b/contributing.md @@ -3,14 +3,14 @@ Please ensure your pull request adheres to the following guidelines: - Alphabetize your entry. -- Search previous suggestions before making a new one, as yours may be a duplicate. +- Search for previous suggestions before making a new one, as yours may be a duplicate. - Suggested READMEs should be beautiful or stand out in some way. - Make an individual pull request for each suggestion. -- New categories, or improvements to the existing categorization are welcome. +- New categories or improvements to the existing categorization are welcome. - Keep descriptions short and simple, but descriptive. - Start the description with a capital and end with a full stop/period. - Check your spelling and grammar. - Make sure your text editor is set to remove trailing whitespace. -- Use the `#readme` anchor for GitHub READMEs to link them directly +- Use the `#readme` anchor for GitHub READMEs to link them directly. Thank you for your suggestions! diff --git a/readme.md b/readme.md index 4f4b685..2f0193f 100644 --- a/readme.md +++ b/readme.md @@ -9,7 +9,7 @@ images, screenshots, GIFs, text formatting, etc. ## Examples -- [ai/size-limit](https://github.com/ai/size-limit#readme) - Project logo, clear description, screenshot, step-by-step installing instructions. +- [ai/size-limit](https://github.com/ai/size-limit#readme) - Project logo, clear description, screenshot, step-by-step installation instructions. - [aimeos/aimeos-typo3](https://github.com/aimeos/aimeos-typo3#readme) - Project logo. Clear description of what the project does. Demo screenshot. TOC for easy navigation. Easy installation and setup sections with screenshots. Links for further reading. - [ajeetdsouza/zoxide](https://github.com/ajeetdsouza/zoxide#readme) - Badges, project GIF, concise description, quick links, stepwise installation instructions. - [alichtman/shallow-backup](https://github.com/alichtman/shallow-backup#readme) - Clear description of what the project does. GIF Demo. TOC for easy navigation. Badges. Links for further reading. Simple install instructions. @@ -20,7 +20,7 @@ images, screenshots, GIFs, text formatting, etc. - [ankitwasankar/mftool-java](https://github.com/ankitwasankar/mftool-java#readme) - Project logo with a short display of what can be achieved with it, TOC for easy navigation, important badges, clean installation guide, and multiple code snippets showing how to use the functionality. - [antoinezanardi/werewolves-assistant-api-next](https://github.com/antoinezanardi/werewolves-assistant-api-next#readme) - Project logo. Badges. Concise description. TOC for easy navigation. Simple install instructions and various sections. Clean project with code coverage, CI, and many other features. - [AntonioFalcaoJr/EventualShop](https://github.com/AntonioFalcaoJr/EventualShop#readme) - The project has a logo and well-defined sections such as: information about the project, the architectural solution, along with reference links such as articles, videos, and documentation. It explains how to run the project in different environments (development and production). It has documented load tests, it also describes which technologies are used, and it has diagrams for the archetype. -- [aregtech/areg-sdk](https://github.com/aregtech/areg-sdk#readme) - Logo. Multiple info and statistics badges. List of contributors and stargazers with pictures. TOC and "Back to top" links for easy navigation. Headlines with graphics. Topic hide/show menu. Project description and philosophy. Clone and integration instructions. Quick build with multiple tools. Tools configuration instructions. Reference to examples and Demo projects. Reference to use cases. References to guidance and Wiki pages. Links with badges to contact. Links with badges to share project in social network. +- [aregtech/areg-sdk](https://github.com/aregtech/areg-sdk#readme) - Logo. Multiple info and statistics badges. List of contributors and stargazers with pictures. TOC and "Back to top" links for easy navigation. Headlines with graphics. Topic hide/show menu. Project description and philosophy. Clone and integration instructions. Quick build with multiple tools. Tools configuration instructions. Reference to examples and Demo projects. Reference to use cases. References to guidance and Wiki pages. Links with badges to contact. Links with badges to share the project on social networks. - [Armync/Arminc-AutoExec](https://github.com/ArmynC/ArminC-AutoExec/#readme) - Rich Markdown functions, modern layout, clear description and compliant with the recommended community standards. - [athityakumar/colorls](https://github.com/athityakumar/colorls#readme) - Multiple badges. Clean screenshots. Simple install instructions. TOC for easy navigation. Good contributor guidelines. - [ccostan/Home-AssistantConfig](https://github.com/CCOSTAN/Home-AssistantConfig#readme) - Project Banner. Badges. Easy navigation. @@ -91,7 +91,7 @@ images, screenshots, GIFs, text formatting, etc. ## Architecture Examples A good ARCHITECTURE.md file helps developers understand how and where to make changes, whether they are new to a project or not. -Diagrams, source code maps, and discussing invariants and design decisions is essential. +Diagrams, source code maps, and discussing invariants and design decisions are essential. This can also be a dedicated section of your README.md files. - [esbuild](https://github.com/evanw/esbuild/blob/main/docs/architecture.md) - Great use of graphics for visualisations and project structure. Includes a list of important principles for the project. @@ -139,7 +139,7 @@ This can also be a dedicated section of your README.md files. Embedding an animated gif in your README quickly demonstrates what your project does and catches the reader's eye. Here are a few programs that can help you quickly create gifs for your project: -- [Gifski](https://github.com/sindresorhus/Gifski#readme) - **FREE** - More vivid colors than the rest, but still keep size low. +- [Gifski](https://github.com/sindresorhus/Gifski#readme) - **FREE** - More vivid colors than the rest, but still keeps size low. - [Giphy Capture](https://giphy.com/apps/giphycapture) - **FREE** - Easy to upload to giphy.com, slightly annoying UX. - [LICEcap](https://www.cockos.com/licecap/) - **FREE** - Less intuitive, more features. - [Peek](https://github.com/phw/peek#readme) - **FREE** - Simple and easy to use for Linux users.