73 lines
3.5 KiB
Markdown
73 lines
3.5 KiB
Markdown
# Every Contribution Makes a Difference
|
||
|
||
Think of open-source development as free training with a visible outcome.
|
||
Exploring new technologies is easier than in commercial environments,
|
||
where development effort is more focused on immediate results.
|
||
|
||
We welcome contributions of any kind including pull requests, ideas, bug reports,
|
||
testing, writing documentation, tutorials and blog posts. If you help with development,
|
||
you have the opportunity to learn Docker, Go, TensorFlow and much more.
|
||
|
||
Our [Code of Conduct](CODE_OF_CONDUCT.md) explains the dos and don’ts.
|
||
|
||
## Questions? ##
|
||
|
||
Follow us on [Twitter](https://twitter.com/photoprism_app) to receive regular project updates,
|
||
get in contact with other contributors and discuss your ideas.
|
||
|
||
Of all the tools we tested, it works best to get and give continuous feedback.
|
||
Especially polls are amazing for product development.
|
||
|
||
## Roadmap ##
|
||
|
||
Our vision is to provide the most user-friendly solution for browsing, organizing, and sharing your photo collection.
|
||
The [roadmap](https://github.com/photoprism/photoprism/projects/5) shows what tasks are in progress,
|
||
what needs testing, and which feature requests are going to be implemented next.
|
||
|
||
Please give ideas you like a thumbs-up 👍 , so that we know what is most popular.
|
||
Ideas backed by one or more eligible [sponsors](SPONSORS.md) will be prioritized as well.
|
||
|
||
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.
|
||
|
||
## Reporting Bugs ##
|
||
|
||
Please use the [GitHub issue tracker](https://github.com/photoprism/photoprism/issues) to report clearly identified bugs and impediments to us.
|
||
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).
|
||
When reporting an issue, please provide the version in use and information about your environment like browser, operating system, installed memory, and processor type.
|
||
|
||
## Pull Requests ##
|
||
|
||
The [Developer Guide](https://docs.photoprism.app/developer-guide/) contains all information
|
||
necessary to get you started.
|
||
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.
|
||
|
||
Because we want to create the best possible product for our users,
|
||
we have a set of [guidelines](https://docs.photoprism.app/developer-guide/pull-requests)
|
||
to ensure that all source code submissions are acceptable.
|
||
They include step-by-step instructions for submitting new features,
|
||
bug fixes, and documentation improvements.
|
||
|
||
**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.**
|
||
|
||
## Can't code? ##
|
||
|
||
No worries, you may also contribute by...
|
||
|
||
* 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)
|
||
* recommending PhotoPrism to your friends
|
||
* voting for us on pages like:
|
||
* https://alternativeto.net/software/photoprism/about/
|
||
* https://www.saashub.com/google-photos-alternatives
|
||
* publishing tutorials, blog posts, or podcasts
|
||
|
||
Thank you very much! <3
|
||
|
||
|
||
|
||
|
||
|