update documentation, add shortcode context-specific filtering
start readme documentation