Skip to content

docs: add 107 per-feature GitHub issue drafts for all server integrations#160

Closed
s2x wants to merge 2 commits into
mainfrom
docs/feature-issues
Closed

docs: add 107 per-feature GitHub issue drafts for all server integrations#160
s2x wants to merge 2 commits into
mainfrom
docs/feature-issues

Conversation

@s2x
Copy link
Copy Markdown
Contributor

@s2x s2x commented May 6, 2026

Summary

107 issue files in docs/issues/, one per missing/partial feature from the feature matrix. Each file follows the existing repo issue format: Problem, Impact, Context (with code references), Proposed solution, Acceptance criteria (tests, docs, functional tests, changelog), and Notes.

Per-server breakdown

Server Files Coverage
core 4 <esi:inline>, <esi:choose>, <esi:try>, <esi:vars> + $(...) expressions
nginx 16 All missing directives: max_depth, timeout, parse_on_header, block_private_ips, allowed_hosts, allow_private_ips_for_allowed, max_response_size, max_concurrent_requests, max_workers, debug, include_error_marker, cache (memory/redis/memcached), cache_key_template, shared_http_client
apache 14 All missing Mesi* directives (same feature scope as nginx)
caddy 16 All missing Caddyfile directives inside mesi { } block
roadrunner 16 All missing .rr.yaml config options
traefik 15 All missing YAML plugin config options
php-ext 14 All missing mesi\parse_with_config() array keys
cli 11 All missing CLI flags

Not included

  • Proxy — zero issues (all features already supported per the matrix)

Purpose

These are issue drafts — technical specifications to be turned into actual GitHub issues and implemented server by server. Each can be copied directly into a GitHub issue body.

s2x added 2 commits May 6, 2026 22:29
103 issue files across 8 servers, one per missing feature from the
feature matrix (docs/features.md). Each file follows the existing
repo issue format: Problem / Impact / Context / Proposed solution /
Acceptance criteria (tests, docs, functional tests, changelog) /
Notes.

Servers covered:
- core (1  file): shared <esi:inline>/<esi:choose>/<esi:try>/<esi:vars>
- nginx    (16): all missing EsiParserConfig directives + libgomesi migration
- apache   (14): all missing Mesi* directives
- caddy    (16): all missing Caddyfile directives
- roadrunner (16): all missing .rr.yaml config options
- traefik  (15): all missing YAML plugin config options
- php-ext  (14): all missing parse_with_config() options
- cli      (11): all missing CLI flags

Proxy omitted — all features already supported.
- 001: <esi:inline> — body passthrough, escape hatch
- 002: <esi:choose>/<esi:when>/<esi:otherwise> — conditional content
- 003: <esi:try>/<esi:attempt>/<esi:except> — exception handling
- 004: <esi:vars> +  expression evaluation

Each is an independent parser feature with its own tests and
acceptance criteria.
@s2x s2x closed this May 18, 2026
@s2x s2x deleted the docs/feature-issues branch May 18, 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