Document that infallible functions should be avoided

[erlend-aasland]

When designing new C API's, we should (mostly) avoid introducing infallible APIs. The C API guidelines should be amended to take this into account. See capi-workgroup/problems#20.

[erlend-aasland]

See #1123