TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

User Docs Driven Development

1 pointsby esher6 months ago

1 comment

eesmith6 months ago
Back in 1996, Steve McConnell&#x27;s &quot;Rapid Development&quot; listed a few ways to develop a spec. One of them was (p324, according to <a href="https:&#x2F;&#x2F;archive.org&#x2F;details&#x2F;rapiddevelopment00mcco&#x2F;mode&#x2F;2up?q=%22user+manual+as+spec%22" rel="nofollow">https:&#x2F;&#x2F;archive.org&#x2F;details&#x2F;rapiddevelopment00mcco&#x2F;mode&#x2F;2up?...</a>):<p>&gt; User manual as spec — Instead of writing a traditional specification, write a user manual, and require the software to conform to the manual. Since you have to write the user manual at some point anyway, you might as well write it first and eliminate the redundancy you would otherwise incur by writing both a user manual and a specification. A variation on this idea is to write an on-line help system for use as the spec.<p>The approach given here seems a combination of user-manual-as-spec and evolutionary prototyping.