Changelog
Release history for the Fiskil docs engine.
Changelog
Four customization features, all opt-in in docs.json.
- Custom 404 (
errors.404) — a themed not-found page with live search-powered suggestions. - Fonts (
fonts) — any Google font or a self-hosted file, for all text or headings and body separately. - Redirects (
redirects) — edge 308/307 redirects with wildcard support, so moved pages keep their links. - Stronger SEO — JSON-LD structured data, per-page
keywords/canonical/ogImage, Twitter cards, and globalseo.metatags.
OpenAPI polish from rebuilding the real Fiskil docs on the engine. YAML
spec support, grouped-reference sidebar sub-headings, an x-fiskil-notice
operation callout, <RequestExample>/<ResponseExample> components, and
correct prev/next navigation across products, versions, and groups.
Ask AI is now a docked side panel — it slides in beside your content (expandable) on desktop and as a full-height sheet on mobile, replacing the centered dialog.
Ask AI and page feedback, both opt-in in docs.json.
assistant.enabledadds an AI assistant that answers only from your docs — streaming answers, page citations,Cmd+I,?assistant=deep links, and up to three starter questions. The model runs on the Fiskil platform; you hold no AI keys. Customize tone withcontent/assistant/instructions.md.feedback.enabledadds a "Was this page helpful?" widget with optional down-vote comments, aggregated per page in the console.
Upgrading sites: run fiskil doctor — this release adds three route stubs.
Publishing
- New
fiskil publishcommand — deploy through the Fiskil platform with a single command; site tokens need zero flags. - Hosted deployments fixed: locale and product routing now works on platform-built sites (proxy configuration travels inside the build).
API references
openapi.apisreplacesopenapi.variants: references are identified byproductandsection, per-spec options move inline, and one product can mount multiple reference sections.- Grouped references (
groups) with a dropdown or stacked-list switcher, per-group categories, and MDX-only groups. - Endpoint categories can attach to labeled sidebar sections via per-spec
sectionandsectionByTag. - Cleaner slugs from messy operationIds; remote spec caching is collision-proof.
Content & branding
<Update>/<Updates>changelog components with tag filtering — this page is built with them.logoconfiguration and favicon-by-convention.- Custom MDX components via
src/mdx-components.tsx, composing engine primitives from@fiskil/docs/mdx. - Authored home page convention (
content/docs/index.mdx). - Sections generalized: any top-level folder is a section tab.
SEO & analytics
- Sitemap and robots.txt generation,
seo.noindex, frontmatternoindex. - PostHog integration (
integrations.posthog). - Markdown content negotiation:
.mdand.mdxsuffixes on any page.
fiskil initscaffold reworked to a neutral template with a guided tour.- Mermaid diagrams render correctly in dark mode across all diagram types.
- Scaffolding fixed for project paths containing spaces.
First release: the @fiskil/docs engine and fiskil CLI — MDX content
tree, products and sections, OpenAPI references with an interactive
playground, localization, search, theming, and llms.txt out of the box.