photoprism/CONTRIBUTING.md
2022-01-17 14:41:05 +01:00

3.7 KiB
Raw Blame History

Every Contribution Makes a Difference

We welcome contributions of any kind, including blog posts, tutorials, testing, writing documentation, and pull requests. Our Developer Guide contains all the information necessary for you to get started.

Join the Community

Follow us on Twitter and join the Community Chat to get regular updates, connect with other contributors, and discuss your ideas. Our Code of Conduct explains the "dos and donts."

An important part of our journey is to explore new ways in product development and build better software through consistent use of community feedback. Feel free to share your thoughts with us at any time.

Creating Bug Reports

Before reporting a bug, please use our Troubleshooting Checklists to determine the cause of your problem. If you have a general question, need help, or an issue has not (yet) been clearly identified:

GitHub Issues

Never report a bug unless you are certain to have found a new issue that must be fixed directly in our source code:

  • Contact us or a community member if you need help, it could be a local configuration problem, or a misunderstanding in how the software works
  • This gives our team the opportunity to improve the documentation and provide best-in-class support to you, instead of handling unclear and/or duplicate bug reports
  • When reporting a problem, always include the software versions you are using and other information about your environment such as browser, browser plugins, operating system, storage type, memory size, and processor

Submitting Pull Requests

Because we want to create the best possible product for our users, we have a set of guidelines to ensure that all source code submissions are acceptable.

They include step-by-step instructions for submitting new features, bug fixes, and documentation improvements. Issues labeled help wanted / easy can be good (first) contributions.

Reviewing, testing and finally merging pull requests requires significant resources on our side. If it's not just a small fix, it can take several months.

Not a Developer? No Problem

You can also contribute by...


PhotoPrism® is a registered trademark. Our Trademark and Brand Guidelines, which may be updated from time to time, describe how our Brand Assets may be used. It is important to us that any permitted use of our Brand Assets is fair and meets the highest standards.