mirror of
https://github.com/BlueMap-Minecraft/BlueMap.git
synced 2024-11-22 18:45:21 +01:00
73 lines
4.1 KiB
Markdown
73 lines
4.1 KiB
Markdown
# How to contribute
|
|
|
|
You want help me make BlueMap better? Awesome!<br>
|
|
Here you learn how it works and what you need to know before contributing.
|
|
|
|
>**Please read this before creating an Issue or a PullRequest!** Issues/PR's that don't follow these instructions will be closed!<br>
|
|
>**Issues are NOT for asking questions!** If you have a question, please use our [Discord](https://discord.gg/zmkyJa3) or [Reddit](https://www.reddit.com/r/BlueMap/)!
|
|
|
|
### Table of Contents
|
|
- [Reporting a Bug](#reporting-a-bug)
|
|
- [Suggesting a new feature or change](#suggesting-a-new-feature-or-change)
|
|
- [Creating a Pull-Request](#creating-a-pull-request)
|
|
|
|
## Reporting a Bug
|
|
The first thing you need to do, is to make sure what you found is actually a bug:<br>
|
|
- A bug is an unintended behaviour of an implemented feature.
|
|
BlueMap is not "done", there are quite a lot of features missing!
|
|
So, if something doesn't work because it is not implemented yet, its not a bug.
|
|
If you are not sure, you can briefly ask about it in our [Discord](https://discord.gg/zmkyJa3) before creating an Issue. :)
|
|
- Make sure you tested it well enough to be sure it's not an issue on your end. If something doesn't work for you but for everyone else, its probably **not** a bug!
|
|
|
|
Also, please make sure no one else has already reported the same or a very similar bug!
|
|
If you have additional information for an existing bug-report, you can add a comment to the already existing Issue :)
|
|
|
|
To report your bug, please open a [new Issue](https://github.com/BlueMap-Minecraft/BlueMap/issues/new?template=bug_report.md) with the `Bug report`-template and follow these guidlines:
|
|
|
|
### Guidlines for a good Bug-Issue
|
|
**A short, informative Title**<br>
|
|
Your Issue should have a short but informative title, which makes it possible to distinquish it from- and easily recognize it in-between- other Issues.
|
|
If someone else finds the same bug, they should be able to find your Issue only based on the title!
|
|
|
|
**A detailed description**<br>
|
|
Describe your bug in as much detail as possible:
|
|
- What did you do before it happened? (How can the bug be reproduced?)
|
|
- What did you expect to happen?
|
|
- What happened instead?
|
|
- CONTEXT!!
|
|
- The exact BlueMap-Version (e.g. the name of the used .jar file)
|
|
- The used os and platform (Windows/Linux, Spigot/Paper/Forge/Fabric/Sponge)
|
|
- Has the world been generated using any minecraft-mods?
|
|
- etc..
|
|
- Is there a log- or a config-file that might help? Include it.
|
|
- Maybe add a screenshot or video for illustration.
|
|
|
|
**Well formatted and structured**<br>
|
|
Make sure your Issue is easy to read and not a mess:
|
|
- Use paragraphs to structure your issue.
|
|
- Use [Markdown](https://guides.github.com/features/mastering-markdown/) to add headings and formatting.
|
|
- Use codeblocks for log-snippets.
|
|
- Upload full logs as file-attachments or use a paste-site like [GitHub Gists](https://gist.github.com/) or [Pastebin](https://pastebin.com/).
|
|
|
|
**One Issue, one bug**<br>
|
|
Create a separate Issue for each bug you find! Issues that contain more than one bug will be closed!
|
|
|
|
## Suggesting a new feature or change
|
|
Please use our [discord](https://discord.gg/zmkyJa3)s #suggestions channel to pitch new ideas.
|
|
We will discuss them there and if they are considered, I'll add an issue/note to out [TODO](https://github.com/orgs/BlueMap-Minecraft/projects/2/views/1)-Board!
|
|
|
|
## Creating a Pull-Request
|
|
If you want to develop a new PR, please run your Idea by me first in our [discord](https://discord.gg/zmkyJa3)!
|
|
We can discuss details there, since I have a lot of future plans in my head that are not written anywhere, and they might need to be considered
|
|
when implementing your feature!
|
|
*(Also, I tend to be quite picky about certain implementation styles and details ^^')*
|
|
|
|
**Please keep in mind that any feature you implement will need to be maintained in the future by me.
|
|
For this reason I will only accept PR's for features that I deem to be useful, maintainable, in-scope of the project and
|
|
worth it's maintenance-workload!**
|
|
|
|
Ofc the usual "good code quality..." stuff, i think that's common sense.
|
|
Try to match the existing code-style.
|
|
Don't add new libraries/dependencies without my ok.
|
|
Hacky stuff is not allowed =)
|