We definitely want to improve docs, but the Rust side of things changes so much it is really difficult to keep stuff up to date. A lot of refactoring is happening currently, but once that settles down some, it will make more sense to write proper docs.
Out of curiosity, how would you improve them?
I just started digging into it a few hours back, so I can't give you a concrete answer. A hello world example for the deno_core to give an idea on how the Ops and ResourceIds should be used. The examples given are not really clear at a glance what they are doing and I had to read through a few of the test cases before I got some idea how JsRuntime should work.