hugo-tufte/CONTRIBUTING.md
slashformotion cb01b32951 chores
2021-07-25 10:05:22 +02:00

2.2 KiB

Introduction

First off, thank you for considering contributing to Hugo-Tufte!

Ground Rules

  • Respect the Code of conduct
  • If you just have a question use this Discussion.

How to report a bug

Tell your contributors how to file a bug report.

You can even include a template so people can just copy-paste (again, less work for you).

When filing an issue, make sure to answer these five questions:

  1. What version of Go are you using ($ hugo version)?
  2. What operating system and processor architecture are you using?
  3. What did you do?
  4. What did you expect to see?
  5. What did you see instead?

How to suggest a feature or enhancement

If you find yourself wishing for a feature that doesn't exist in hugo-tufte, you are probably not alone. There are bound to be others out there with similar needs. Open an issue on our issues list on GitHub which describes the feature you would like to see, why you need it, and how it should work.

Your First Contribution

Learn how pull request works here:

Working on your first Pull Request? You can learn how from this free series, How to Contribute to an Open Source Project on GitHub.

At this point, you're ready to make your changes! Feel free to ask for help here; everyone is a beginner at first 😸

If a maintainer (me) asks you to "rebase" your PR, they're saying that a lot of code has changed, and that you need to update your branch so it's easier to merge.

Getting started to contribute with code

  1. Create your own fork of the code
  2. Do the changes in your fork
  3. If you like the change and think the project could use it:
    • Be sure that you didn't break anything.

Community

You can chat with me here.