PPowerduck1d ago · 4 min readCustom Lint Rules and Decorators: Encoding Team Conventions in the SpecQuick answer: Built-in linting catches generic mistakes, but every team has conventions that generic rules do not know, naming standards, required headers, versioning rules, and which operations an agblogs.powerduck.com
PPowerduck1d ago · 5 min readDocs Search: Hosted Indexing vs Static Build-Time SearchQuick answer: Docs search is a core navigation feature, not an add-on, and the choice between a hosted search index and build-time static search is really a decision about infrastructure, privacy, andblogs.powerduck.com
PPowerduck1d ago · 4 min readOpenAPI default Values: Convenient for Docs, Dangerous for ValidationQuick answer: A default in OpenAPI documents what a server or client may assume when a property is absent, but it is not a validation instruction and it does not guarantee the running system actually blogs.powerduck.com
PPowerduck1d ago · 4 min readCodegen vs additionalProperties: When Free-Form Maps Break Typed ClientsQuick answer: An OpenAPI schema with additionalProperties describes a free-form map keyed by strings, and how a code generator turns that into typed code varies a lot between languages and generators.blogs.powerduck.com
PPowerduck1d ago · 5 min readBundling Multi-File OpenAPI: $ref Resolution ComparedQuick answer: Splitting an OpenAPI document across files is the right move for large APIs, but every tool that consumes the spec — docs, mock servers, code generators, gateways — needs a bundled, resoblogs.powerduck.com
PPowerduck1d ago · 5 min readVersioned Docs for Multiple API Versions: Mintlify vs Spec BranchesQuick answer: Versioned documentation is only worth its complexity if you actually support multiple live API versions; for a single evolving API, a well-managed deprecation policy with one current speblogs.powerduck.com
PPowerduck1d ago · 5 min readDesigning Cursor Pagination: Why Offset Hits a WallQuick answer: Offset pagination is simple and correct for static, small result sets, but it breaks down on live data: as rows are inserted or deleted between requests, pages skip or duplicate records,blogs.powerduck.com
PPowerduck1d ago · 6 min readGenerated Enums Break When the API Adds a New ValueQuick answer: A generated enum is a closed set by default, so the moment the server adds a value the client did not know about, strict generated code can throw, fail to deserialize, or silently drop tblogs.powerduck.com
PPowerduck2d ago · 2 min readMigrating from Redocly to PowerduckShort answer: The contract is already the valuable asset, so the migration is not a rewrite. Bring the OpenAPI file into the studio, validate it, and generate the reference, mocks, tests, and tools frblogs.powerduck.com
PPowerduck2d ago · 2 min readMCP Servers in Docs: Redocly vs PowerduckShort answer: A docs platform adds MCP and AI search on higher tiers, which is useful for a portal; a studio generates the MCP server from the contract as a core capability, so an external agent can cblogs.powerduck.com
