Add SignalGrid launch outreach package documentation - #103
Conversation
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 8fdbdb2e0d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| - live product flow at `/demo` | ||
| - verification endpoint: `/api/demo/verify?scenario=all` | ||
| - architecture explainer: `docs/assets/signalgrid-runtime-architecture.svg` |
There was a problem hiding this comment.
The outreach email template is intended for external recipients, but these values are repository/app-relative paths rather than publicly resolvable links. In an email client, /demo, /api/demo/verify?scenario=all, and docs/assets/... will not open the intended resources unless the sender manually rewrites them, which makes the “ready-to-use” package fail in its default form. Use fully qualified URLs (or explicit placeholders for a base URL) so the template works as written.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Summary
- Addressed the PR review feedback by replacing repository/app-relative links with externally usable fully qualified URL placeholders throughout the outreach package. This includes the LinkedIn teaser, outreach email template, discovery script, and demo walkthrough content so copy-pasted outreach works in email clients without manual URL rewriting.
- Added an explicit guardrail instruction to replace
{{SignalGridBaseUrl}}with a public HTTPS host, including an example host format for clarity. - Committed the change locally on the current branch with commit
39711e9. - Created a follow-up PR record via
make_prtitled: “Follow-up: replace internal outreach links with externally resolvable URL placeholders.”
Testing
- ✅
find .. -name AGENTS.md -print - ✅
sed -n '1,220p' docs/LAUNCH_OUTREACH_PACKAGE.md - ✅
git diff -- docs/LAUNCH_OUTREACH_PACKAGE.md - ✅
perl -0pi -e 's#/api\\{\\{SignalGridBaseUrl\\}\\}/demo/verify\\?scenario=all#{{SignalGridBaseUrl}}/api/demo/verify?scenario=all#g' docs/LAUNCH_OUTREACH_PACKAGE.md && git diff -- docs/LAUNCH_OUTREACH_PACKAGE.md - ✅
git add docs/LAUNCH_OUTREACH_PACKAGE.md && git commit -m "Fix outreach links to use fully qualified URL placeholders" - ✅
nl -ba docs/LAUNCH_OUTREACH_PACKAGE.md | sed -n '1,220p' - ✅ Web check executed before response:
search_query("how to format fully qualified URL placeholders in documentation templates")
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: ec2c39a968
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| What we can share today: | ||
| - live product flow at `{{SignalGridBaseUrl}}/demo` | ||
| - verification endpoint: `{{SignalGridBaseUrl}}/api/demo/verify?scenario=all` | ||
| - architecture explainer: `{{SignalGridBaseUrl}}/assets/signalgrid-runtime-architecture.svg` |
There was a problem hiding this comment.
{{SignalGridBaseUrl}}/assets/signalgrid-runtime-architecture.svg will 404 in the current app, so outreach recipients cannot open the architecture visual from the email template. I checked the repo and the file exists only at docs/assets/signalgrid-runtime-architecture.svg, while public/ has no assets/ copy and next.config.ts defines no rewrite for /assets/*; this makes the “ready-to-use” outreach package fail for that link.
Useful? React with 👍 / 👎.
1 participant
Motivation
Description
docs/LAUNCH_OUTREACH_PACKAGE.mdcontaining a LinkedIn teaser, short founder intro, outreach and follow-up email templates, a 15-minute discovery call script, a one-page pilot offer outline, a demo walkthrough script, and suggested CTAs./demo,/api/demo/verify?scenario=all, anddocs/assets/signalgrid-runtime-architecture.svgfor reproducible demos.Testing
Codex Task