Contributing to TurboLong

Thanks for helping improve TurboLong. This guide covers the branch, issue, commit, and pull request conventions for repository contributions, including Drips wave issues.

Before you start

1. Pick an open issue that matches the change you want to make.
2. For Drips wave work, prefer issues labeled drips, Stellar Wave, and a size label such as size:S.
3. Check that the issue has no assignee and no active linked pull request.
4. Comment on the issue before starting so maintainers and other contributors know you are working on it.
5. Keep the change scoped to the issue acceptance criteria unless a maintainer asks for more.

Branch naming

Use short, descriptive branch names that include the issue number when there is one.

Examples:

• docs/81-contributing-guide
• fix/42-wallet-connect-error
• feat/79-architecture-diagram
• chore/update-alerts-deploy

Commits

Use clear, focused commits. Conventional Commits are encouraged when they fit the change:

• docs: add contributing guide
• fix: handle missing wallet state
• feat: add pool architecture diagram
• test: cover leverage simulation edge case

If a change spans multiple areas, split unrelated work into separate commits or separate pull requests.

Local checks

Run the checks that match the files you changed.

For Rust contracts and simulations:

cargo test

For the frontend:

cd frontend
npm install
npm run build

For alert worker changes:

cd alerts
npm install
npm run build

If a check cannot be run locally, explain why in the pull request.

Pull request etiquette

• Open one pull request per issue or closely related change.
• Link the issue in the description with Closes #<issue-number> when the PR fully resolves it.
• Summarize what changed and list the checks you ran.
• Include screenshots or diagrams for visual UI or documentation changes.
• Keep review comments in the pull request thread so the discussion stays discoverable.
• Be responsive to maintainer feedback and avoid force-pushing during active review unless it is necessary.

Drips wave workflow

Drips wave issues are public contribution opportunities. To keep that workflow clear:

1. Claim the issue by commenting on it before starting work.
2. Mention the issue number in your branch name and pull request description.
3. Match the issue's acceptance criteria exactly before expanding the scope.
4. Mark the pull request as ready for review only after you have run the relevant checks or documented why a check was skipped.
5. Wait for maintainer review, merge, and any Drips-specific confirmation before assuming the contribution is eligible for a reward.

Any reward, payout, or Drips distribution should be handled through the official project or Drips workflow requested by the maintainers.

Code of Conduct and CLA

This repository does not currently include a project-specific Code of Conduct or Contributor License Agreement. Until one is added, contributors are expected to follow the GitHub Community Guidelines and keep discussion respectful, focused, and constructive.

If the project adds a CLA or a maintainer requests one for a contribution, complete that process before the pull request is merged.