75 lines
3.4 KiB
Markdown
75 lines
3.4 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 typical enterprise environments, where development efforts
|
|
are more focused on immediate results.
|
|
|
|
We welcome contributions of any kind, including bug reports, testing, writing documentation,
|
|
tutorials, blog posts, and pull requests.
|
|
|
|
## Code of Conduct ##
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
|