Add description of custom resource classes

Add the description about custom resource classes and
overriding standard resource classes in the "Flavors" document.

Change-Id: I5b804db70d229696e7b7c5b5db16946cf1f1c49f
Closes-Bug: #1800663

doc/source/user/flavors.rst

@@ -650,6 +650,27 @@ Secure Boot
   - ``disabled`` or ``optional``: (default) Disable Secure Boot for instances
     running with this flavor.
 
+Custom resource classes and standard resource classes to override
+    Added in the 16.0.0 Pike release.
+
+    Specify custom resource classes to require or override quantity values of
+    standard resource classes.
+
+    The syntax of the extra spec is ``resources:<resource_class_name>=VALUE``
+    (``VALUE`` is integer).
+    The name of custom resource classes must start with ``CUSTOM_``.
+    Standard resource classes to override are ``VCPU``, ``MEMORY_MB`` or
+    ``DISK_GB``. In this case, you can disable scheduling based on standard
+    resource classes by setting the value to ``0``.
+
+    For example:
+
+    - resources:CUSTOM_BAREMETAL_SMALL=1
+    - resources:VCPU=0
+
+    See :ironic-doc:`Create flavors for use with the Bare Metal service
+    <install/configure-nova-flavors>` for more examples.
+
 .. _extra-specs-required-traits:
 
 Required traits