Skip to content

feat(content): add app-idea founder walkthrough draft - #655

Merged
pftg merged 1 commit into
masterfrom
draft/app-idea-where-to-start
Sep 9, 2026
Merged

feat(content): add app-idea founder walkthrough draft#655
pftg merged 1 commit into
masterfrom
draft/app-idea-where-to-start

Conversation

@pftg

@pftg pftg commented Sep 9, 2026

Copy link
Copy Markdown
Member

Summary

Add the requested beginner guide, Have an App Idea? Here's Where to Start, as an unpublished article with draft: true. This draft PR is for review only, not authorization to merge or publish.

  • Walk a non-technical founder from a concrete problem through an AI interview, a one-page concept, rough screens, a fictional-data demo, and observation of someone trying it.
  • Preserve the approved prose, worked example, tables, and both copyable prompts.
  • Add the house-template cover, its reproducible HTML source, and a self-contained SVG wireframe. The SVG replaces the equivalent text sketch that wrapped poorly on mobile.
  • Include inline official documentation and four relevant founder-course links. Documented tool capabilities are not presented as hands-on testing.
  • Add a narrowly scoped STATUS row without changing outreach priorities or the course distribution plan.

Validation

  • Final draft-inclusive development build: PASS; all eight course validators passed.
  • Normal production build with BUILD_DRAFTS unset: PASS; the draft page is absent, with no production HTML references to its slug.
  • BUILD_DRAFTS=1 OUTPUT_DIR=_dest/public-linkcheck bin/rake test:links: PASS, scanning 1,777 HTML pages and 150,732 links with zero errors. Confirmed the new draft and its final SVG are in the input tree. This is an offline internal-link check; 35,932 excluded links were not tested.
  • Targeted new-article internal-link check: PASS, 94 links, zero errors, 18 exclusions.
  • ruby bin/check-post-visuals: PASS, 67 missing visuals against a ceiling of 69. This corpus ratchet skips drafts; the draft's actual SVG and rendered review provide its visual evidence.
  • Desktop 1280×800 and mobile 390×844 renders: no horizontal overflow, missing images, or browser page errors. Cover, prompts, tables, SVG, and blog-list thumbnail inspected.
  • Independent article, cover, wireframe-equivalence, and reading-layout reviews found no blocking issue within their scope. These are not publication sign-off.
  • git diff --cached --check: PASS. No dependency or configuration files changed.

Reading and media review

Measurement Desktop 1280×800 Mobile 390×844
Whole-page screens to scroll 16.51 19.27
Longest measured run between headings/media/lists/tables/prompts 1,352 px 1,643 px
Horizontal overflow None None

Whole-page counts include the post-article CTA, related material, and footer. The run metric excludes paragraph and blockquote breaks; the independent visual review found the actual reading sections appropriately separated. Prompts and tables are tall on mobile but remain contained and readable.

Cover review scores: looks 4/5, readability 3/5, earns scroll 4/5, useful guidance 3/5. Small cover chips are supporting preview cues, not mobile instructions. The body wireframe is readable in the actual mobile page.

Reproduction and limits

BUILD_DRAFTS=1 OUTPUT_DIR=_dest/public-dev bin/hugo-build
env -u BUILD_DRAFTS ENVIRONMENT=production OUTPUT_DIR=_dest/public-production bin/hugo-build
BUILD_DRAFTS=1 OUTPUT_DIR=_dest/public-linkcheck bin/rake test:links
ruby bin/check-post-visuals

Validated with Hugo 0.165.0 Extended, Bun 1.3.14, Node 26.8.1, Ruby 3.3.8, Bundler 2.7.2, and lychee 0.24.2. Ruby uses the repository's documented container fallback rather than pinned Ruby 4.0.6. Frozen dependencies installed without lockfile changes.

External-link crawling, the full visual-regression suite, clipboard interactions, keyboard accessibility, and zoom/reflow were not validated. No production publication, merge, or publication-ready editorial sign-off is included.

Preserve approved prose and prompts; add cover source, PNG and equivalent mobile-readable SVG. Keep draft: true and publication separate.

Checks: final draft dev build and normal production build pass; draft-inclusive internal link gate 150732 links, 0 errors; targeted article 94 links, 0 errors. Normal production excludes draft. Desktop 1280x800 and mobile 390x844 reviewed; no overflow or missing images. Visuals ratchet 67/69 passes (draft excluded).

Media scores: looks 4/5; readability 3/5; earns scroll 4/5; useful guidance 3/5. Whole-page screens desktop 16.51/mobile 19.27; longest measured structural runs 1352px/1643px, visually reviewed. No publication sign-off.
@coderabbitai

coderabbitai Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: f58e78cd-b274-4510-8592-acf785961e27


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@pftg
pftg marked this pull request as ready for review September 9, 2026 15:00
@pftg
pftg merged commit 7a15bd0 into master Sep 9, 2026
6 checks passed
@pftg
pftg deleted the draft/app-idea-where-to-start branch September 9, 2026 16:58
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.

1 participant