frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

Open in hackernews

Show HN: I built a GitHub AI app to automate the fixing of outdated docs

https://github.com/marketplace/deepdocsai
1•NeelDas•5h ago
In my 15+ years as a developer, one of the most annoying things I've consistently faced is outdated documentation. I am also not a saint either, I skip updating docs myself. So I started working on tools to make maintaining docs a bit easier for developers like us.

There have been many attempts to solve the problem of continuous documentation. Tools like Swagger or Sphinx-autodoc can generate docs from OpenAPI specs or code annotations, but they only work in very narrow settings. They don't help much with higher-level docs like user guides, quickstarts, or example scripts. And they still rely on developers to manually maintain intermediate elements like docstrings.

With LLMs, updating high-level docs has gotten easier. You can prompt your AI IDE (e.g. Cursor) to update docs, and it usually works. But this approach has a few issues:

- You have to remember to prompt after every code change. - You don't know exactly which files are being used in context—either you specify them manually or trust the agent. - If teammates start updating docs separately in their own AI IDEs, things get messy fast. - [Minor] The updated docs often lose the structure or style of the original unless you're really careful with your prompts.

So I wanted something that would keep code and docs in sync automatically, with minimal human effort. So I built DeepDocs, an LLM-powered GitHub app for continuous documentation.

Once installed and configured, DeepDocs listens for code commits, detects relevant doc drift, and proactively opens a clean branch with suggested updates. Because it runs upstream, it only triggers after all necessary code changes are merged.

It keeps updates to the absolute necessary and respects the original formatting and structure. You don't need to prompt it or manually specify any file context, as DeepDocs always keeps the source code and docs in context.

The app is completely free to try on GitHub. I'd really appreciate any feedback or suggestions.

Comments

NeelDas•5h ago
Some context on what happens when you install DeepDocs:

When you install DeepDocs on a specific repo for the first time, it performs a deep scan of your repository and shares a report on whether your README is up to date. If it's not, DeepDocs creates a separate branch with the proposed updates.

If you want DeepDocs to work with a specific file or folder (e.g. `docs/`), you can add a `deepdocs.yml` file at the root of your repo. With this YAML file, you can:

- Set up a continuous documentation pipeline on any branch (e.g. `main`, `feature-branch`). Any commits to this sync branch will trigger a documentation update. - Run a deep scan of your repo on any branch and fix outdated docs in one go.

More details in the Quickstart: https://docs.deepdocs.dev/get-started/quickstart/

Helium 3

https://en.wikipedia.org/wiki/Helium-3
1•zafka•58s ago•0 comments

A New Chapter for Our Built World

https://bedrockrobotics.com/news/introducing-bedrock-robotics
2•pryz•2m ago•1 comments

Situated Software (2004)

https://web.archive.org/web/20040411202042/http://www.shirky.com/writings/situated_software.html
1•blackbrokkoli•5m ago•0 comments

A list of disposable email domains

https://github.com/disposable-email-domains/disposable-email-domains
1•taubek•5m ago•0 comments

Ask HN: Is it okay to stop chasing expertise?

3•grandimam•5m ago•0 comments

Young Graduates Are Facing an Employment Crisis

https://www.wsj.com/economy/jobs/jobs-unemployment-rise-young-people-ce4704d8
1•bdev12345•5m ago•0 comments

Least squares and least absolute deviations

https://niklasbuschmann.github.io/least-squares-least-absolute-deviation/
1•niklasbuschmann•7m ago•0 comments

New map reveals the most financially distressed states in the US

https://nypost.com/2025/07/16/lifestyle/new-map-reveals-most-financially-distressed-states-in-the-us/
1•bdev12345•7m ago•0 comments

I wrote modern Nowel about Dog Mothers and Incels

https://akirakitto.gumroad.com/l/DogMothersandIncels
1•akirahittoxyz•9m ago•0 comments

First electronic-photonic quantum chip manufactured in commercial foundry

https://news.northwestern.edu/stories/2025/07/first-electronic-photonic-quantum-chip-manufactured-in-commercial-foundry/
2•gmays•10m ago•0 comments

Show HN: Copilot for entra external id / Azure ad to learn and prototype

https://www.rapit.ai
1•gritlin•10m ago•0 comments

US senators exempt HIV/Aids funding from planned spending cuts

https://www.bbc.com/news/articles/c0q8ypew5l0o
2•andsoitis•11m ago•0 comments

Near-cryogenic direct air capture using adsorbents

https://pubs.rsc.org/en/content/articlelanding/2025/ee/d5ee01473e
1•PaulHoule•12m ago•0 comments

Layoffs, Automation, and the Road to Reinvention

https://michaelbastos.com/blog/layoffs-automation-and-the-road-to-reinvention
1•mbastos•13m ago•2 comments

AI Founder Became a Billionaire by Building ChatGPT for Doctors

https://www.forbes.com/sites/amyfeldman/2025/07/15/this-ai-founder-became-a-billionaire-by-building-chatgpt-for-doctors/
1•andrewl•13m ago•0 comments

Show HN: I am bringing back Youtube poll cards

https://askk.app
1•yassino•14m ago•0 comments

Google Keeps Making Smartphones Worse

https://jacobin.com/2025/07/google-android-smartphones-open-source/
2•DicIfTEx•14m ago•0 comments

Brave Search API Listed in AWS Marketplace

https://brave.com/blog/search-api-aws-marketplace/
1•w0ts0n•14m ago•0 comments

Ukrainian hackers claim to destroy major Russian drone maker's entire network

https://www.theregister.com/2025/07/16/ukrainian_drone_attack/
1•rntn•14m ago•0 comments

Scale AI cuts 14% of workforce after Meta investment, hiring of founder Wang

https://www.cnbc.com/2025/07/16/scale-ai-cuts-14percent-of-workforce-after-meta-investment-hiring-of-wang.html
1•itg•15m ago•0 comments

Show HN: Claude Code SDK for Ruby

https://github.com/schappim/claude-code-sdk-ruby
1•schappim•18m ago•0 comments

Promptbio.ai – GenAI-Powered Biological Data Analysis

1•PromptBio•19m ago•0 comments

OpenAI says it will use Google's cloud for ChatGPT

https://www.cnbc.com/2025/07/16/openai-googles-cloud-chatgpt.html
3•mfiguiere•21m ago•0 comments

Classical Theism

https://en.wikipedia.org/wiki/Classical_theism
1•taylorlapeyre•22m ago•0 comments

Zuck's parents banned from bridge for cheating at bridge [pdf]

https://web2.acbl.org/discipline/Panel_Report_Edward_Zuckerberg.pdf
6•KingCML•22m ago•1 comments

Chinese criminal software 'Darcula' tricking consumers

https://www.abc.net.au/news/2025-07-17/criminal-software-darcula-used-by-scammers-for-phishing-attacks/105527932
2•som•23m ago•0 comments

The Myth of Endless Dev Jobs

https://michaelbastos.com/blog/the-myth-of-endless-dev-jobs
2•mbastos•24m ago•2 comments

How will age verification for porn work and what about privacy?

https://www.bbc.com/news/articles/ceq7ye3q2zwo
1•lakis•24m ago•0 comments

AI computing power is splitting the world into haves and have-nots

https://www.nytimes.com/interactive/2025/06/23/technology/ai-computing-global-divide.html
1•bookofjoe•25m ago•1 comments

Building a tool that makes being on call for Type 1 Diabetes a little easier

https://maori.geek.nz/being-on-call-for-type-1-diabetes-with-carer-777899f0162e
2•grahar64•28m ago•0 comments