Skip to content

Conversation

@ljedrz
Copy link
Contributor

@ljedrz ljedrz commented May 28, 2018

No description provided.

@shepmaster
Copy link
Owner

So... I deliberately left off a lot of these (not all) because they are pointless repetitions of the method name. Care to take a shot at convincing me what the value of this type of documentation adds?

/// An owned prefixed name.
struct OwnedPrefixedName

@ljedrz
Copy link
Contributor Author

ljedrz commented May 28, 2018

Docs like this aren't necessary, but potential crate users often evaluate crate quality based on the completeness of the documentation (I know I do when I don't recognize the crate's owner). Undocumented entries, especially in versions < 1.0 may come off as work in progress or feature-incomplete.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants