tinymist/crates/tinymist-query/src
Copilot 4ce0a59862
Some checks are pending
tinymist::auto_tag / auto-tag (push) Waiting to run
tinymist::ci / announce (push) Blocked by required conditions
tinymist::ci / build (push) Blocked by required conditions
tinymist::ci / prepare-build (push) Waiting to run
tinymist::ci / Check Minimum Rust version and Tests (Windows) (push) Waiting to run
tinymist::ci / Duplicate Actions Detection (push) Waiting to run
tinymist::ci / Check Clippy, Formatting, Completion, Documentation, and Tests (Linux) (push) Waiting to run
tinymist::gh_pages / build-gh-pages (push) Waiting to run
docs: Add documentation for pub items in expr.rs (#2051)
This PR adds comprehensive documentation for all public items in
`crates/tinymist-query/src/syntax/expr.rs` following Rust documentation
conventions.

## Changes Made

The following public items now have proper documentation comments:

- **`ExprRoute`** type alias - Documents its purpose as a mapping
structure for file identifiers to lexical scopes during expression
analysis routing
- **`expr_of`** function - Describes its role in analyzing expressions
within source files and producing expression information including
resolves, imports, docstrings, and lexical scoping data
- **`ExprWorker`** struct - Explains its functionality as a worker for
processing expressions during source file analysis, handling expression
checking, scope management, symbol resolution, and docstring collection

## Documentation Style

All documentation follows Rust conventions by:
- Using third person singular verbs
- Focusing on the purpose and functionality rather than implementation
details
- Providing clear, concise descriptions of what each item does

The code has been formatted with `cargo fmt` and compiles successfully
after the changes.

Fixes #2048.

<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions,
customizing its development environment and configuring Model Context
Protocol (MCP) servers. Learn more [Copilot coding agent
tips](https://gh.io/copilot-coding-agent-tips) in the docs.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Myriad-Dreamin <35292584+Myriad-Dreamin@users.noreply.github.com>
Co-authored-by: Myriad-Dreamin <camiyoru@gmail.com>
2025-08-20 12:27:43 +08:00
..
adt refactor: move expr and ty defs to analysis crate (#1633) 2025-04-08 05:50:55 +08:00
analysis feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
code_action fix: compile warnings (#1774) 2025-05-22 11:37:44 +08:00
completion feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
docs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
fixtures feat: make enter feature in list or enum work (#2022) 2025-08-13 11:15:31 +08:00
syntax docs: Add documentation for pub items in expr.rs (#2051) 2025-08-20 12:27:43 +08:00
testing feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
analysis.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
bib.rs feat: show rendered bibliography in bib hover and improve label hover (#1611) 2025-04-11 17:29:03 +08:00
check.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
code_action.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
code_context.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
code_lens.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
color_presentation.rs dev: refactor tasks (#411) 2024-07-14 17:40:01 +08:00
completion.rs dev: split test functions for multiple crates (#1695) 2025-04-30 19:01:29 +08:00
diagnostics.rs dev: split test functions for multiple crates (#1695) 2025-04-30 19:01:29 +08:00
document_color.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
document_highlight.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
document_link.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
document_metrics.rs build: bump world crates to 0.13.12-rc1 (#1608) 2025-03-31 16:01:51 +08:00
document_symbol.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
folding_range.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
goto_declaration.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
goto_definition.rs feat: resolve definitions with dynamic analysis (#1904) 2025-07-15 01:15:33 +08:00
hover.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
inlay_hint.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
jump.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
lib.rs feat: autofix unknown variable: a and file not found (searched at a.typ) by code action (#1743) 2025-05-09 23:44:12 +08:00
lsp_typst_boundary.rs feat: move and compile tinymist crate for wasm32 target (#2027) 2025-08-11 13:14:26 +08:00
on_enter.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
package.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
prelude.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
prepare_rename.rs feat: rename labels (#1858) 2025-08-09 19:54:22 +08:00
references.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
rename.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
selection_range.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
semantic_tokens_delta.rs dev: refactor semantic_tokens crate (#809) 2024-11-14 02:39:26 +08:00
semantic_tokens_full.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
signature_help.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
symbol.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
tests.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00
will_rename_files.rs feat: rename labels (#1858) 2025-08-09 19:54:22 +08:00
workspace_label.rs feat: bump edition of most crates to rust 2024 (#2042) 2025-08-18 16:48:41 +08:00