# Let's have a "documentation policy"? **URL:** \ **Category:** documentation\ **Created:** [June 22, 2015, 7:09pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279 "2015-06-22T19:09:20Z")\ **Posts on this page:** 8\ **Page:** 1
**Author:** ![tshepang](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/tshepang/32/179_2.png) [@tshepang](https://internals.rust-lang.org/u/tshepang)\ **Post date:** [June 22, 2015, 7:09pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/1 "2015-06-22T19:09:20Z")
The only semblance of Rust documentation policy/guidelines can be found in [src/book/documentation.md](https://doc.rust-lang.org/book/documentation.html), which I think should be moved elsewhere, perhaps to Style guidelines or own file. The chapter can remain in the book, but should only explain how stuff is done, not mandate policy (e.g. “The first line of a documentation comment should be a short summary of its functionality”). One other thing: if we do create documentation policy/guidelines, should it be universal to Rust projects, or just the rust-lang/rust? I suggest we create “Documentation Guidelines”, either as a stand-alone document or as a chapter of “Style Guidelines” document, and have contributions to rust-lang/rust documentation follow those guidelines. ---
**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\ **Post date:** [June 23, 2015, 4:19pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/2 "2015-06-23T16:19:56Z")
Not to be a downer, but there has been a great rush to institute new ‘policy’ lately, and it’s kind of grinding on me. Maybe we can focus on writing software for a while and not doing politics. ---
**Author:** ![DanielFath](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/danielfath/32/5372_2.png) [@DanielFath](https://internals.rust-lang.org/u/DanielFath)\ **Post date:** [June 23, 2015, 4:21pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/3 "2015-06-23T16:21:39Z")
Would this be in the scope of the Community team? ---
**Author:** ![steveklabnik](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/steveklabnik/32/4524_2.png) [@steveklabnik](https://internals.rust-lang.org/u/steveklabnik)\ **Post date:** [June 23, 2015, 4:34pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/4 "2015-06-23T16:34:43Z")
> [@tshepang](#): > > The only semblance of Rust documentation policy/guidelines can be found in src/book/documentation.md, This isn't strictly true, we have an accepted RFC: [rfcs/text/0505-api-comment-conventions.md at master · rust-lang/rfcs · GitHub](https://github.com/rust-lang/rfcs/blob/master/text/0505-api-comment-conventions.md) Ideally, we'd come up with these guidelines, but until we have enough people doing lots of docs to make a documentaiton team, I don't think that it's worth it to do more. These kinds of RFCs are high, high, high effort. ---
**Author:** ![tshepang](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/tshepang/32/179_2.png) [@tshepang](https://internals.rust-lang.org/u/tshepang)\ **Post date:** [June 23, 2015, 6:05pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/5 "2015-06-23T18:05:04Z")
Are you talking about the Stability discussions? ---
**Author:** ![tshepang](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/tshepang/32/179_2.png) [@tshepang](https://internals.rust-lang.org/u/tshepang)\ **Post date:** [June 23, 2015, 6:21pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/6 "2015-06-23T18:21:50Z")
I actually forgot about that document, thanks. ---
**Author:** ![bluss](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/bluss/32/2264_2.png) [@bluss](https://internals.rust-lang.org/u/bluss)\ **Post date:** [June 30, 2015, 12:06pm UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/7 "2015-06-30T12:06:27Z")
Do we prefer plain or curly quotes in the text of the API documentation in Rust (rust-lang/rust itself)? ---
**Author:** ![system](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/system/32/14092_2.png) [@system](https://internals.rust-lang.org/u/system)\ **Post date:** [March 25, 2019, 8:24am UTC](https://internals.rust-lang.org/t/lets-have-a-documentation-policy/2279/8 "2019-03-25T08:24:44Z")
Closed on March 25, 2019, 8:24am UTC This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.