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