mirror of
https://github.com/sbrl/Minetest-WorldEditAdditions.git
synced 2024-11-25 08:33:00 +00:00
Add contributing guide
This commit is contained in:
parent
b7eab3a6e5
commit
5009ca7782
1 changed files with 25 additions and 0 deletions
25
CONTRIBUTING.md
Normal file
25
CONTRIBUTING.md
Normal file
|
@ -0,0 +1,25 @@
|
|||
# Contributing Guide
|
||||
|
||||
Hey there! So you like WorldEditAdditions enough to consider helping out? That's awesome! This guide should get you up and running in no time.
|
||||
|
||||
|
||||
## Code structure
|
||||
The WorldEditAdditions codebase is split into 3 main submods:
|
||||
|
||||
Name | Description
|
||||
--------------------------------|------------------------
|
||||
`worldeditadditions` | The main mod. Core world manipulation implementations should go in here.
|
||||
`worldeditadditions_commands` | Chat commands. These interact with the core manipulators in `worldeditadditions` mod.
|
||||
`worldeditadditions_farwand` | Everything to do with the far wand tool. It's different enough to everything else that it warrants it's own separate mod to avoid muddling things.
|
||||
|
||||
Additionally, every command should be implemented in its own file. This helps keep things organised and files short.
|
||||
|
||||
## Guidelines
|
||||
When actually implementing stuff, here are a few guidelines that I recommend to summarise everything:
|
||||
|
||||
- Keep each command implementation to its own file
|
||||
- Split up files with more than 500 lines into smaller chunks (such as what I've done with the `//convolve` implementation in the `worldeditadditions` submod)
|
||||
- Try to follow the existing programming style
|
||||
- If you think of something helpful to add to this guide, please open an issue / PR :D
|
||||
- Being excellent to everyone shouldn't have to be on this list, but it is
|
||||
- @sbrl has the final say
|
Loading…
Reference in a new issue