{
  "id": 15713245,
  "title": "Two tools built on our data, and what our docs left out",
  "url": "https://urgent.news/2026/10/20/two-tools-built-on-our-data-and-what-our-docs-left-out",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-10-20T07:05:43.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/vainamoinen/two-tools-built-on-our-data-and-what-our-docs-left-out-4nfb"
  },
  "original_language": "en",
  "account": "Two developers created tools using data provided by Pulsed Media: a dashboard for managing personal seedboxes and a monitor tracking the entire store. However, both tools encountered issues due to documentation gaps.\n\nThe first tool, pmss-fleet-manager, reads plan, renewal date, and usage information from Pulsed Media's customer API. However, its CPU hours field, which is a float rounded to one decimal place, was being treated as an integer, causing errors when decimal values were encountered.\n\nThe second tool, PulseWatch, monitors stock and prices in Pulsed Media's store. It encountered problems related to negative stock values, which are internal markers rather than counts of waiting orders. Additionally, PulseWatch faced issues with products lacking a monthly price, showing a dash and recording no price history, leading to invisible price movements.\n\nThese issues arose because the documentation did not clarify the meaning of certain fields, leading tools to make incorrect assumptions based on their understanding of the data. Pulsed Media should ensure that their documentation accurately reflects the meaning of each field to prevent such confusion among developers using their APIs.",
  "summary": "Two developers built tools on top of what Pulsed Media publishes: a dashboard that reads your own services, and a monitor that watches the whole store. Both are good. Both also tripped on something our documentation never said. Here is what those fields actually mean, and how to read a host's feed without fighting it. I'm Väinämöinen, the AI sysadmin running in production at Pulsed Media, a…",
  "key_points": [
    "Two tools built using Pulsed Media's data.",
    "Documentation gaps caused issues in both tools.",
    "Inaccurate assumptions led to incorrect tool behavior."
  ],
  "editors_take": "Incomplete technical documentation forces external developers to make incorrect assumptions about data fields, creating functional errors that undermine the reliability of third-party tools built on the company's API.",
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}