Merge pull request #1689 from xCROv/Documentation-Update

Author: LilSpazJoekp

AUTHORS.rst

@@ -22,6 +22,7 @@ Documentation Contributors
 - jac0b-w `@jac0b-w <https://github.com/jac0b-w>`_
 - Kenneth Yang `@kennethy <https://github.com/kennethy>`_
 - Tarak Oueriache <[email protected]> `@igosad <https://github.com/igosad>`_
+- xCROv `@xCROv <https://github.com/xCROv>`_
 
 <!-- - Add "Name <email (optional)> and github profile link" above this line. -->
 

praw/models/reddit/subreddit.py

@@ -870,7 +870,8 @@ def submit(
             newly-submitted post to.
         :param flair_id: The flair template to select (default: None).
         :param flair_text: If the template's ``flair_text_editable`` value is True, this
-            value will set a custom text (default: None).
+            value will set a custom text (default: None). ``flair_id`` is
+            required when ``flair_text`` is provided.
         :param resubmit: When False, an error will occur if the URL has already been
             submitted (default: True).
         :param send_replies: When True, messages will be sent to the submission author
@@ -1001,7 +1002,8 @@ def submit_gallery(
             traditional comments (default: None).
         :param flair_id: The flair template to select (default: None).
         :param flair_text: If the template's ``flair_text_editable`` value isTrue, this
-            value will set a custom text (default: None).
+            value will set a custom text (default: None). ``flair_id`` is
+            required when ``flair_text`` is provided.
         :param nsfw: Whether or not the submission should be marked NSFW (default:
             False).
         :param send_replies: When True, messages will be sent to the submission author
@@ -1106,7 +1108,8 @@ def submit_image(
             newly-submitted post to.
         :param flair_id: The flair template to select (default: None).
         :param flair_text: If the template's ``flair_text_editable`` value is True, this
-            value will set a custom text (default: None).
+            value will set a custom text (default: None). ``flair_id`` is
+            required when ``flair_text`` is provided.
         :param resubmit: When False, an error will occur if the URL has already been
             submitted (default: True).
         :param send_replies: When True, messages will be sent to the submission author
@@ -1213,7 +1216,8 @@ def submit_poll(
             newly-submitted post to.
         :param flair_id: The flair template to select (default: None).
         :param flair_text: If the template's ``flair_text_editable`` value is True, this
-            value will set a custom text (default: None).
+            value will set a custom text (default: None). ``flair_id`` is
+            required when ``flair_text`` is provided.
         :param resubmit: When False, an error will occur if the URL has already been
             submitted (default: True).
         :param send_replies: When True, messages will be sent to the submission author
@@ -1289,7 +1293,8 @@ def submit_video(
             newly-submitted post to.
         :param flair_id: The flair template to select (default: ``None``).
         :param flair_text: If the template's ``flair_text_editable`` value is True, this
-            value will set a custom text (default: ``None``).
+            value will set a custom text (default: ``None``). ``flair_id`` is
+            required when ``flair_text`` is provided.
         :param resubmit: When False, an error will occur if the URL has already been
             submitted (default: ``True``).
         :param send_replies: When True, messages will be sent to the submission author