Add inline documentation for `toggle`

[dpikt]

Old docs can be found in legacy-docs.md. Remember to delete the relevant section once it's been added to the auto-generated docs.

[davemcorwin]

@dpikt I know how you feel about toggling...

[dpikt]

@davemcorwin I go back and forth 😏