incorporate https://github.com/openaps/docs/pull/528 from bdr1177
incorporate https://github.com/openaps/docs/pull/528 from bdr1177

openaps/docs,dakago/docs,danamlewis/docs,jbwittmer/docs,danamlewis/docs,Jieseldeep/docs,Pazoles/docs,sarahspins/docs