reorganized directory

Author: Tbkhi

src/rustc-driver-getting-diagnostics.md

@@ -1,14 +1,19 @@
 # Example: Getting diagnostic through `rustc_interface`
 
-`rustc_interface` allows you to intercept diagnostics that would otherwise be printed to stderr.
+The [`rustc_interface`] allows you to intercept diagnostics that would
+otherwise be printed to stderr.
 
 ## Getting diagnostics
 
 To get diagnostics from the compiler,
-configure `rustc_interface::Config` to output diagnostic to a buffer,
-and run `TyCtxt.analysis`. The following was tested
+configure [`rustc_interface::Config`] to output diagnostic to a buffer,
+and run [`TyCtxt.analysis`]. The following was tested
 with <!-- date-check: jan 2024 --> `nightly-2024-01-19`:
 
 ```rust
 {{#include ../examples/rustc-driver-getting-diagnostics.rs}}
 ```
+
+[`rustc_interface`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_interface/index.html
+[`rustc_interface::Config`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_interface/interface/struct.Config.html
+[`TyCtxt.analysis`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_interface/passes/fn.analysis.html

src/rustc-driver-interacting-with-the-ast.md

@@ -1,12 +1,16 @@
 # Example: Type checking through `rustc_interface`
 
-`rustc_interface` allows you to interact with Rust code at various stages of compilation.
+The [`rustc_interface`] allows you to interact with Rust code at various stages of compilation.
 
 ## Getting the type of an expression
 
-To get the type of an expression, use the `global_ctxt` to get a `TyCtxt`.
+To get the type of an expression, use the [`global_ctxt`] query to [get] a [`TyCtxt`].
 The following was tested with <!-- date-check: jan 2024 --> `nightly-2024-01-19`:
 
 ```rust
 {{#include ../examples/rustc-driver-interacting-with-the-ast.rs}}
 ```
+[get]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_middle/ty/context/struct.GlobalCtxt.html#method.enter
+[`global_ctxt`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_interface/queries/struct.Queries.html#method.global_ctxt
+[`rustc_interface`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_interface
+[`TyCtxt`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_middle/ty/context/struct.TyCtxt.html