Skip to content

Conversation

@Garsooon
Copy link
Member

Adds a contribution.md as noted in issue #127

@Garsooon Garsooon requested a review from RhysB May 24, 2025 08:17
@Garsooon
Copy link
Member Author

There is room for improvement but I think this is a solid starting off point.

Copy link
Contributor

@zavdav zavdav left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm pretty sure the convention is that CONTRIBUTING.md is written in all-caps.
Also left some comments throughout the file


- Line Endings: LF only

- Imports: Group Bukkit imports under // CraftBukkit start comments
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just my personal opinion, but I don't think we should be required to mark new imports with comments

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, this was made more as a starting point going off issue 127 with what it seemed Johny wanted for the repo.


### Legal Requirements Code Provenance
````
Preserve original CraftBukkit (GPL v3) headers
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are currently no file headers in any of the CraftBukkit/Poseidon files, so these would have to be added at some point

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That was one of the things brought up in issue #127

- **Easier Updates**: Smaller diffs simplify merging upstream changes from CraftBukkit/Mojang code in the unlikely case it is needed.
- **Beta Accuracy**: Maintains original physics, protocols, and behavior expected in Beta 1.7.3.
- **Conflict Prevention**: Reduces merge headaches.
- **Legibility**: Clearly separates Poseidon changes from CraftBukkit CB1060 code using `// ProjectPoseidon` markers.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See above for my proposed format for Poseidon comments

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants