Add a section on naming methods

zedr · zedr · commit ffb5fa3709e7 · 2018-08-28T21:15:15.000+02:00
diff --git a/README.md b/README.md
@@ -373,38 +373,26 @@ def email_client(clients: Iterator[Client]) -> None:
 
 **Bad:**
 
-```php
-class Email
-{
-    //...
-
-    public function handle()
-    {
-        mail($this->to, $this->subject, $this->body);
-    }
-}
+```python
+class Email:
+    def handle(self) -> None:
+        # Do something...
 
-$message = new Email(...);
-// What is this? A handle for the message? Are we writing to a file now?
-$message->handle();
+message = Email()
+# What is this supposed to do again?
+message.handle()
 ```
 
 **Good:**
 
-```php
-class Email 
-{
-    //...
-
-    public function send()
-    {
-        mail($this->to, $this->subject, $this->body);
-    }
-}
+```python
+class Email:
+    def send(self) -> None:
+        """Send this message.
+        """
 
-$message = new Email(...);
-// Clear and obvious
-$message->send();
+message = Email()
+message.send()
 ```
 
 **[⬆ back to top](#table-of-contents)**
