Expand readme

pkgs/native_assets_cli/example/use_dart_api/README.md

@@ -1,8 +1,18 @@
-An example that uses `dart_api_dl.h`.
+An example that uses the [C API of the Dart VM].
 
-Open TODO is to pass the path to the include folder rather than copying it in.
-https://github.com/dart-lang/native/issues/839
+The example shows how to pass an object from the Dart heap to native code and
+hold on to it via a `PersistentHandle`. For more documentation about handles,
+and the other C API features refer to the documentation in the header files.
 
 ## Usage
 
 Run tests with `dart --enable-experiment=native-assets test`.
+
+## Open TODOs
+
+It would be better to receive a path the include folder containing the C API
+rather than having to copy it into the `src/` directory.
+
+* https://github.com/dart-lang/native/issues/839
+
+[C API of the Dart VM]: https://github.com/dart-lang/sdk/tree/main/runtime/include