docs(directives): tune down title font size
docs(directives): add a pitfall discussed in #11.