Skip to content

Add a "make it yours" guide to each template's docs #78

Closed

Description

@stphnwlsh

The first thing anyone does after dotnet new is swap Movies and Reviews for their own domain, and nothing on the site walks them through it. Each template gets a guide that goes from a new entity to a migration to the template's own way of exposing it, then clears out the sample data, linking the skills that already cover each step.

Phase 1: Write it once for Minimal API

  • Guide at minimalapi/guides/make-it-yours.mdx: add an entity, repository method, migration, use case, endpoint and tests
  • Remove or replace the seed data (sample-data) and the sample tests
  • Link the matching skills (add-a-use-case, database-migrations, sample-data, expose-a-use-case)

Phase 2: The other four

  • MCP (tool), GraphQL (query, mutation, type), Web API (controller action), Lambda Function (function)
  • Link it from each getting-started page and the sidebar

Checks: the site builds, and every command in the guides runs on a freshly generated solution.

Activity

  1. added this to the 2026.12.01 milestone on Nov 6, 2026
  2. self-assigned this
    on Nov 6, 2026
  3. stphnwlsh commented on Nov 8, 2026

    @stphnwlsh
    MemberAuthor

    Handoff

    Done: no pull request yet. A draft of minimalapi/guides/make-it-yours.mdx exists only in the site clone on Steve's Mac. It's on a local feature/make-it-yours branch with uncommitted changes to the guide, astro.config.mjs and minimalapi/getting-started.mdx. Phase 1 is ticked above, but nothing has been pushed.

    Checked: read the draft. It builds a Cinema slice next to the sample, then clears out the movies, and the voice is right. Its commands haven't been run on a fresh solution yet, which this issue's checks ask for.

    Left:

    1. Push the Minimal API guide and open its PR.
    2. Run every command in it on a freshly generated solution.
    3. Steve reads it.
    4. Write the guides for MCP, GraphQL, Web API and Lambda Function, then link each one from its getting-started page and sidebar.

    Waiting on: the agent that owns the local draft, then Steve's read. Anything not merged by 27 November moves to 2027.01.01 if Steve agrees.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions