> For the complete documentation index, see [llms.txt](https://docs.tenten.co/awesome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tenten.co/awesome/web3/free-web3-resources-1/contributing.md). # Contributing Guidelines 🎉 **First of all, thanks for taking the time to contribute!** 🎉 ## 🤔 How can I contribute? ### 🛠 Suggesting Enhancements This section guides you through submitting an enhancement suggestion, including completely new features and minor improvements to existing functionality. Following these guidelines helps maintainers and the community understand your suggestion 📝 and find related suggestions. 🔎 Since GitHub Issue forms we only suggest you to include most information possible. You can see **issues** to see if the enhancement has already been suggested. If it has, add a comment to the existing issue instead of opening a new one. > **Note:** If you find a **Closed** issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one. ### 🟩 Your First Code Contribution Unsure where to begin contributing to this project? You can start by looking through these beginner-friendly issues: * [Beginner issues](https://github.com/tentenco/awesome/blob/main/web3/free-Web3-resources/good-first-issues/README.md) - issues that require less work. * [Help wanted issues](https://github.com/tentenco/awesome/blob/main/web3/free-Web3-resources/help-wanted/README.md) - issues that are a bit more involved. ### 📣 Pull Requests The process described here has several goals: * Maintain the project's quality. * Fix problems that are important to users. * Engage the community in working toward the best possible outcome! * Enable a sustainable system for maintainers to review contributions. Please follow all instructions in [the template](https://github.com/FrancescoXX/free-Web3-resources/blob/main/.github/PULL_REQUEST_TEMPLATE.md) ## Style Guide for Git Commit Messages 📝 **How you can add more value to your contribution logs:** * Use the present tense. (Example: "Add feature" instead of "Added feature") * Use the imperative mood. (Example: "Move item to...", instead of "Moves item to...") * Limit the first line (also called the Subject Line) to *50 characters or less*. * Capitalize the Subject Line. * Separate subject from body with a blank line. * Do not end the subject line with a period. * Wrap the body at *72 characters*. * Use the body to explain the *what*, *why*, *vs*, and *how*. * Reference [issues](https://github.com/tentenco/awesome/blob/main/web3/free-Web3-resources/issues/README.md) and [pull requests](https://github.com/tentenco/awesome/blob/main/web3/free-Web3-resources/prs/README.md) liberally after the first line. * Follow the [conventional commits](https://github.com/tentenco/awesome/blob/main/web3/free-Web3-resources/conventional-commits/README.md) guidelines ## How to Contribute 🚀 * Please create an [issue](https://github.com/tentenco/awesome/blob/main/web3/free-Web3-resources/issues/README.md) before creating a pull request. * Fork the repository and create a branch for any issue that you are working on. * Create a pull request which will be reviewed and suggestions would be provided. * Add Screenshots to help us know what changes you have done. ## How to make a pull request 🤔 **1.** Fork [this](https://github.com/tentenco/awesome/blob/main/web3/free-Web3-resources/repo/README.md) repository. **2.** Clone the forked repository. ```bash git clone https://github.com//free-Web3-resources.git ``` **3.** Navigate to the project directory. ```bash cd free-Web3-resources ``` **4.** Create a new branch Kindly give your branch a more descriptive name like `feat-add-ethereum` instead of `patch-1`. You could follow this convention. Some ideas to get you started: * Feature Updates: `feat-<2-3-Words-Description>-` * Bug Fixes: `fix-<2-3-Words-Description>-` * Documentation: `docs-<2-3-Words-Description>-` * And so on... ```bash git checkout -b your-branch-name ``` **5.** Add the resource, please follow the guidelines following * Add the link: `* [project-name](http://example.com/) - A short description ends with a period.` * Keep descriptions concise and **short**. * Search previous Pull Requests or Issues before making a new one, as yours may be a duplicate. * Don't mention `Web3` in the description as it's implied. * Check your spelling and grammar. * Remove any trailing whitespace. Just a gentle reminder: **Try not to submit your own project. Instead, wait for someone finds it useful and submits it for you.** **6.** Stage your changes and commit. ```bash git add . # Stages all the changes git commit -m "" ``` [**Follow our commit guide from above**](#style-guide-for-git-commit-messages-) **7.** Push your local commits to the remote repository. ```bash git push origin your-branch-name ``` **8.** Create a new [pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) from `your-branch-name` **9.** 🎉 Congratulations! You've made your first pull request! Now, you should just wait until the maintainers review your pull request. ## 🛑 Important ### ✅ Good Practice * Comment on the issue to get assigned * Create an issue before you make a Pull Request ### ❌ Bad Practice * Creating PRs without assignment will not be accepted and will be closed. ## 📈 Getting started * 😕 Not sure where to start? Join our community on [Discord](https://discord.gg/PkfGbBySuc) * ✨ You can also take part in our [Community Discussions](https://github.com/FrancescoXX/free-Web3-resources/discussions) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.tenten.co/awesome/web3/free-web3-resources-1/contributing.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.