Enforce strict docs compilation and add Documentation best practices guidelines

Enforce strict docs compilation and add Documentation best practices guidelines #924