Skip to content

docs: update DTL (Domain-Specific Text Literals) documentation#2649

Open
xgopilot[bot] wants to merge 1 commit intomainfrom
xgopilot/issue-2648-1771460107
Open

docs: update DTL (Domain-Specific Text Literals) documentation#2649
xgopilot[bot] wants to merge 1 commit intomainfrom
xgopilot/issue-2648-1771460107

Conversation

@xgopilot
Copy link

@xgopilot xgopilot bot commented Feb 19, 2026

Requested by @xushiwei

This PR updates the DTL (Domain-Specific Text Literals) documentation with important changes.

Summary

  • List all built-in DTLs: Added comprehensive list of all DTLs in the encoding directory (csv, json, yaml, html, xml, regexp, regexposix, golang, xgo, fs)
  • Removed import requirement: HTML DTL no longer requires importing "golang.org/x/net/html"
  • Added DQL relationship section: New section explaining how DTLs relate to DQL (DOM Query Language), including that many DTLs result in DOMs supporting NodeSet query operations (ns.* and ns.**)
  • Added usage examples: Comprehensive examples for json, yaml, xml, html, golang, xgo, and fs DTLs showing DQL query syntax
  • Documented fs special case: The fs DTL returns a NodeSet directly (unlike other DTLs), fs. means NodeSets of the current directory
  • Added encoding directory structure: Documentation of the implementation location for all built-in DTLs

Test plan

  • Review documentation for accuracy and completeness
  • Verify code examples are correct and runnable

Closes #2648

Updates to the DTL documentation include:
- List all built-in DTLs located in the encoding directory (csv, json, yaml, html, xml, regexp, regexposix, golang, xgo, fs)
- Remove the requirement to import "golang.org/x/net/html" for html DTL
- Add new section explaining relationship with DQL (DOM Query Language)
- Add comprehensive usage examples for json, yaml, xml, html, golang, xgo, and fs DTLs
- Document that many DTLs result in DOMs supporting NodeSet query operations (ns.* and ns.**)
- Add special case documentation for fs DTL which returns NodeSet directly
- Document the encoding directory structure

Requested by @xushiwei
Closes #2648

Generated with [codeagent](https://github.com/qbox/codeagent)
Co-authored-by: xushiwei <[email protected]>
@codecov
Copy link

codecov bot commented Feb 19, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.10%. Comparing base (fb0f83f) to head (87bf980).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2649   +/-   ##
=======================================
  Coverage   94.10%   94.10%           
=======================================
  Files          32       32           
  Lines        9964     9964           
=======================================
  Hits         9377     9377           
  Misses        419      419           
  Partials      168      168           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

update DTL (Domain-Specific Text Literals) documentation

1 participant