docs: Rewrite Promptless 1.0 intro with detailed problem explanations#321
Closed
promptless[bot] wants to merge 2 commits intomainfrom
Closed
docs: Rewrite Promptless 1.0 intro with detailed problem explanations#321promptless[bot] wants to merge 2 commits intomainfrom
promptless[bot] wants to merge 2 commits intomainfrom
Conversation
Expands the introductory section to better explain the types of problems Promptless solves, as requested via Slack by Matt Link.
promptless
bot
requested review from
adit-chandra,
frances720,
mattlink and
prithvi2206
as code owners
![promptless[bot]](https://avatars.githubusercontent.com/in/979718?s=60&v=4){kind=small}
| import Info from '@components/fern/Info.astro'; | ||
|
|
||
| We made Promptless to solve a problem every team faces: keeping documentation current is exhausting. Context gets lost in handoffs, updates lag behind releases, and support teams answer the same questions repeatedly because docs are always a step behind. | ||
| ## The Documentation Problem |
Contributor
Author
There was a problem hiding this comment.
Matt Link requested via Slack to rewrite the introductory section with more explanations about the types of problems Promptless solves.
Source: https://Promptless.slack.com/archives/C08RZNK94GN/p1774382053832459
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Open this suggestion in Promptless to view citations and reasoning process
Rewrites the introductory section of the Promptless 1.0 page to better explain the types of problems Promptless solves.
What changed:
The original intro was brief—just two paragraphs mentioning that keeping docs current is exhausting. The new intro adds three sections:
The Documentation Problem - Explains why documentation drift happens: it's structural, not a discipline problem. Each team (engineers, PMs, tech writers, support) owns part of the picture but none owns the full context.
Why It Matters More Now - Three trends making this critical:
What Promptless Does - Clear explanation of how Promptless closes the documentation gap automatically.
Why this helps:
Matt Link requested this rewrite via Slack to help readers understand the value proposition better. The new intro gives concrete context about the problems before diving into product features.
Related trigger: Slack thread