Hi, Multiple IP Address per NIC documentation is ready for review. The doc is attached at https://issues.apache.org/jira/browse/CLOUDSTACK-809.
Please see 15.9. Configuring Multiple IP Addresses on a Single NIC (134), and provide your feedback. Regards -Radhika