actions
/
mdBook
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Added a stability warning to the API docs

This commit is contained in:
Michael Bryan 2018-03-14 23:45:20 +08:00
parent 48b0f547c5
commit 8c456666ff
No known key found for this signature in database
GPG Key ID: E9C602B0D9A998DC
1 changed files with 9 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
src/lib.rs
View File

@ -1,7 +1,8 @@
//! # mdBook //! # mdBook
//! //!
//! **mdBook** is similar to GitBook but implemented in Rust. //! **mdBook** is a tool for rendering a collection of markdown documents into
//! It offers a command line interface, but can also be used as a regular crate. //! a form more suitable for end users like HTML or EPUB. It offers a command
//! line interface, but this crate can be used if more control is required.
//! //!
//! This is the API doc, the [user guide] is also available if you want //! This is the API doc, the [user guide] is also available if you want
//! information about the command line tool, format, structure etc. It is also //! information about the command line tool, format, structure etc. It is also
@ -15,6 +16,12 @@
//! - Accessing the public API to help create a new Renderer //! - Accessing the public API to help create a new Renderer
//! - ... //! - ...
//! //!
//! > **Note:** While we try to ensure `mdbook`'s command-line interface and
//! > behaviour are backwards compatible, the tool's internals are still
//! > evolving and being iterated on. If you wish to prevent accidental
//! > breakages it is recommended to pin any tools building on top of the
//! > `mdbook` crate to a specific release.
//!
//! # Examples //! # Examples
//! //!
//! If creating a new book from scratch, you'll want to get a `BookBuilder` via //! If creating a new book from scratch, you'll want to get a `BookBuilder` via