improved docs code block formatting
improved formatting of field lists in docs