diff --git a/grammars/emacs/README.md b/grammars/emacs/README.md
index 06d34c81e9f1..5c0c16ac7c20 100644
--- a/grammars/emacs/README.md
+++ b/grammars/emacs/README.md
@@ -10,7 +10,7 @@ Copy the `prql-mode.el` file to:
 
 Then, edit your `~/.emacs.d/init.el` file and add the following:
 
-```emacs
+```elisp
 (add-to-list 'load-path "~/.emacs.d/custom-modes/")
 (require 'prql-mode)
 
diff --git a/prqlc/prqlc/src/sql/pq/context.rs b/prqlc/prqlc/src/sql/pq/context.rs
index e3c6028d9cda..785758da7d79 100644
--- a/prqlc/prqlc/src/sql/pq/context.rs
+++ b/prqlc/prqlc/src/sql/pq/context.rs
@@ -1,6 +1,6 @@
-//! Transform the parsed AST into a "materialized" AST, by executing functions and
-//! replacing variables. The materialized AST is "flat", in the sense that it
-//! contains no query-specific logic.
+//! Context for the PQ anchoring stage: tracks table, column, and relation-instance
+//! declarations, and generates fresh IDs and names for tables and columns as RQ is
+//! lowered towards SQL.
 use std::collections::HashMap;
 use std::iter::zip;