message: doc(c-api) Improve `wasmer_wasm.h` intro to explain stability and documentation.
diff: @@ -89,8 +89,41 @@ fn build_wasm_c_api_headers(crate_dir: &str, out_dir: &str) {
  out_header_file.push("wasmer_wasm");
  let mut pre_header = format!(
  - r#"// The Wasmer C/C++ header file compatible with the `wasm-c-api` standard API.
  -// This file is generated by lib/c-api/build.rs.
  + r#"// The Wasmer C/C++ header file compatible with the [`wasm-c-api`]
  +// standard API, as `wasm.h` (included here).
  +//
  +// This file is automatically generated by `lib/c-api/build.rs` of the
  +// [`wasmer-c-api`] Rust crate.
  +//
  +// # Stability
  +//
  +// The [`wasm-c-api`] standard API is a _living_ standard. There is no
  +// commitment for stability yet. We (Wasmer) will try our best to keep
  +// backward compatibility as much as possible. Nonetheless, some
  +// necessary API aren't yet standardized, and as such, we provide a
  +// custom API, e.g. `wasi_*` types and functions.
  +//
  +// The documentation makes it clear whether a function is unstable.
  +//
  +// When a type or a function will be deprecated, it will be marked as
  +// such with the appropriated compiler warning, and will be removed at
  +// the next release round.
  +//
  +// # Documentation
  +//
  +// At the time of writing, the [`wasm-c-api`] standard has no
  +// documentation. This file also does not include inline
  +// documentation. However, we have made (and we continue to make) an
  +// important effort to document everything. [See the documentation
  +// online][documentation]. Please refer to this page for the real
  +// canonical documentation. It also contains numerous examples.
  +//
  +// To generate the documentation locally, run `cargo doc --open` from
  +// within the [`wasmer-c-api`] Rust crate.
  +//
  +// [`wasm-c-api`]: https://github.com/WebAssembly/wasm-c-api
  +// [`wasmer-c-api`]: https://github.com/wasmerio/wasmer/tree/master/lib/c-api
  +// [documentation]: https://wasmerio.github.io/wasmer/crates/wasmer_c_api/
  #if !defined(WASMER_WASM_H_PRELUDE)
  