Editions (RFC 2052)

[matthewjasper]

Raising this now so that we can decide what the plan is here.

• [ ] Document editions
• [ ] Make sure that all examples are using Rust 2018 compatible code (paths are the main concern).
  • How do editions interact with mdbook test?
• [ ] Documenting Rust 2015 differences (assuming that the reference moves to Rust 2018 by default)
  • Should these be inline, or in an appendix.

[steveklabnik]

I imagine we should have some kid of box, "this is specific to 2018 edition" or whatever. I'm guessing inline. I'm open to other opinions!

How do editions interact with mdbook test?

This is a very good question.

[steveklabnik]

How do editions interact with mdbook test?

@QuietMisdreavus just told me that they're planning on making rustdoc work with editions via some sort of annotation, so we could use that 👍

[ehuss]

Note: An initial stab at this was done in #393.