compiler/rustc_ast/README.md

   1 The `rustc_ast` crate contains those things concerned purely with syntax
   2 – that is, the AST ("abstract syntax tree"), along with some definitions for tokens and token streams, data structures/traits for mutating ASTs, and shared definitions for other AST-related parts of the compiler (like the lexer and macro-expansion).
   3
   4 For more information about how these things work in rustc, see the
   5 rustc dev guide:
   6
   7 - [Parsing](https://rustc-dev-guide.rust-lang.org/the-parser.html)
   8 - [Macro Expansion](https://rustc-dev-guide.rust-lang.org/macro-expansion.html)