use more informative link for pure directives
more transparency examples; transparency notes in readme