From abcc96d82cacf646e205c57b000f1a31dbabb320 Mon Sep 17 00:00:00 2001 From: Kyle June Date: Wed, 9 Sep 2026 22:53:30 -0400 Subject: [PATCH] fix(docs): remove guide metadata and history --- docs/README.md | 10 ---------- docs/ci-cd.md | 17 ----------------- docs/configuration.md | 10 ---------- docs/database.md | 14 -------------- docs/deployment.md | 11 ----------- docs/development-tools.md | 10 ---------- docs/error-handling.md | 17 ----------------- docs/forms.md | 17 ----------------- docs/getting-started.md | 10 ---------- docs/introduction.md | 10 ---------- docs/logging.md | 13 ------------- docs/metadata.md | 13 ------------- docs/middleware.md | 14 -------------- docs/routing.md | 17 ----------------- docs/state-management.md | 15 --------------- docs/static-files.md | 10 ---------- docs/styling.md | 13 ------------- docs/testing.md | 14 -------------- docs/tutorials/README.md | 10 ---------- docs/tutorials/blog.md | 10 ---------- 20 files changed, 255 deletions(-) diff --git a/docs/README.md b/docs/README.md index 1298868..260fa91 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,8 +1,3 @@ ---- -title: Juniper Guides -last_verified: 2026-09-09 ---- - # Juniper Guides Juniper renders React routes on Deno, uses Hono for HTTP requests, and uses @@ -57,8 +52,3 @@ The [JSR API reference](https://jsr.io/@udibo/juniper/doc) documents exported types and methods. Guides explain how those APIs fit together. Examples that refer to application services assume those services exist; complete test examples include their fixtures. - -## Changelog - -- **2026-09-09** — Added a learning path, full guide index, and execution and - trust boundaries to make the documentation easier to navigate. diff --git a/docs/ci-cd.md b/docs/ci-cd.md index 34f5bf2..3b1590f 100644 --- a/docs/ci-cd.md +++ b/docs/ci-cd.md @@ -1,8 +1,3 @@ ---- -title: CI/CD -last_verified: 2026-09-09 ---- - # CI/CD ## Overview @@ -421,15 +416,3 @@ jobs: - [Testing](testing.md) - Testing utilities and patterns - [Configuration](configuration.md) - Project and build configuration - -## Changelog - -- **2026-09-09** — Added explicit type and LCOV checks, frozen dependency - installation, registry permissions, and deployment validation guidance. - -- **2026-09-05** — Tailwind build and dev permission profiles allow only the - `osRelease` system query needed by jiti's Windows terminal-color detection. - Reproduce CI builds without `NO_COLOR` or `TERM=dumb`, which bypass that - query. -- **2026-09-05** — Documented platform coverage and production-build checks for - Windows CSS entry failures. diff --git a/docs/configuration.md b/docs/configuration.md index 6be0d02..cfe343b 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -1,8 +1,3 @@ ---- -title: Configuration -last_verified: 2026-09-09 ---- - # Configuration ## Project Configuration (deno.json) @@ -392,8 +387,3 @@ To exclude build output from formatting and type checking: - [Styling](styling.md) - CSS and TailwindCSS integration - [Deployment](deployment.md) - Deploy to Deno Deploy, Docker, and more - -## Changelog - -- **2026-09-09** — Aligned React Router versions with the template and clarified - explicit environment loading and the limits of the public-variable allowlist. diff --git a/docs/database.md b/docs/database.md index 746be34..86ba85d 100644 --- a/docs/database.md +++ b/docs/database.md @@ -1,8 +1,3 @@ ---- -title: Database -last_verified: 2026-09-09 ---- - # Database ## Overview @@ -747,12 +742,3 @@ export async function action({ request }: RouteActionArgs) { - [Forms](forms.md) - Form handling with client and server actions - [Error Handling](error-handling.md) - Error boundaries and HttpError - -## Changelog - -- **2026-09-09** — Typed the transaction lookup and removed redundant comments - from the revised examples. - -- **2026-09-09** — Fixed the user-update transaction so unchanged emails retain - their index and changed emails preserve uniqueness under concurrent writes; - shared concurrent KV opens and documented handle cleanup. diff --git a/docs/deployment.md b/docs/deployment.md index a26b507..836ab09 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -1,8 +1,3 @@ ---- -title: Deployment -last_verified: 2026-09-09 ---- - # Deployment ## Overview @@ -389,9 +384,3 @@ applications - [CI/CD](ci-cd.md) - GitHub Actions workflows - [Logging](logging.md) - Logging and OpenTelemetry - [Configuration](configuration.md) - Project and build configuration - -## Changelog - -- **2026-09-09** — Corrected production packaging and cache semantics, added - long-running server and deployment recovery guidance, and replaced unverified - adapter recipes with runtime requirements. diff --git a/docs/development-tools.md b/docs/development-tools.md index c0a0efa..8e75418 100644 --- a/docs/development-tools.md +++ b/docs/development-tools.md @@ -1,8 +1,3 @@ ---- -title: Development Tools -last_verified: 2026-09-09 ---- - # Development Tools ## Development Server @@ -332,8 +327,3 @@ JetBrains IDEs (WebStorm, IntelliJ IDEA) have built-in Deno support: - [Testing](testing.md) - Testing utilities and patterns - [Logging](logging.md) - Logging and OpenTelemetry - -## Changelog - -- **2026-09-09** — Clarified document reload behavior and kept debugger and task - examples on the template permission and environment profiles. diff --git a/docs/error-handling.md b/docs/error-handling.md index abb386e..f647d81 100644 --- a/docs/error-handling.md +++ b/docs/error-handling.md @@ -1,8 +1,3 @@ ---- -title: Error Handling -last_verified: 2026-09-09 ---- - # Error Handling ## Overview @@ -476,15 +471,3 @@ export function ErrorBoundary( - [Logging](logging.md) - Logging and OpenTelemetry - [Testing](testing.md) - Testing utilities and patterns - [Middleware](middleware.md) - Server and client middleware - -## Changelog - -- **2026-09-09** — Clarified custom error preservation by response path and - replaced unsupported rich-type claims with the serialization contract. - -- **2026-09-09** — Documented production error sanitization and - ancestor-boundary rendering without denied loader data; completed imports in - revised examples. - -- **2026-09-09** — Corrected shared-layout lifetime and client serializer - registration; distinguished exposed error messages from private details. diff --git a/docs/forms.md b/docs/forms.md index c88ec4a..b47b4c6 100644 --- a/docs/forms.md +++ b/docs/forms.md @@ -1,8 +1,3 @@ ---- -title: Forms -last_verified: 2026-09-09 ---- - # Forms ## Overview @@ -662,15 +657,3 @@ content type. The browser-supplied filename and MIME type are untrusted. - [Error Handling](error-handling.md) - Error boundaries and HttpError - [Database](database.md) - Deno KV and PostgreSQL - [Testing](testing.md) - Testing utilities and patterns - -## Changelog - -- **2026-09-09** — Corrected action-data serialization claims, including bigint - normalization and custom classes. - -- **2026-09-09** — Removed explanatory comments from the revised submission and - validation examples. - -- **2026-09-09** — Corrected navigation pending state, fetcher action targets - and POST submission; validated untrusted fields and uploads and derived - ownership from server context. diff --git a/docs/getting-started.md b/docs/getting-started.md index 917177a..5da62c3 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -1,8 +1,3 @@ ---- -title: Getting Started -last_verified: 2026-09-09 ---- - # Getting Started ## Prerequisites @@ -371,8 +366,3 @@ deno task check - [Routing](routing.md) - File-based routing and data loading - [Middleware](middleware.md) - Server and client middleware - [Styling](styling.md) - CSS and TailwindCSS integration - -## Changelog - -- **2026-09-09** — Documented the Deno requirement for named permission sets and - aligned React Router with the tested template. diff --git a/docs/introduction.md b/docs/introduction.md index 37bdfcb..07fc27c 100644 --- a/docs/introduction.md +++ b/docs/introduction.md @@ -1,8 +1,3 @@ ---- -title: Introduction -last_verified: 2026-09-09 ---- - # Introduction ## What is Juniper? @@ -166,8 +161,3 @@ Juniper may not be the best fit for: - [Routing](routing.md) - File-based routing and data loading - [Tutorials](tutorials/README.md) - Step-by-step guides for building applications - -## Changelog - -- **2026-09-09** — Explained document requests, hydration, lazy navigation, and - the server trust boundary; removed an unmaintained framework comparison. diff --git a/docs/logging.md b/docs/logging.md index db47580..a67458e 100644 --- a/docs/logging.md +++ b/docs/logging.md @@ -1,8 +1,3 @@ ---- -title: Logging -last_verified: 2026-09-09 ---- - # Logging ## Overview @@ -410,11 +405,3 @@ rm -rf docker/volumes/lgtm - [Error Handling](error-handling.md) - Error boundaries and HttpError - [Deployment](deployment.md) - Deploy to Deno Deploy, Docker, and more - -## Changelog - -- **2026-09-09** — Removed narrative comments from the revised metrics example. - -- **2026-09-09** — Made the KV tracing example concrete, corrected entry - handling, and removed personal data and unbounded request paths from telemetry - examples. diff --git a/docs/metadata.md b/docs/metadata.md index b15914a..ad95c0c 100644 --- a/docs/metadata.md +++ b/docs/metadata.md @@ -1,8 +1,3 @@ ---- -title: Metadata -last_verified: 2026-09-09 ---- - # Metadata ## React 19 Document Metadata @@ -327,11 +322,3 @@ dynamic values. See React's - [Routing](routing.md) - File-based routing and data loading - [Styling](styling.md) - CSS and TailwindCSS integration - [Static Files](static-files.md) - Serving static assets - -## Changelog - -- **2026-09-09** — Replaced placeholder article content and removed redundant - comments from the revised metadata examples. - -- **2026-09-09** — Corrected title ownership and string children, typed route - examples, and escaped JSON-LD values embedded in HTML. diff --git a/docs/middleware.md b/docs/middleware.md index d3e57fd..93c82cb 100644 --- a/docs/middleware.md +++ b/docs/middleware.md @@ -1,8 +1,3 @@ ---- -title: Middleware -last_verified: 2026-09-09 ---- - # Middleware ## Overview @@ -464,12 +459,3 @@ for hydration must contain only data that client is allowed to receive. - [State Management](state-management.md) - Sharing data across your app - [Error Handling](error-handling.md) - Error boundaries and HttpError - [Logging](logging.md) - Logging and OpenTelemetry - -## Changelog - -- **2026-09-09** — Removed redundant comments from the revised authentication - and client middleware examples. - -- **2026-09-09** — Corrected the execution matrix and lazy middleware - limitation; made authorization checks explicit and separated client navigation - from server access control. diff --git a/docs/routing.md b/docs/routing.md index ed663cf..8249312 100644 --- a/docs/routing.md +++ b/docs/routing.md @@ -1,8 +1,3 @@ ---- -title: Routing -last_verified: 2026-09-09 ---- - # Routing ## File-Based Routing @@ -943,15 +938,3 @@ function SearchFilters() { - [Forms](forms.md) - Form handling with client and server actions - [Error Handling](error-handling.md) - Error boundaries and HttpError - [State Management](state-management.md) - Sharing data across your app - -## Changelog - -- **2026-09-09** — Corrected default serialization claims and linked the - supported-value and custom-registration contract. - -- **2026-09-09** — Replaced the incorrect version-cookie refresh recipe with an - explicit document redirect; clarified blocking authentication and cleaned up - revised examples. - -- **2026-09-09** — Clarified universal loader execution, deferred redirect - limits, layout remounting, root pending feedback, and the beforeHydrate hook. diff --git a/docs/state-management.md b/docs/state-management.md index 1fbe2ee..99cdce2 100644 --- a/docs/state-management.md +++ b/docs/state-management.md @@ -1,8 +1,3 @@ ---- -title: State Management -last_verified: 2026-09-09 ---- - # State Management ## Overview @@ -879,13 +874,3 @@ disagree with SSR. - [Middleware](middleware.md) - Server and client middleware - [Routing](routing.md) - File-based routing and data loading - [Database](database.md) - Deno KV and PostgreSQL - -## Changelog - -- **2026-09-09** — Documented verified serialization behavior and URL - registration; corrected React Context SSR behavior and moved browser storage - reads after hydration. - -- **2026-09-09** — Fixed async loader examples and explained context - registration timing, public serialization, and revalidation versus cached - query data. diff --git a/docs/static-files.md b/docs/static-files.md index c674490..1117b7d 100644 --- a/docs/static-files.md +++ b/docs/static-files.md @@ -1,8 +1,3 @@ ---- -title: Static Files -last_verified: 2026-09-09 ---- - # Static Files ## Public Directory @@ -281,8 +276,3 @@ export default app; - [Styling](styling.md) - CSS and TailwindCSS integration - [Configuration](configuration.md) - Project and build configuration - [Deployment](deployment.md) - Deploy to Deno Deploy, Docker, and more - -## Changelog - -- **2026-09-09** — Corrected automatic CSS inclusion and distinguished hashed - chunks from stable build entries when configuring long-lived caches. diff --git a/docs/styling.md b/docs/styling.md index 5619a71..057cc1e 100644 --- a/docs/styling.md +++ b/docs/styling.md @@ -1,8 +1,3 @@ ---- -title: Styling -last_verified: 2026-09-09 ---- - # Styling ## Overview @@ -868,11 +863,3 @@ details on build artifact caching and how to customize it. - [Configuration](configuration.md) - Project and build configuration - [Metadata](metadata.md) - Page titles and meta tags - -## Changelog - -- **2026-09-09** — Removed redundant comments from revised stylesheet examples - while keeping resource paths explicit. - -- **2026-09-09** — Corrected React stylesheet precedence, documented generated - CSS-module mappings, and aligned the PostCSS plugin with the template. diff --git a/docs/testing.md b/docs/testing.md index 6bb3e63..e0b22eb 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -1,8 +1,3 @@ ---- -title: Testing -last_verified: 2026-09-09 ---- - # Testing Use component tests for UI behavior, `createRoutesStub` for Juniper's client @@ -362,12 +357,3 @@ snapshot diff and keep behavioral assertions for important state changes. - [Forms](forms.md): route actions and fetchers. - [Error handling](error-handling.md): failure paths and serialization. - [CI/CD](ci-cd.md): run the same validation in automation. - -## Changelog - -- **2026-09-09** — Clarified that waitForFakeTime drains due work without - advancing elapsed fake time. - -- **2026-09-09** — Replaced action tests that never submitted with complete - interaction tests, documented adapter boundaries and environment isolation, - and corrected task invocation, fixture cleanup, and snapshot arguments. diff --git a/docs/tutorials/README.md b/docs/tutorials/README.md index ebd2779..a8fadc6 100644 --- a/docs/tutorials/README.md +++ b/docs/tutorials/README.md @@ -1,8 +1,3 @@ ---- -title: Tutorials -last_verified: 2026-09-09 ---- - # Tutorials This section provides hands-on tutorials for learning Juniper. Each tutorial @@ -64,8 +59,3 @@ root; in the copied tutorial project, run `deno task test`. See - [Routing](../routing.md) - File-based routing and data loading - [Forms](../forms.md) - Form handling and actions - [Middleware](../middleware.md) - Adding authentication and other middleware - -## Changelog - -- **2026-09-09** — Clarified public mutation endpoints and the tutorial - validation scope, plus standalone versus repository test commands. diff --git a/docs/tutorials/blog.md b/docs/tutorials/blog.md index a9ca30b..f34b031 100644 --- a/docs/tutorials/blog.md +++ b/docs/tutorials/blog.md @@ -1,8 +1,3 @@ ---- -title: Building a Blog Application -last_verified: 2026-09-09 ---- - # Building a Blog Application This tutorial walks you through building a full-featured blog application with @@ -1023,8 +1018,3 @@ Additional enhancements: - [Forms](../forms.md) - Form handling and validation - [Error Handling](../error-handling.md) - Error boundaries and HttpError - [Deployment](../deployment.md) - Deploy your application - -## Changelog - -- **2026-09-09** — Updated the Deno prerequisite and fixed dynamic page titles - to render one string.