diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index e2aa9a0..736d45c 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -24,4 +24,9 @@ If applicable, add error messages and tracebacks to help explain your problem. **Additional context** Add any other context about the problem here. - + diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md index 3ee1f53..1b318c2 100644 --- a/.github/ISSUE_TEMPLATE/question.md +++ b/.github/ISSUE_TEMPLATE/question.md @@ -7,6 +7,12 @@ labels: question Your question here... - + + - has a concise and meaningful title, + - is not covered by the documentation: https://instaloader.github.io/, + - is actually related to Instaloader (this is not a Python help forum), + - has not already been answered here or on other sites such as Stack Overflow: https://stackoverflow.com/questions/tagged/instaloader, + - is written in a polite and welcoming tone. +--> diff --git a/docs/contributing.rst b/docs/contributing.rst index f27b70a..074af63 100644 --- a/docs/contributing.rst +++ b/docs/contributing.rst @@ -11,6 +11,15 @@ Instaloader's development is organized on `GitHub `__, where Issues and Pull Requests are discussed. +Answering Questions +------------------- + +The easiest way to help out is to answer questions. If you are interested in +answering questions regarding Instaloader, good places to start are + +- `Questions tagged 'instaloader' on Stack Overflow `__, +- `Instaloader Issues labeled 'question' `__. + Reporting Bugs -------------- @@ -41,22 +50,39 @@ reporting a problem, please keep the following in mind: Writing Code or Improving the Documentation ------------------------------------------- -Changes of the Instaloader source can be proposed as a -`Pull Request `__. There are only -few things to consider: +Improvements of the Instaloader source or its documentation can be proposed as a +`Pull Request `__. -- Base your Pull Request on the ``master`` branch if it fixes a bug, - or the ``upcoming/v4.X`` branch (if it exists at the moment of submitting the PR) - otherwise. +- Please base your Pull Request on -- We use `Pylint `__ for error and syntax checking of - the source and `MyPy `__ for type checking. - Beware that sometimes it might be better to disable a warning rather than - adapting the code to a tool's desires. + - ``master``, which will be released with the next minor release, if it is -- The documentation source is located in the ``docs`` folder. The file - ``cli-options.rst`` is merely an RST-formatted copy of ``instaloader --help`` - output, of which the source is in ``instaloader/__main__.py``. + - a bug fix that does not require extensive testing, + - an improvement to the documentation, + + - ``upcoming/v4.X``, if it is + + - a new feature, + - a bug fix that does require thorough testing before being released to a + final version. + +- All Pull Requests are analyzed by `Pylint `__ for + error and syntax checking of the source and + `Mypy `__ for type checking. You can run them + locally with:: + + pylint instaloader + mypy -m instaloader + +- Improvements to the documentation are very welcome. The documentation is + created with `Sphinx `__, version 2, + and can be build locally using:: + + make -C docs html + +- Feel free to create an issue to make sure someone from the Instaloader team + agrees that the change might be an improvement, and is happy with your basic + proposal, before working on a pull request. Proposing Features ------------------