Worked on articles.

adewes · adewes · commit dcc6d9bb48f1 · 2015-04-18T21:57:27.000+02:00
diff --git a/docs/correctness/access_to_a_protected_member.rst b/docs/correctness/access_to_a_protected_member.rst
diff --git a/docs/correctness/accessing_a_protected_member_from_outside_the_class.rst b/docs/correctness/accessing_a_protected_member_from_outside_the_class.rst
@@ -0,0 +1,35 @@
+Accessing a protected member from outside the class
+===================================================
+
+Summary
+-------
+
+Accessing a protected member (a member prefixed with ``_``) of a class from outside that class usually
+calls for trouble, since the creator of that class did not intend this function to be exposed.
+
+
+Example
+-------
+
+.. code:: python
+
+    class Rectangle(object):
+        def __init__(self, width, height):
+            self._width = width
+            self._height = height
+
+    r = Rectangle(5, 6)
+    print "Width: {:d}".format(r._width)  # direct access of protected member
+
+Solutions
+---------
+
+If you are absolutely sure that you need to call the proteced function from the outside,
+do the following:
+ * Make sure that calling the function from outside the class does not cause any inadverent side effects.
+ * Refactor it such that it becomes part of the public interface of the class.
+
+References
+----------
+
+- PyLint - W0212
diff --git a/docs/correctness/index.rst b/docs/correctness/index.rst
@@ -4,7 +4,7 @@
 .. toctree::
     :maxdepth: 1
 
-    access_to_a_protected_member
+    accessing_a_protected_member_from_outside_the_class
     bad_except_clauses_order
     Bad arg for super <bad_first_argument_given_to_super>
     Dangerous default arg value <dangerous_default_value_as_argument>
