[TASK] Improves commenting for sphinx

Comments now contain a method signature and parameters with
types for all constructors available.

Also includes a small fix to the editor.py