improving syntax to conform with sphinx conventions