Before you begin:
- Have you read the code of conduct?
- Check out the existing issues & see if we accept contributions for your type of issue.
- Before you make your changes, check to see if an issue exists already for the change you want to make.
If you spot something new, open an issue. We'll use the issue to have a conversation about the problem you want to fix.
Fork using GitHub Desktop:
- Getting started with GitHub Desktop will guide you through setting up Desktop.
- Once Desktop is set up, you can use it to fork the repo!
Fork using the command line:
- Fork the repo so that you can make your changes without affecting the original project until you're ready to merge them.
Fork with GitHub Codespaces:
- Fork, edit, and preview using GitHub Codespaces without having to install and run the project locally.
Make your changes to the file(s) you'd like to update. Here are some tips and tricks for using the docs codebase.
- Are you making changes to the application code? You'll need ansible,docker,molecule,python3,pre-commit to run the tests locally.
When you're done making changes and you'd like to propose them for review open a PR (pull request).
- Once you submit your PR, others from the racqspace community will review it with you. The first thing you're going to want to do is a self review.
- After that, we may have questions, check back on your PR to keep up with the conversation.
- Did you have an issue, like a merge conflict? Check out our git tutorial on how to resolve merge conflicts and other issues.
Congratulations! The racqspace community thanks you. ✨
Once your PR is merged, you will be proudly listed as a contributor in the contributor chart.
Now that you're a part of the racqspace community, you can keep participating in many ways.
Learn more about contributing:
You can contribute in several ways. This repo is a place to discuss and collaborate on the ansible role racqspace.microk8s! Our small, but mighty 💪 racqspace team is maintaining this repo. To preserve our bandwidth, off topic conversations will be closed.
Discussions are where we have conversations.
If you'd like help troubleshooting a PR you're working on, have a great new idea, or want to share something amazing you've learned in our docs, join us in discussions.
Issues are used to track tasks that contributors can help with. If an issue has a triage label, we haven't reviewed it yet and you shouldn't begin work on it.
If you've found something in the repo that should be updated, search open issues to see if someone else has reported the same thing. If it's something new, open an issue. We'll use the issue to have a conversation about the problem you want to fix.
A pull request is a way to suggest changes in our repository.
When we merge those changes, they should be available in ansible galaxy within 24 hours. 🌍 To learn more about opening a pull request in this repo, see Opening a pull request below.
You can browse existing issues to find something that needs help!
You can use the GitHub user interface ✏️ for some small changes, like fixing a typo or updating a readme. You can also fork the repo and then clone it locally, to view changes and run your tests on your machine.
We (usually the docs team, but sometimes GitHub product managers, engineers, or supportocats too!) review every single PR. The purpose of reviews is to create the best content we can for people who use GitHub.
💛 Reviews are always respectful, acknowledging that everyone did the best possible job with the knowledge they had at the time. 💛 Reviews discuss content, not the person who created it. 💛 Reviews are constructive and start conversation around feedback.
You should always review your own PR first.
For content changes, make sure that you:
- Confirm that the changes meet the user experience and goals outlined in the content design plan (if there is one).
- Review the content for technical accuracy.
- If there are any failing checks in your PR, troubleshoot them until they're all passing.
We may ask for changes to be made before a PR can be merged, either using suggested changes or pull request comments. You can apply suggested changes directly through the UI. You can make any other changes in your fork, then commit them to your branch.
As you update your PR and apply changes, mark each conversation as resolved.