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

Guide: edit Generics and Traits sections #19625

Merged
merged 1 commit into from
Jan 2, 2015
Merged

Conversation

mrhota
Copy link
Contributor

@mrhota mrhota commented Dec 7, 2014

Nothing major. Clarification, copy-editing, typographical and grammatical consistency

@steveklabnik
Copy link
Member

Before reading this, I just want to say that I'm wary of copy-editing that changes the tone significantly. I've gotten a lot of positive feedback on how different the Guide is from other programming texts, and I'd like to keep it that way.

On to the review! 🎊

This is really unfortunate. Luckily, Rust has a feature that gives us a better
way: generics. Generics are called **parametric polymorphism** in type theory,
which means that they are types or functions that have multiple forms ("poly"
is multiple, "morph" is form) over a given parameter ("parametric").
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What's the reason for removing the explanation of the word?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was thinking the guide's audience is expected to know what polymorphism is.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fair enough.

@steveklabnik
Copy link
Member

Some nits, but this looks great overall. Thank you!

@sfackler
Copy link
Member

Needs a rebase

Mostly copy-editing, clarification---in particular, monomorphization
@Gankra
Copy link
Contributor

Gankra commented Jan 2, 2015

Ah, ninja'd the commits in without a comment. @steveklabnik r?

alexcrichton added a commit to alexcrichton/rust that referenced this pull request Jan 2, 2015
Nothing major. Clarification, copy-editing, typographical and grammatical consistency
@bors bors merged commit daed54d into rust-lang:master Jan 2, 2015
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.

6 participants