From adcd51d6f1450582b8f3eab2063260ee833bac8c Mon Sep 17 00:00:00 2001
From: ClosedPort22 <44864697+ClosedPort22@users.noreply.github.com>
Date: Thu, 5 Jan 2023 17:31:57 +0800
Subject: [PATCH] [docs] update OAuth guide in configuration.rst

The Pixiv extractor requires a 'refresh-token' since 8974f0361c9cd9b53a7b7b21c96bd21b997dd596 (mikf#1304).
---
 README.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/README.rst b/README.rst
index 3a09e3e9612..6267cf24a0e 100644
--- a/README.rst
+++ b/README.rst
@@ -328,7 +328,10 @@ For example:
 OAuth
 -----
 
-*gallery-dl* supports user authentication via OAuth_ for
+*gallery-dl* supports user authentication via OAuth_ for some extractors.
+This is necessary for
+``pixiv``
+and optional for
 ``deviantart``,
 ``flickr``,
 ``reddit``,
@@ -336,12 +339,12 @@ OAuth
 ``tumblr``,
 and ``mastodon`` instances.
 
-This is mostly optional, but grants *gallery-dl* the ability
-to issue requests on your account's behalf and enables it to access resources
-which would otherwise be unavailable to a public user.
+Linking your account to *gallery-dl* grants it the ability to issue requests
+on your account's behalf and enables it to access resources which would
+otherwise be unavailable to a public user.
 
-To link your account to *gallery-dl*, start by invoking it with
-``oauth:<sitename>`` as an argument. For example:
+To do so, start by invoking it with ``oauth:<sitename>`` as an argument.
+For example:
 
 .. code:: bash