Skip to content

Latest commit

 

History

History
54 lines (37 loc) · 1.47 KB

README.md

File metadata and controls

54 lines (37 loc) · 1.47 KB

deno_doc

A Rust crate to generate documentation for JavaScript and TypeScript modules.

This crate powers deno doc, but is not Deno specific and can be used to write documentation generators for other targets like Node or the browser as well.

Example

examples/ddoc/main.rs provides a minimal standalone binary demonstrating how deno_doc can be used as a crate.

$ cargo run --example ddoc ../deno/std/http/mod.ts

Developing

Make sure to have latest stable version of Rust installed (1.54.0).

// check version
$ rustc --version
rustc 1.54.0 (a178d0322 2021-07-26)

// build all targets
$ cargo build --all-targets

// test it
$ cargo test

Contributing

Submitting a Pull Request

Before submitting, please make sure the following is done:

  1. That there is a related issue and it is referenced in the PR text.
  2. There are tests that cover the changes.
  3. Ensure cargo test passes.
  4. Format your code with rustfmt --check src/lib.rs
  5. Make sure cargo clippy --all-targets --release --locked -- -D clippy::all passes.