docs: add ApplicationSettings API

3 files changed, 31 insertions, 0 deletions

diff --git a/docs/api-objects.rst b/docs/api-objects.rst
index 5c92021..166b1d9 100644
--- a/docs/api-objects.rst
+++ b/docs/api-objects.rst
@@ -19,4 +19,5 @@ API objects manipulation
    gl_objects/milestones
    gl_objects/projects
    gl_objects/runners
+   gl_objects/settings
    gl_objects/users
diff --git a/docs/gl_objects/settings.py b/docs/gl_objects/settings.py
new file mode 100644
index 0000000..834d43d
--- /dev/null
+++ b/docs/gl_objects/settings.py
@@ -0,0 +1,8 @@
+# get
+settings = gl.settings.get()
+# end get
+
+# update
+s.signin_enabled = False
+s.save()
+# end update
diff --git a/docs/gl_objects/settings.rst b/docs/gl_objects/settings.rst
new file mode 100644
index 0000000..26f68c5
--- /dev/null
+++ b/docs/gl_objects/settings.rst
@@ -0,0 +1,22 @@
+########
+Settings
+########
+
+Use :class:`~gitlab.objects.ApplicationSettings` objects to manipulate Gitlab
+settings. The :attr:`gitlab.Gitlab.settings` manager object provides helper
+functions.
+
+Examples
+--------
+
+Get the settings:
+
+.. literalinclude:: settings.py
+   :start-after: # get
+   :end-before: # end get
+
+Update the settings:
+
+.. literalinclude:: settings.py
+   :start-after: # update
+   :end-before: # end update