Revise editorially

Author: traviscross

src/names/name-resolution.md

@@ -110,28 +110,29 @@ use m::A::V; // ERROR: Unresolved import `m::A::V`.
 ```
 
 r[names.resolution.expansion.imports.shadowing]
-Names introduced via `use` declarations in an [outer scope] are shadowed by
-candidates in the same namespace with the same name from an inner scope except
-where otherwise restricted by [name resolution ambiguities].
+Names introduced via `use` declarations in an [outer scope] are shadowed by candidates in the same namespace with the same name from an inner scope except where otherwise restricted by [name resolution ambiguities].
 
-```rust
-pub mod foo {
-    pub mod baz {
-        pub struct Name;
+```rust,no_run
+pub mod m1 {
+    pub mod ambig {
+        pub const C: u8 = 1;
     }
 }
 
-pub mod bar {
-    pub mod baz {
-        pub struct Name(pub ());
+pub mod m2 {
+    pub mod ambig {
+        pub const C: u8 = 2;
     }
 }
 
-use foo::baz;
+// This introduces the name `ambig` in the outer scope.
+use m1::ambig;
 fn f() {
-    use bar::baz;
-    use baz::Name;
-    Name(());
+    // This shadows `ambig` in the inner scope.
+    use m2::ambig;
+    // The `use` from the inner scope is used here.
+    use ambig::C;
+    const { assert!(C == 2) };
 }
 ```