Docs: add nindent preference, relocate toYaml preference

Update the developer documentation.

1. Add section specific to these styling /usage preferences
2. Include our preference to nindent over indent
3. Relocate toYaml "when to use" into this new section