Skip to content

docs: sharpen Kida product positioning - #309

Merged
lbliii merged 1 commit into
mainfrom
codex/kida-product-marketing
Aug 4, 2026
Merged

docs: sharpen Kida product positioning#309
lbliii merged 1 commit into
mainfrom
codex/kida-product-marketing

Conversation

@lbliii

@lbliii lbliii commented Aug 4, 2026

Copy link
Copy Markdown
Owner

Summary

  • rewrite the README around Kida's differentiated server-side component model and route advanced material into the published docs
  • align the PyPI description, site metadata, and homepage messaging around typed, composable components checked before render
  • add an internal product-positioning brief with audience, message hierarchy, proof points, boundaries, and editorial guidance
  • add a new screen-print hero featuring Kida, the cross-eyed snow-lynx Bengal, actively assembling rosette-shaped jungle components across web, terminal, Markdown, and CI surfaces

Why

The existing README was accurate but carried landing-page, tutorial, reference,
release-history, and ecosystem duties at once. This pass gives Kida a clearer
category and promise, moves proof closer to each claim, removes repetition, and
makes the repository, package metadata, and published homepage tell one product
story.

The hero extends the visual language used across the personal project stack
while giving Kida an active role in the product metaphor: her paws assemble the
component system and her striped tail routes its outputs.

Impact

Documentation, product marketing, package metadata, and imagery only. There are
no runtime, API, CLI, or dependency changes, so no downstream pilot is required.

Validation

  • make lint
  • make format-check
  • make ty
  • make test — 4,886 passed, 6 skipped
  • targeted documentation and release contracts — 13 passed
  • make docs
  • uv build
  • git diff --check
  • full-resolution visual inspection of the 1672×941 WebP hero

@lbliii
lbliii marked this pull request as ready for review August 4, 2026 17:14
Copilot AI lite review requested due to automatic review settings August 4, 2026 17:14
@lbliii
lbliii merged commit 02ad683 into main Aug 4, 2026
14 checks passed
@lbliii
lbliii deleted the codex/kida-product-marketing branch August 4, 2026 17:14

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR refocuses Kida’s public-facing messaging (README, docs homepage, and package/site metadata) around Kida’s “server-side component system” positioning, and adds an internal positioning brief to keep future copy aligned.

Changes:

  • Rewrites the README as a product-oriented landing page with clearer positioning, tighter “why,” and curated “explore” links.
  • Aligns short descriptions across the docs homepage frontmatter, site config, and PyPI project metadata.
  • Adds an internal docs/product-positioning.md brief documenting category, message hierarchy, proof points, boundaries, and editorial guidance.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
site/content/_index.md Updates homepage headline/body copy and adds a hero image to support the new positioning.
site/config/_default/site.yaml Aligns site-level description string with the revised messaging.
README.md Major rewrite to sharpen positioning, add curated entry points, and simplify/reshape the narrative.
pyproject.toml Aligns the PyPI short description with the new positioning sentence.
docs/README.md Adds the new internal positioning brief to the docs index.
docs/product-positioning.md Introduces an internal messaging guide to keep future copy consistent and bounded.

Comment thread README.md
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

**Server-side components for Python — no npm, no build step.**
![Kida, a cross-eyed snow-lynx Bengal cat, actively assembling jungle components that become web, terminal, Markdown, and CI output](site/assets/images/kida-jungle-components-hero.webp)
Comment thread README.md
<summary><strong>CI Reports (GitHub Action)</strong></summary>

Turn pytest, coverage, ruff, and other tool output into step summaries and PR comments.
The [app-owned component authoring contract](site/content/docs/usage/components.md#app-owned-authoring-contract)
Comment thread site/content/_index.md
Markdown, terminal output, and CI reports—with no npm, no build step, and no
runtime dependencies.

![Kida, a cross-eyed snow-lynx Bengal cat, actively assembling jungle components that become web, terminal, Markdown, and CI output](https://raw.githubusercontent.com/lbliii/kida/main/site/assets/images/kida-jungle-components-hero.webp)
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.

2 participants