Add documentation for new example intra-doc link disambiguator

Author: GuillaumeGomez

src/doc/rustdoc/src/scraped-examples.md

@@ -47,6 +47,22 @@ Rustdoc has a few techniques to ensure these examples don't overwhelm documentat
 
 For a given item, Rustdoc sorts its examples based on the size of the example — smaller ones are shown first.
 
+## Linking to an example source code
+
+You can use intra-doc links to link to a scraped example source file with `example@` disambiguator:
+
+```rust
+// If your example is named "foo":
+/// [example@foo]
+```
+
+By default, the intra-doc link will link to the file containing the `main` function. If you want to
+link to another file, you can specify its path:
+
+```rust
+// If your example is named "foo":
+/// [example@foo/another_file.rs]
+```
 
 ## FAQ
 

src/doc/rustdoc/src/write-documentation/linking-to-items-by-name.md

@@ -92,6 +92,9 @@ rendered as `Foo`. The following prefixes are available: `struct`, `enum`, `trai
 `mod`, `module`, `const`, `constant`, `fn`, `function`, `field`, `variant`, `method`, `derive`,
 `type`, `value`, `macro`, `prim` or `primitive`.
 
+There is another disambiguator available: `example`. If you want more information about this one,
+take a look at the [scraped examples chapter](../scraped-examples.md).
+
 You can also disambiguate for functions by adding `()` after the function name,
 or for macros by adding `!` after the macro name. The macro `!` can be followed by `()`, `{}`,
 or `[]`. Example: