From 3178c4c957cf1fbf44e2010a769b98bcc7d0ea47 Mon Sep 17 00:00:00 2001 From: Raymond <101374892+raymonable@users.noreply.github.com> Date: Sat, 4 Jul 2026 19:59:18 -0400 Subject: [PATCH] chore: revamp CONTRIBUTING.md --- CONTRIBUTING.md | 46 ++++++++++++++-------------------------------- 1 file changed, 14 insertions(+), 32 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c07f0ca5..57a5e733 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,37 +1,19 @@ -# CONTRIBUTING -Thanks for your interest in improving Aqua server, and huge welcome! This document will guide you how to get started. +# Contribution -# Before you start +Thank you for your interest in contributing to the AquaDX server and/or AquaNet web interface implementation. +Please look over the following guidelines before creating an issue or pull request. -* We (or at least I, the fork maintainer) will not care where you come from or what kind of scene you involve with as long as you are in good faith. -* This fork might have n-0 or even n+1 support from time to time. If you can't agree with this, please refrain from get involve with this project. -* We **will not help you to get game itself**. This includes sharing a patched or original binary. Please don't ask or give guidance about it within this repository. This is bare minimum for our safety and long run possibility of this project. +- We try to support game versions that are n-0 (and occasionally n+1).
+By using this server and/or contributing source, you understand some features may be incomplete due to restrictions (whether it's technical or due to it being n-0). -# Getting started +- Issues should describe a problem or feature request for either AquaDX or AquaNet.
+Please do not ask for game dumps, ask for assistance with setting up a game dump or send links to game dumps. -* Please make sure you read README.md and documents in /docs folder. -* Make sure you have account for this gitlab instance. +- Pull requests should have meaningful descriptions and changes should match the rest of our codebase to be accepted.
+Commits can be formatted in any way preferable as long as they're easily digestable and meaningful.
+All pull requests must be tested and ensured functional.
+If contributing to the server (AquaDX), the server should be capable of booting to the colorful logo & affected clients should be able to connect and make use of your contribution(s).
+If contributing to the web interface (AquaNet), it should be capable of building, shouldn't report any errors and should make use of your contribution(s). -# Steps to follow - -* Open a issue: if you found a bug or want to add or suggest new feature, try open a issue first so we can know about the problem and start discussion. - * Include some kind of information (for example: error log if a bug; what you trying to achieve if a new feature) - * This step is not essential but will make thing much easier later on. (PR) - * If you are end user (not a developer), it ends in here. Thanks! - -* Fork it and make a new branch where you start working on it. - * Please make a branch per PR if you are thinking about making multiple PRs. Still, we can cherry-pick even it's not but.. - -* Start working - * We don't have any code formatting guide or rule. As long as code runs fine and readable enough, good to go. - * Make commits of logical and atomic units. Please DO NOT make a commit message too general like "WIP - 1" or "Work". - -* Test if it works - * Database changes: default database testing is sqlite only. If you are not sure or can't test with MariaDB or MySQL, just leave a message about it in the PR. - * Game endpoint changes: Although aqua have testing process while building and packaging, this probably won't do much for the game so our recommendation is run through a game at least once (from entry to saving). - * Server API / feature / bug fix: Just test at least once the way you want. - -* Make a PR - * Thanks! We will get you know when it's ready. - -We appreciate your time. Contribution is what makes open source project interesting and keep working. \ No newline at end of file +- AquaDX makes use of the [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.en) license.
+By contributing, you agree your contributions can be placed under this license.