colorwas a function that just returned a string, but was a hint to the editor to highlight the string argument as a color.
chunksfor the contents api is documented anywhere? https://github.com/jupyterlab/jupyterlab/blob/caaecc573bd511521fce73b0aa718ea4264fc016/packages/services/src/contents/index.ts#L90 It doesn't seem to be included here: https://jupyter-notebook.readthedocs.io/en/stable/extending/contents.html
chunkwill simply end up overwriting the file with the contents of the final chunk
I am happy to document the api as "if you choose to use the chunk api, you must regard all intermediate models as invalid until the final chunk is written" ?
Sure, or a softer way is to say that the behavior is undefined, but I suppose we all know the tendency to write software assuming undefined behavior, so it's probably better to be clear in the documentation, then back it up in the implementation
the model would be valid for a partially written file, just that the file might possibly be correupt
Yes, I think that's the correct interpretation for our current situation