[docs] Rework the examples pages

* Get rid of the .py files and bring all the python examples in the RST
files
* Fix a few things

1 files changed, 23 insertions, 33 deletions

diff --git a/docs/gl_objects/labels.rst b/docs/gl_objects/labels.rst
index 3c8034d..1c98971 100644
--- a/docs/gl_objects/labels.rst
+++ b/docs/gl_objects/labels.rst
@@ -11,50 +11,40 @@ Reference
   + :class:`gitlab.v4.objects.ProjectLabelManager`
   + :attr:`gitlab.v4.objects.Project.labels`
 
-* v3 API:
-
-  + :class:`gitlab.v3.objects.ProjectLabel`
-  + :class:`gitlab.v3.objects.ProjectLabelManager`
-  + :attr:`gitlab.v3.objects.Project.labels`
-  + :attr:`gitlab.Gitlab.project_labels`
-
 * GitLab API: https://docs.gitlab.com/ce/api/labels.html
 
 Examples
 --------
 
-List labels for a project:
-
-.. literalinclude:: labels.py
-   :start-after: # list
-   :end-before: # end list
-
-Get a single label:
+List labels for a project::
 
-.. literalinclude:: labels.py
-   :start-after: # get
-   :end-before: # end get
+    labels = project.labels.list()
 
-Create a label for a project:
+Create a label for a project::
 
-.. literalinclude:: labels.py
-   :start-after: # create
-   :end-before: # end create
+    label = project.labels.create({'name': 'foo', 'color': '#8899aa'})
 
-Update a label for a project:
+Update a label for a project::
 
-.. literalinclude:: labels.py
-   :start-after: # update
-   :end-before: # end update
+    # change the name of the label:
+    label.new_name = 'bar'
+    label.save()
+    # change its color:
+    label.color = '#112233'
+    label.save()
 
-Delete a label for a project:
+Delete a label for a project::
 
-.. literalinclude:: labels.py
-   :start-after: # delete
-   :end-before: # end delete
+    project.labels.delete(label_id)
+    # or
+    label.delete()
 
-Managing labels in issues and merge requests:
+Manage labels in issues and merge requests::
 
-.. literalinclude:: labels.py
-   :start-after: # use
-   :end-before: # end use
+    # Labels are defined as lists in issues and merge requests. The labels must
+    # exist.
+    issue = p.issues.create({'title': 'issue title',
+                             'description': 'issue description',
+                             'labels': ['foo']})
+    issue.labels.append('bar')
+    issue.save()