2020-11-29 12:01:13 +00:00
# Every Contribution Makes a Difference
2019-01-09 01:09:38 +00:00
2021-12-25 19:54:27 +00:00
Think of Open Source development as free training with a visible outcome. Exploring new
technologies is easier than in typical enterprise environments, where development efforts
are more focused on immediate results.
2019-01-09 01:09:38 +00:00
2021-12-25 19:54:27 +00:00
We welcome contributions of any kind, including bug reports, testing, writing documentation,
tutorials, blog posts, and pull requests.
2019-01-09 01:09:38 +00:00
2021-12-25 19:52:20 +00:00
## Code of Conduct ##
2021-12-25 19:56:40 +00:00
Our [code of conduct ](CODE_OF_CONDUCT.md ) explains the "dos and don'ts."
2021-12-25 09:28:22 +00:00
2021-01-31 10:12:45 +00:00
## Questions? ##
2019-01-09 01:09:38 +00:00
2021-05-15 08:53:29 +00:00
Follow us on [Twitter ](https://twitter.com/photoprism_app ) to receive regular project updates,
2021-12-25 09:28:22 +00:00
get in contact with other contributors and discuss your ideas.
2019-01-09 01:09:38 +00:00
2020-11-29 12:01:13 +00:00
Of all the tools we tested, it works best to get and give continuous feedback.
Especially polls are amazing for product development.
2020-01-15 13:45:49 +00:00
2020-11-29 12:01:13 +00:00
## Roadmap ##
2019-01-09 01:09:38 +00:00
2021-08-20 01:08:21 +00:00
Our vision is to provide the most user-friendly solution for browsing, organizing, and sharing your photo collection.
2020-11-29 12:19:59 +00:00
The [roadmap ](https://github.com/photoprism/photoprism/projects/5 ) shows what tasks are in progress,
2020-11-29 12:01:13 +00:00
what needs testing, and which feature requests are going to be implemented next.
2019-01-09 01:09:38 +00:00
2020-11-29 12:01:13 +00:00
Please give ideas you like a thumbs-up 👍 , so that we know what is most popular.
2020-11-29 12:56:00 +00:00
Ideas backed by one or more eligible [sponsors ](SPONSORS.md ) will be prioritized as well.
2019-01-09 01:09:38 +00:00
You are welcome to add specific feature requests directly to our [GitHub issue tracker ](https://github.com/photoprism/photoprism/issues )
if no similar [idea ](https://github.com/photoprism/photoprism/labels/idea )
or [todo ](https://github.com/photoprism/photoprism/labels/todo ) already exists.
Please don't use the issue tracker to ask general questions.
2020-11-29 12:01:13 +00:00
## Reporting Bugs ##
2019-01-09 01:09:38 +00:00
Please use the [GitHub issue tracker ](https://github.com/photoprism/photoprism/issues ) to report clearly identified bugs and impediments to us.
2020-11-29 12:01:13 +00:00
If you're not sure, start by asking in our [community chat ](https://gitter.im/browseyourlife/community ) or [contact us via email ](mailto:help@photoprism.app ).
2019-12-30 19:10:45 +00:00
When reporting an issue, please provide the version in use and information about your environment like browser, operating system, installed memory, and processor type.
2021-01-31 10:12:45 +00:00
## Pull Requests ##
2020-11-29 12:01:13 +00:00
2021-12-12 19:14:07 +00:00
The [Developer Guide ](https://docs.photoprism.app/developer-guide/ ) contains all information
2021-11-27 17:50:29 +00:00
necessary to get you started.
2020-11-29 12:01:13 +00:00
Issues labeled [help wanted ](https://github.com/photoprism/photoprism/labels/help%20wanted ) /
[easy ](https://github.com/photoprism/photoprism/labels/easy ) can be good (first) contributions.
2021-01-30 13:02:15 +00:00
2021-11-27 17:50:29 +00:00
Because we want to create the best possible product for our users,
2021-12-12 19:14:07 +00:00
we have a set of [guidelines ](https://docs.photoprism.app/developer-guide/pull-requests )
2021-11-27 17:50:29 +00:00
to ensure that all source code submissions are acceptable.
They include step-by-step instructions for submitting new features,
bug fixes, and documentation improvements.
2021-01-30 13:02:15 +00:00
2021-11-27 17:50:29 +00:00
**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.**
2021-11-27 14:02:25 +00:00
2021-01-31 10:12:45 +00:00
## Can't code? ##
2021-01-30 13:02:15 +00:00
2021-01-31 10:12:45 +00:00
No worries, you may also contribute by...
2021-01-31 10:18:00 +00:00
* doing [research ](https://github.com/photoprism/photoprism/issues?q=is%3Aopen+is%3Aissue+label%3Aresearch ) or improving our [docs ](https://github.com/photoprism/photoprism/issues?q=is%3Aopen+is%3Aissue+label%3Adocs )
2021-01-31 10:12:45 +00:00
* recommending PhotoPrism to your friends
2021-01-30 13:02:15 +00:00
* voting for us on pages like:
* https://alternativeto.net/software/photoprism/about/
* https://www.saashub.com/google-photos-alternatives
2021-01-31 10:12:45 +00:00
* publishing tutorials, blog posts, or podcasts
2021-01-30 13:02:15 +00:00
2021-01-31 10:13:23 +00:00
Thank you very much! < 3
2021-01-30 13:02:15 +00:00
