fix: remove the word "optional", align some docs (#680)

removed the word "optional" whenever possible, as the schemas clearly
tell when something is optional or required.
as agreed in
#616 (comment)
and
#649 (comment)

- fixes #616
- fixes #649

Author: jkowalleck