feat(timezone): add 27 TZ* function docs and learn chapter - #38
Merged
Conversation
- Bump PINNED_CORE_REF to v2.0.0 (c5e4701) and @truecalc/core to 2.0.0 - Run gen-docs: 516 function pages (27 new TZ* stubs generated) - Add enrichment/ YAMLs for all 27 timezone functions with use-cases, when-to-use Q&A, industry tags, and related function cross-links - Add learn/(advanced)/timezones.mdx: zoned instants, DST gaps/folds, TZNOW determinism, UTC-order comparison, TZWORLDCLOCK vs TZBOARD Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add optional llms_description field to enrichment schema and gen-docs; when present it overrides the auto-generated template llmsDescription frontmatter that feeds /llms.txt and per-page /llms.mdx routes - Write practical, query-answering llms_description for all 27 timezone functions — each ≤250 chars, states what it returns, key args, and what it composes with - Add "logistics" to KNOWN_INDUSTRIES in lint-enrichment.mjs - Fix 8 enrichment YAMLs with formula issues found by lint:enrichment: TZBOARD/TZTABLE/TZWORLDCLOCK/TZCOMPARETEXT (max 2 extra zones), TZLOCALIZE (TODAY() volatile + invalid "raise" policy), TZNOW (volatile formulas replaced with TZDATETIME equivalents), TZVALID/TZDBVERSION (TZCONVERT wrongly called with 3 args), TZINWINDOW (string times replaced with fractional-day numbers) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
v2.0.0 promotes array results (e.g. ARRAY_CONSTRAIN), date arithmetic results, and zoned datetime values to distinct types. The test-docs render() switch previously fell through to a throw for any of these, failing four pre-existing formula and ts test blocks. - Add `date` handler: renders the serial number as a string - Add `zoned` handler: returns the RFC-9557 string value - Add `array` handler: single-element arrays render as their element; multi-element arrays join with newline - Update cross-sheet-references.mdx: v2.0.0 parser now accepts Sheet!A1 syntax (valid:true); stateless evaluator still returns empty — update ts test and surrounding prose to match the new behavior Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
closes #37
Summary
PINNED_CORE_REFto the v2.0.0 tag commit (c5e4701) and@truecalc/coredevDependency to2.0.0gen-docs→ 516 function reference pages (up from 489), with 27 newTZ*pages generatedenrichment/YAMLs for all 27 timezone functions:when_to_useQ&A, realuse_casesformulas, industry tags, and cross-linkscontent/docs/learn/(advanced)/timezones.mdx: explains zoned instants, DST gaps/folds,TZNOWdeterminism, UTC-order sorting, andTZWORLDCLOCKvsTZBOARDlearn/(advanced)/meta.jsonand industry hub pages to include the new timezone contentTest plan
npm run gen-docsproduces no drift (git diff --exit-code -- content/docs/reference/functions)npm run test-docspasses (all marked learn examples execute)npm run buildsucceeds (static export toout/)🤖 Generated with Claude Code