Maybe we can start to add useful docstrings (related to bug 874918), what do you think? :)