Skip to main content

Featured

The Docstring Coverage Gate Is the Product: What I Verified in AI Doc Generator

The Docstring Coverage Gate Is the Product: What I Verified in AI Doc Generator Documentation debt never announces itself. It shows up as the three hours you lose reading a function called process_data2 , or as the README that documents an argument the code stopped accepting two refactors ago. Every team knows the number that matters is documentation coverage, and almost nobody has a cheap way to measure it, let alone gate a merge on it. That is the specific pain I went looking for a tool to solve, and it is how I ended up testing AI Doc Generator — a $49 single-file Python CLI that scans a codebase for undocumented functions and classes. This post is what I actually measured in the bundle, on my machine, from a clean copy. Including the parts that don't work. Yes, it is a product I sell, and this article says so plainly rather than dressing up as a neutral review. The real problem: coverage is invisible until it is a crisis Ask a team what fraction of its public functions...

You do not need another IELTS practice test. You need a score log.

You do not need another IELTS practice test. You need a score log.

Almost everyone preparing for IELTS Academic alone makes the same mistake first: they buy or download more practice tests. Test two, test three, test nine. It feels like progress because a marked paper gives you a number, and a number feels like information.

It is not information you can act on. A band 6.0 on Reading tells you nothing about what to do on Tuesday. What it does not tell you is which question types cost you the marks, whether your Listening dropped because of spelling or because you lost the thread in Section 3, or whether the writing you just produced was a 6 because of task response or because of grammar range. Without a record of that, every new practice test resets the same confusion with fresh numbers.

So this is a post about a boring fix: a log, a plan, and a small set of drills that force the log to happen. I sell the kit that packages it, which I will disclose properly below, but the mechanism is free to copy from this page.

Three things self-study actually lacks

A plan with a mid-point. Eight weeks of "do some practice" is not a plan. A usable plan has one checkpoint where you throw the plan away if the evidence says to: a full mock at week four, scored honestly, which decides what weeks five to seven drill. Everything before that checkpoint is foundation work, everything after it is repair work on the two weakest skills only.

A score log with the rounding rule built in. IELTS round rules are the part candidates get wrong by hand: a raw average ending in .25 rounds up to the next half band, and an average ending in .75 rounds up to the next whole band. If you are converting four module scores in your head at 11pm you will get your own overall band wrong, and then you will plan the wrong next week. The rule is simple but it needs to be a formula, not a mental estimate.

Spelling as a system, not a footnote. In the Listening and Reading completion tasks, a correct answer spelled wrong is simply wrong: "accomodation" scores zero. That is the cheapest band in the whole test to reclaim, and almost nobody drills it deliberately, because it does not feel like studying. It is also the easiest thing to track: a 40-word master list, three statuses (new, daily, perfected) and a dictation drill that puts you under listening pressure instead of reading pressure.

Where IELTS and Duolingo English Test prep diverge

If you are sitting both — or hedging between them — the failure modes are different in one specific way that costs people a whole test fee: DET is taken at home on your own machine, so the setup itself is part of the exam. Platform check, room scan, ID rules, the sequence you are allowed to do them in, what happens if the microphone fails halfway. None of that is English ability, and all of it is published, so it belongs on a checklist you run the night before, not on a page you skim on the morning.

IELTS paper day has its own short list: arrival and ID window, no phone in the room, the transfer/review window at the end of Listening and Reading where you move answers across, and the fact that Writing has no transfer window at all. Run both as a checklist twice — once the night before, once in the morning.

The case for not buying anything

Be honest about who this is not for, because most people reading this should just use free material:

  • If you need marked essays from a human, a kit is the wrong product. Buy a tutor's time or an official marking service; a self-scoring grid grades structure, not your English.
  • If you have never done a full timed test, do that first. You do not need a system to discover that you are slow.
  • If you are already at your target band, stop practising and go book the test.
  • If you will not open a spreadsheet twice a week, the log is dead weight. The plan in the kit only works if the score log gets filled in.
  • If you want video lessons, pronunciation coaching or speaking practice with feedback, this is eight files in a zip, not a course.

What is actually inside the kit

Eight study files and a README, no app, no login, no subscription:

  • IELTS-Progress-Tracker.xlsx — the 8-week plan across four tabs, a score log where the overall band and gap-to-target calculate themselves with the official rounding rule, and a stand-alone band calculator for converting four module scores.
  • IELTS-Answer-Sheet.xlsx — printable A4 answer sheet, Listening Q1–40 on page one and Reading Q1–40 on page two, with a notes column for flagging guesses.
  • Spelling-Drill-Tracker.xlsx — 40-word master list with new / daily / perfected statuses, a daily list that rebuilds itself, a test log, and a re-test tab for relapsed words.
  • Writing-Templates.xlsx — Task 1 and Task 2 scaffolds built as slot prompts rather than model answers to memorise, a linking-phrase bank, and a self-scoring grid mapped to the summarised public band descriptors.
  • Trap-Analysis-Checklist.pdf — the trap catalogue with original self-drills, to be worked through and cross-referenced against score-log notes.
  • Spelling-Drill-Sheets.pdf — 40-word dictation pack, so the same words are drilled by ear, not by eye.
  • Test-Day-Checklist.pdf — IELTS and DET exam-day checklists, including platform setup and room scan.
  • Band-Descriptor-Reference.pdf — writing and speaking descriptors for bands 5 to 9, summarised from the public scoring guides; read the band you got and the one above it, and that gap is the revision target.

All study material is written from scratch; band descriptors are paraphrased from the official public guides and never reproduced. It is not affiliated with, endorsed by, or connected to IELTS, the British Council, IDP, Cambridge, or Duolingo. IELTS is a registered trademark of its owners.

Price and how to get it

During the launch the whole kit is $1.00 USD on Gumroad — the price on the listing at the time of writing, checked on the live page before this post went out:

https://nandminc.gumroad.com/l/ielts-det-prep-kit

Questions about printing, a broken formula, or whether a tab fits your test date: email nandminc2020@gmail.com and I answer them.

Commission disclosure: this kit is my own product. I built it, I sell it on Gumroad, and I receive the payment directly. The link above is a direct product link, not a third-party affiliate link, and I earn the sale price whether you read this post or find the listing yourself. Treat this as a biased walkthrough of the mechanics, not a review.

Honest limitations. Example figures are illustrative planning inputs — not market rates and not earnings. No legal, tax, insurance, licensing, veterinary, automotive-repair, or financial advice. No claims of CRM/map/API/invoicing integrations the bundle does not ship. Nothing here guarantees a band score; a study system can only make practice legible, not fast.

Comments