add doctstings

lettings/models.py

@@ -3,6 +3,17 @@ from django.core.validators import MaxValueValidator, MinLengthValidator
 
 
 class Address(models.Model):
+    """
+    Details of the physical location of a property
+    """
+
+    class Meta:
+        """
+        Fix the plural displayed in admin
+        """
+        verbose_name_plural = "Addresses"
+
+
     number = models.PositiveIntegerField(validators=[MaxValueValidator(9999)])
     street = models.CharField(max_length=64)
     city = models.CharField(max_length=64)
@@ -11,12 +22,18 @@ class Address(models.Model):
     country_iso_code = models.CharField(max_length=3, validators=[MinLengthValidator(3)])
 
     def __str__(self):
+        """ Display object with basic address """
         return f'{self.number} {self.street}'
 
 
+
 class Letting(models.Model):
+    """
+    Announce for a property to rent
+    """
     title = models.CharField(max_length=256)
     address = models.OneToOneField(Address, on_delete=models.CASCADE)
 
     def __str__(self):
+        """ display object with title """
         return self.title