averez-doc: add "What should I log?" section
averez-doc: fix links