Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add more documentation to Metadata struct #177

Merged
merged 2 commits into from May 27, 2017

Conversation

Projects
None yet
2 participants
@MarkMcCaskey
Copy link
Contributor

MarkMcCaskey commented May 27, 2017

The example is pretty redundant (copied almost verbatim from another example). Let me know what I should add or remove to make this better!

Thanks!

src/lib.rs Outdated
/// `Record`s use `Metadata` to determine the log message's severity
/// and target.
///
///

This comment has been minimized.

@dtolnay

dtolnay May 27, 2017

Member

Please remove the extra blank line. Rustdoc treats this just like one blank line anyway.

src/lib.rs Outdated
/// Users should use the `log_enabled!` macro in their code to avoid
/// constructing expensive log messages.
///
/// ## Examples

This comment has been minimized.

@dtolnay

dtolnay May 27, 2017

Member

Please use a full-sized heading like we do elsewhere.

src/lib.rs Outdated
/// ```rust
/// # #[macro_use]
/// # extern crate log;
///

This comment has been minimized.

@dtolnay

dtolnay May 27, 2017

Member

This will include a blank line at the top of the example code. Please put # on this line to hide it.

selection_053

@dtolnay

This comment has been minimized.

Copy link
Member

dtolnay commented May 27, 2017

Thank you!

@dtolnay dtolnay merged commit 7cc258c into rust-lang-nursery:master May 27, 2017

1 of 2 checks passed

continuous-integration/appveyor/pr Waiting for AppVeyor build to complete
Details
continuous-integration/travis-ci/pr The Travis CI build passed
Details
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.