docs for metadata need updating

[mpacer]

I'll get to this within the week.

[takluyver]

Specifically, they don't currently mention language_info

[takluyver]

(there may well be other problems too, but that's one omission I've noticed)

[jjaraalm]

Docs list a "deletable" field, but this isn't implemented.

[takluyver]

I see code in the notebook UI that checks deletable. There's nothing to implement for it in nbformat.

[jjaraalm]

But surely it should be in the schema JSON right ? Maybe I'm just misunderstanding the purpose of this repo.

[takluyver]

I don't think the schema includes keys in metadata, because the ones we use don't have to be there, and arbitrary ones we don't use are allowed there. It's essentially a free key-value store, but the docs describe a few fields that Jupyter applications use.

[jjaraalm]

@takluyver kinda makes sense to me, but also seems to contradict what is in the schema since some metadata fields are included. For instance, for code cells "scrolled" and "collapsed" are included. I guess if these are mandatory fields, I can understand the logic, but I don't think that's the case; I have valid notebooks generated by Jupyter which do not have the "scrolled" field.

[jjaraalm]

Also, docs list it as "autoscroll" whereas schema and Jupyter use "scrolled"

[takluyver]

Oh, you're right. Thanks! I don't look at the schemas very often...

[rgbkrk]

How's this now?