API docs for configurable external gateway modes extension

Bug 1216576

The documentation discusses how the router resources is extended and provides
information concerning how to enable or disable SNAT using the Neutron API.

Change-Id: I20f2913495558dd40b1d9ffa59797a97a342bf49