= docs: document the future directives
= docs: improvements based on jrudolph feedback
Merge pull request #528 from ivantopo/documentation/future-directives

= docs: document the future directives