doc: https://docs.ubuntu.com/maas/2.1/en/api states "bond-mode" instead of bond_mode

[JuanJo Ciarlante]

$ curl -s https://docs.ubuntu.com/maas/2.1/en/api |egrep bond.mode
<p><code>param bond-mode</code>
<p>Supported bonding modes (bond-mode):</p>
<p>Supported bonding modes (bond-mode): balance-rr - Transmit packets in

while it's actually:
$ maas maas-root interfaces create-bond --help |egrep bond.mode
:param bond_mode: The operating mode of the bond.
Supported bonding modes (bond-mode):

$ dpkg-query -W maas
maas 2.1.3+bzr5573-0ubuntu1~16.04.1

NOTE also that maas maas-root interfaces create-bond
silently ignores being passed eg bond-mode=active-backup
(ie doesn't fail as it should).

NOTE also that this "small" difference has quite time
consuming implications, as fixing these interfaces
requires releasing deployed machines (after finding
out incorrect /e/n/i).

[Andres Rodriguez (andreserl)]

I've checked the code vs the api document, and the error is in the API document. Not the code. This means that whatever script is creating the documentation is not creating things correctly and replacing "_" with "-"

[Paul Gear (paulgear)]

Arguably, both should be supported by analogy with /etc/network/interfaces.

[Graham Morrison (morrisong)]

This has been fixed with recent updates to the API docs build process. See https://github.com/CanonicalLtd/maas-docs/issues/439.