diff --git a/configuration/chassis.rst b/configuration/chassis.rst
index 2a8a317..11b433a 100644
--- a/configuration/chassis.rst
+++ b/configuration/chassis.rst
@@ -77,6 +77,15 @@
 A ``singleton port`` uniquely identifies a switch port and it contains the following fields:
 
 * ``id``: An arbitrary ID, unique in the scope of a chassis. **Required**
+
+    .. note::
+        We recommend using the following naming convention for both ONOS network config and Stratum chassis config:
+            - For unchannelized ports, use the **front panel port** number directly.
+            - For channelized ports, use the **front panel port number * 100 + channel id**.
+              For example, we can use port id ``2903`` for port ``29/3`` (port 29 channel 3).
+            - Note that we use **zero-based** channel number for singleton port ``id``
+              but the ``channel`` field described below uses **one-based** channel number.
+
 * ``name``: An optional user friendly name for the port (e.g., ``10/1`` to identify channel
   1 of front-panel port 10). **Required**