- fix the marker here so this page can be found
- clarify the note about the defaults, note that it's upcoming in 1.0