readme updates

Author: bckohan

README.md

@@ -83,6 +83,30 @@ Many packages aim to ease usage of Python enumerations as model fields. Most wer
     assert instance.int_enum.value == 3
 ```
 
+## Flag Support
+
+``FlagEnum`` types are also seamlessly supported! This allows a database column to behave like a bit mask and is an alternative to multiple boolean columns. There are mostly positive performance implications for using a bit mask instead of booleans depending on the size of the bit mask and the types of queries you will run against it. For bit masks more than a few bits long the size reduction both speeds up queries and reduces the required storage space. See the documentation for [discussion and benchmarks]().
+
+```python
+
+    class Permissions(IntFlag):
+
+        READ = 0**2
+        WRITE = 1**2
+        EXECUTE = 2**3
+
+
+    class FlagExample(models.Model):
+
+        permissions = EnumField(Permissions)
+
+
+    FlagExample.objects.create(permissions=Permissions.READ | Permissions.WRITE)
+
+    # get all models with RW:
+    FlagExample.objects.filter(permissions__all=Permissions.READ | Permissions.WRITE)
+```
+
 ## Complex Enumerations
 
 [django-enum](https://django-enum.readthedocs.io) supports enum types that do not derive from Django's ``IntegerChoices`` and ``TextChoices``. This allows us to use other libs like [enum-properties](https://pypi.org/project/enum-properties) which makes possible very rich enumeration fields:
@@ -149,28 +173,22 @@ Many packages aim to ease usage of Python enumerations as model fields. Most wer
     assert TextChoicesExample.objects.filter(color='FF0000').first() == instance
 ```
 
-## Flag Support
-
-``FlagEnum`` types are also seamlessly supported! This allows a database column to behave like a bit mask and is an alternative to multiple boolean columns. There are (mostly positive) performance implications for using a bit mask instead of booleans depending on the size of the bit mask and the types of queries you will run against it. For bit masks more than a few bits long the size reduction both speeds up queries and reduces the required storage space. See the documentation for [discussion and benchmarks]().
+While they should be unnecessary if you need to integrate with code that expects an interface fully compatible with Django's ``TextChoices`` and ``IntegerChoices`` django-enum provides ``TextChoices`` and ``IntegerChoices`` types that derive from enum-properties and Django's enum types. So the above enumeration could also be written:
 
 ```python
 
-    class Permissions(IntFlag):
-
-        READ = 0**2
-        WRITE = 1**2
-        EXECUTE = 2**3
-
+    from django_enum.choices import TextChoices
 
-    class FlagExample(models.Model):
+    class Color(TextChoices):
 
-        permissions = EnumField(Permissions)
+        rgb: Annotated[t.Tuple[int, int, int], Symmetric()]
+        hex: Annotated[str, Symmetric(case_fold=True)]
 
+        # name value label       rgb       hex
+        RED   = "R", "Red",   (1, 0, 0), "ff0000"
+        GREEN = "G", "Green", (0, 1, 0), "00ff00"
+        BLUE  = "B", "Blue",  (0, 0, 1), "0000ff"
 
-    FlagExample.objects.create(permissions=Permissions.READ | Permissions.WRITE)
-
-    # get all models with RW:
-    FlagExample.objects.filter(permissions__all=Permissions.READ | Permissions.WRITE)
 ```
 
 ## Installation