I felt quite confused reading this section. It felt like there was a disconnect between the heading and the text of the section; not clear immediately what "publish" means or how the words in the section connect to the phrase "publish mode."
Some concrete suggestions:
[ ] Introduce/define the term publish. As of this writing, the term only appears in a section heading and a code snippet.
[ ] Consider dropping the term publish-mode; the current name implies publish only, while the text of this section reflects call Bonsai from off-chain and then publish.
[ ] Consider moving this section (and the previous section?) out of the ## Testing your Program section
[ ] Revise to reflect user oriented framework of ## call bonsai from on-chain and ## call bonsai from off-chain
I felt quite confused reading this section. It felt like there was a disconnect between the heading and the text of the section; not clear immediately what "publish" means or how the words in the section connect to the phrase "publish mode."
Some concrete suggestions:
publish
. As of this writing, the term only appears in a section heading and a code snippet.publish-mode
; the current name impliespublish only
, while the text of this section reflectscall Bonsai from off-chain and then publish
.call bonsai from on-chain
and ##call bonsai from off-chain