The fence agent API is documentation is highly incomplete

[sjvudp]

https://github.com/ClusterLabs/fence-agents/blob/master/doc/FenceAgentAPI.md is highly incomplete, i.e.: No-one is able to develop a fence agent using that information only.
For example stonith -n calls the agent with parameter getconfignames (found by stracing stonith).
When using stonith -m the parameters are getinfo-devdescr, getinfo-devid, and getinfo-xml.
None of those parameters is documented.

I also think that any fence agent should have a "not-really" (-n) option that prevents actually performing fencing operations.
Such would be very valuable when testing the parameter processing of the agent (once there is a tool like ocf-tester for fence agents).

[oalbrigt]

#552