docs: sharpen Kida product positioning - #309
Merged
Merged
Conversation
There was a problem hiding this comment.
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.mdbrief 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. |
| [](https://opensource.org/licenses/MIT) | ||
|
|
||
| **Server-side components for Python — no npm, no build step.** | ||
|  |
| <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) |
| Markdown, terminal output, and CI reports—with no npm, no build step, and no | ||
| runtime dependencies. | ||
|
|
||
|  |
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
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.
Summary
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 lintmake format-checkmake tymake test— 4,886 passed, 6 skippedmake docsuv buildgit diff --check