add doc8 validation

doc8 is similar to flake8, but for documentation: it's an opinionated
style checker.

  https://github.com/stackforge/doc8

This patch also fixes two violations, regarding maximum line length and
trailing whitespace.

Change-Id: Icdbd360cea149f1af72243a59efedaed504ff336