Contributing

Pandoryx isn’t just a bot — it’s a philosophy. This project is about building server tools that are powerful without being overwhelming, easy to use without sacrificing flexibility, and — above all — human-centered. Whether you're a developer, writer, UX nerd, or someone who just has a great idea for making things smoother, your perspective is welcome here.

You don’t need to know how to code to be a contributor. Contributions come in all shapes: feature ideas, typo catches, better button wording, new docs, or simply asking smart questions that help us clarify confusing systems.

What We're Looking For

Here’s a breakdown of how you can participate and where to go when you’re ready:

Help with Documentation

We maintain a Docusaurus documentation for clear, beginner-friendly documentation. You can contribute by:

• Writing or polishing individual command pages
• Catching typos, awkward phrasing, or incomplete instructions
• Suggesting better layouts, examples, or visuals
• Making suggestions for better onboarding or quick start guides
• Even small edits make a big difference.

Suggest Features & UX Improvements

We encourage thoughtful feature suggestions, whether they’re small usability tweaks or larger ideas.

Where to do this:

This discussion thread is the home for:

• Brainstorming new features
• UI/UX improvements
• Feedback about command flow
• “Would this be helpful?” conversations

It’s collaborative — your idea doesn’t have to be perfect or final. Feel free to comment on others' ideas too!

Reporting Bugs

If you run into unexpected behavior, weird edge cases, or broken functionality — we want to know about it.

Where to do this:

Please do NOT open new issues. Instead, comment on the pinned bug report thread and include:

• What happened (and what should have happened)
• How to reproduce it (if possible)
• Screenshots or errors, if relevant
• What command or feature was involved

Ask Questions or Get Help

Not sure how something works? Confused about a command? Want examples?

Where to do this:

This is a judgment-free space where you can:

• Ask for clarification
• Share usage tips
• Request examples
• Get help with setup or behavior questions

Sometimes these questions help shape future docs — so they’re more valuable than you think!

Developer Contributions

If you’re a dev and want to get involved with the bot code, you’re welcome to submit PRs — especially for:

• Refactoring / cleaning up logic
• Minor feature additions
• Quality-of-life improvements
• Fixing labeled issues (help wanted, good first issue)

Local Setup (basic):

git clone https://github.com/your-org/pandoryx-bot.git
cd pandoryx-bot
npm install
# Add your .env file
npm run dev

More complete developer notes and environment variables coming soon in the GitBook Dev section.

Project Values

Before jumping in, here’s what matters most around here:

• Clarity is everything – We prioritize ease of use and clear explanations over complexity
• Low friction, high value – Contributions should reduce effort for the end user, not add more
• Community-first – We care deeply about people being able to use the bot without needing to “figure it out”
• Respectful and direct – We’re chill and cozy, but also focused and serious about quality

If that resonates with you, you’ll fit right in.

Quick Contribution Links

Thank you for wanting to contribute to Pandoryx.

Every single suggestion, comment, and PR shapes this project into something more thoughtful, practical, and powerful — and you’re a part of that now.

You’re appreciated.