diff --git a/docs/contributing.rst b/docs/contributing.rst
index 8f800fd..21850a0 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -46,13 +46,13 @@ Changes of the Instaloader source can be proposed as a
few things to consider:
- Base your Pull Request on the ``master`` branch if it fixes a bug,
- or the ``upcoming/v4.X`` (if it exists at the moment of submitting the PR)
- branch otherwise.
+ or the ``upcoming/v4.X`` branch (if it exists at the moment of submitting the PR)
+ otherwise.
- We use `Pylint `__ for error and syntax checking of
- the source and `MyPy `__ for type checking
- (Note that sometimes it might be better to disable a warning rather than
- adapting the code to a tool's desires).
+ 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.
- The documentation source is located in the ``docs`` folder. The file
``cli-options.rst`` is merely an RST-formatted copy of ``instaloader --help``
@@ -89,14 +89,14 @@ details. If you feel the need to do so, please create a "feature suggestion".
obtained, how would it be further processed?
- Describe already-working **alternatives of the feature** and how they
- compare with your proposed solution.
+ compare to your proposed feature.
- Briefly describe how your suggested feature **conforms with Instaloader's
project goal**.
- Explain your **solution ideas**. Describe your ideas on how the feature could
- be implemented and the underlying problem could be solved. Also describe
- alternatives that you have considered.
+ be implemented and the underlying problem could be solved. Also **describe
+ alternatives** that you have considered.
Donations
---------
diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
index 6bc6cbd..110338f 100644
--- a/docs/troubleshooting.rst
+++ b/docs/troubleshooting.rst
@@ -27,11 +27,25 @@ expired. In case the retry continuously fails for some reason, which should not
happen in normal conditions, consider adjusting the
:option:`--max-connection-attempts` option.
+There have been observations that services, that in their nature offer
+promiscious IP addresses, such as cloud, VPN and public proxy services, might be
+subject to significantly stricter limits for anonymous access. However,
+logged-in accesses (see :option:`--login`) do not seem to be affected.
+
+Too many queries in the last time
+---------------------------------
+
**"Too many queries in the last time"** is not an error. It is a notice that the
rate limit has almost been reached, according to Instaloader's own rate
accounting mechanism. We regularly adjust this mechanism to match Instagram's
current rate limiting.
+Private but not followed
+------------------------
+
+You have to follow a private account to access most of its associated
+information.
+
Login Error
-----------