Skip to content

Docs: GETTING-STARTED.md presenter script — AOT execute no longer partial (#764) #1813

Description

@PurHur

Problem

docs/GETTING-STARTED.md still tells presenters that native AOT execute for MiniWebApp is partial (#1044). #764 ✅ closed: home, hello PATH_INFO, contact POST, and api/status execute under AOT + CGI.

Demo audiences get a weaker story than examples/003-MiniWebApp/README.md and development-status.md already show.

Goal

Update the five-minute presenter script:

  1. VM path — phpc serve examples/003-MiniWebApp (unchanged, primary dev)
  2. AOT path — add phpc build --project, phpc run --project --cgi-env-file …, optional phpc serve --aot when LLVM present
  3. Remove "partial AOT" wording; footnote layout-edge bisect (North Star 1: layout-edge AOT bisect ladder (post-#764, not blocking #1044 close) #1750) as non-blocking polish
  4. Cross-link Docs: Sync North Star 1 status — README, #1044, development-status.md (#764 closed) #1525 (root README) and Examples: Sync examples/README.md run matrix after #764 close #1531 (examples README) for same PR bundle

Implementation hints

Section File Change
MiniWebApp demo docs/GETTING-STARTED.md Replace partial-AOT sentence
Commands Copy from examples/003-MiniWebApp/README.md AOT debug section phpc run --project --cgi-env-file
Troubleshooting Link phpc doctor --gates #1752 after #1760
Public site docs/pages/development-status.md Coordinate with #1525

Acceptance criteria

./phpc lint --all examples/003-MiniWebApp
./phpc build --project examples/003-MiniWebApp
./phpc run --project examples/003-MiniWebApp --cgi-env-file test/fixtures/cgi-env/miniwebapp-home.env

Verification (local / Docker only)

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  ./phpc build --project examples/003-MiniWebApp

No GitHub Actions.

Dependencies

Links

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions