Improve documentation for parsing extension directive options

[joelgallant]

• Find a good format to outline each directive and options, instead of being adhoc
• Provide expandable examples for every directive
• Improve search indexing for these so they're found easily