docs: crate READMEs describe each crate as it is today

Every crate under crates/ now has a README (android, bench, cli, napi and
wasm had none), each saying what the crate is, its main types and
functions (names checked against the code), its cargo features with
defaults and which ones build C (checked with `cargo tree`), and links to
the top-level docs.

Corrections to the old stubs:
- clawhdf5-derive: the derive is `H5Type`, not `HDF5Type`, and it needs
  clawhdf5-format as a dependency.
- clawhdf5-filters: deflate backends only, and no library crate depends
  on it; the filter pipeline and every other codec are in -format.
- clawhdf5-gpu: vector distance compute, not I/O; not used by
  HDF5Memory::search.
- clawhdf5-io: MpiVol is root-read + broadcast, not collective MPI-IO.
- clawhdf5-ann: from_hdf5/search(q, k) did not exist; load_from_hdf5 and
  search(q, k, ef).
- clawhdf5-accel: checksum::crc32_simd did not exist; the SSE4 and wasm
  backends are reported but run the scalar kernels.
- clawhdf5-gpu: the old example called l2_distances, which does not
  exist (l2_search).
- clawhdf5-agent: it described a "vector store" with "GPU acceleration";
  it now covers HDF5Memory, search options, WAL, signing, the graph.
- crates.io/docs.rs badges removed and `cargo install <crate>` replaced:
  nothing is published; depend on git.
- fuzz: the opt-in CLAWHDF5_FUZZ_SECONDS smoke run in ci-test.sh.
- tools: the FileEditor interop tests that live in this crate.
- remote, py: license, other front ends, limits, File.mode/flush/chunks.

The Rust examples of the facade, format, filters, accel, ann, derive and
agent READMEs were compiled and run as tests (netcdf4, gpu and remote
compiled only) in a scratch crate; the CLI example was run.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

crates/clawhdf5-netcdf4/README.md

@@ -1,25 +1,53 @@
 # clawhdf5-netcdf4
 
-[![crates.io](https://img.shields.io/crates/v/clawhdf5-netcdf4.svg)](https://crates.io/crates/clawhdf5-netcdf4)
-[![docs.rs](https://docs.rs/clawhdf5-netcdf4/badge.svg)](https://docs.rs/clawhdf5-netcdf4)
+Read NetCDF-4 files in pure Rust. NetCDF-4 files are HDF5 files with
+conventions for dimensions, coordinate variables and attributes; this crate
+reads them through the [`clawhdf5`](../clawhdf5/README.md) facade, with no
+libnetcdf or libhdf5. Read-only: NetCDF-3 (classic) files are not HDF5 and
+are not supported.
 
-NetCDF-4 read support built on clawhdf5 — pure Rust, no C dependencies.
+Not on crates.io yet; depend on it from git:
 
-## Features
-
-- Read NetCDF-4 / HDF5-backed `.nc` files
-- Dimension, variable, and CF convention support
-- Climate and scientific data access
+```toml
+[dependencies]
+clawhdf5-netcdf4 = { git = "https://git.redclaw.dev/quantumclaw/clawhdf5" }
+```
 
 ## Usage
 
-```rust
+```rust,no_run
 use clawhdf5_netcdf4::NetCDF4File;
 
-let nc = NetCDF4File::open("climate.nc").unwrap();
-let temp = nc.variable("temperature").unwrap();
+let nc = NetCDF4File::open("climate.nc")?;
+for dim in nc.dimensions()? {
+    println!("{}: {} (unlimited = {})", dim.name, dim.size, dim.is_unlimited);
+}
+let mut temp = nc.variable("temperature")?;
+let dims: Vec<&str> = temp.dimensions().iter().map(|d| d.name.as_str()).collect();
+println!("{:?} over {:?}", temp.shape()?, dims);
+let cf = temp.cf_attributes()?;
+println!("units: {:?}", cf.units);
+// scale_factor/add_offset applied; _FillValue and missing_value become NaN
+let values: Vec<f64> = temp.read_f64()?;
+# Ok::<(), clawhdf5_netcdf4::Error>(())
 ```
 
+## API
+
+| Item | What |
+|---|---|
+| `NetCDF4File` | `open`, `from_bytes`, `dimensions`, `variables`, `variable`, `global_attrs`, `group`, `group_names`, `nc_properties`, and `hdf5_file` for the underlying `clawhdf5::File` |
+| `NetCDF4Group` | the same for a sub-group (`dimensions`, `variables`, `attrs`, nested `group`) |
+| `Variable` | `name`, `shape`, `dimensions`, `nc_type`, `is_coordinate`, `attrs`, `cf_attributes`; `read_f64` (CF scale/offset and fill applied), `read_raw_f32`/`_f64`/`_i32`/`_i64`/`_u64`, `read_string`, `read_raw` |
+| `Dimension` | `name`, `size`, `is_unlimited` |
+| `CfAttributes` | CF convention attributes: `units`, `long_name`, `standard_name`, `fill_value` (`_FillValue`), `missing_value`, `scale_factor`, `add_offset`, `valid_range`, `calendar`, `axis` |
+| `NcType` | the NetCDF type of a variable |
+
+No cargo features. Tests compare against files written by netCDF4-python
+(`tests/interop_tests.rs`; the CI job requires them with
+`CLAWHDF5_REQUIRE_INTEROP=1`). What the HDF5 reader underneath cannot
+read is listed in [`docs/known-issues.md`](../../docs/known-issues.md).
+
 ## License
 
 MIT