Barinsta/.github/CONTRIBUTING.md

56 lines
3.9 KiB
Markdown
Raw Normal View History

2020-08-25 21:34:25 +02:00
## WARNING
2020-08-25 21:53:55 +02:00
* All forks must respect [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html). Please report violations in Issues or [confidentially](https://austinhuang.me/#hey-you-look-cool).
2020-11-02 17:47:41 +01:00
* Some people have asked me about publishing a "commercial" fork that serves ads. However, if you do properly comply with GPLv3, users would realize that the original non-commercial version exists and, in turn, abandon your fork. And if you don't comply, you get copystriked.
* Although publishing a fork is allowed by license, it is strongly discouraged to do so as it divides the effort and creates confusion (as well as for the reason above). It is, therefore, recommended to send a pull request back to us, so that the larger community can enjoy your improvement. (This does not apply if you're adapting this app for a different platform other than Instagram.)
2020-08-25 21:34:25 +02:00
## Contributing
2020-09-14 23:31:01 +02:00
Thank you for your interest in Barinsta!
2020-08-25 21:53:55 +02:00
2020-09-14 23:31:01 +02:00
Our vision is an open source true alternative of the official Instagram app. It is Austin's pursuit of a libre life that lead him to this app during its abandonment, and it was one unresolved bug that made him have the enthusiasm in implementing numerous features for this app, despite having 0 knowledge of Java beforehand.
2020-08-25 21:53:55 +02:00
As we grow in popularity, it becomes apparent that we are short on hands. Every contribution counts!
2020-08-25 21:34:25 +02:00
2020-08-25 23:30:47 +02:00
## I want to help coding it!
2020-08-25 21:34:25 +02:00
Great!
Generally, we want to imitate features in the actual Instagram app. There are many Instagram private API repositories on GitHub for you to refer to. Note that you should minimize POST: If a job should be done with GET, then there has to be a GET endpoint. (Indeed, sometimes you need multiple repositories for reference.)
As long as you have tested your version (please indicate device and API version) and make sure it works, then you can submit a PR! Large UI changes have to be voted on by the community, so it would be helpful to upload some screenshots.
Check errors are for reference only. Try to minimize them, but usually they don't make a big difference.
2020-08-25 21:53:55 +02:00
**NEVER touch the l10n-master branch.** It's automatically managed by Crowdin.
2020-09-14 23:31:01 +02:00
The legacy branch is no longer maintained.
2020-08-26 22:06:57 +02:00
2020-08-25 21:34:25 +02:00
### I can't code Java, but I want to!
Fun fact: Austin took over this project and learned Java on the fly (I'm not joking, I only do JavaScript before taking this over).
Even though Java is quite annoying, it is still possible to learn it by trying to understand what these code do (Easier if you have coding experience in other languages).
2020-08-25 21:53:55 +02:00
If you have questions, don't be afraid to ask for help from any current maintainer!
2020-08-25 21:34:25 +02:00
2020-08-25 23:30:47 +02:00
## I found a bug!
2020-08-25 21:34:25 +02:00
**Please read [FAQ](https://barinsta.austinhuang.me/en/latest/faq.html) first.**
2020-08-25 21:34:25 +02:00
2020-08-25 23:30:47 +02:00
Bugs are inevitable during active development, as nobody can cover all the possible test cases.
2020-08-25 21:53:55 +02:00
2020-11-02 17:47:41 +01:00
You can either email your crash dump to `barinsta@austinhuang.me` (The crash reporter will fill in this address for you) or create a GitHub issue. If you're on GitHub, please follow the template. If you're reporting by email, your email address will be published in the GitHub issue. You can contact me [privately](https://austinhuang.me/#hey-you-look-cool) or [through support channels](https://barinsta.austinhuang.me/en/latest/#contact-us) to remove it.
2020-08-25 21:53:55 +02:00
Generally, reporting bugs directly in support channels is not recommended, as they can be difficult to find.
2020-08-25 23:30:47 +02:00
### I want to help... in some other way.
2020-08-25 21:53:55 +02:00
You can...
* translate it [![badge](https://badges.crowdin.net/instagrabber/localized.svg)](https://crowdin.com/project/instagrabber)
* promote it (reddit [r/AndroidApps](https://www.reddit.com/r/androidapps/comments/i30tpp/instagrabber_an_open_source_instagram_client/), YouTube [HowToMen](https://www.youtube.com/watch?v=1Um2ZJG_mB4), [Ekşi Sözlük](https://eksisozluk.com/instagrabber--6643143))
2020-09-14 23:31:01 +02:00
* star it [![stars](https://img.shields.io/github/stars/austinhuang0131/instagrabber.svg?style=social&label=Star)](https://github.com/austinhuang0131/barinsta/stargazers)
2020-08-25 21:53:55 +02:00
Happy contributing!