I updated the Fileman Programmers manual with the VA VDL PDF using AI

[Sam Habiel]

https://www.hardhats.org/fileman/pm/index.html

A quick history:

I have been responsible for updating the hardhats.org documentation over the last decade. The VA used to have people working on this, so it was easy to just pull the documentation in. But they don't anymore (too expensive probably). I updated it now and then manually, but the process of writing HTML from scratch is quite laborious, and takes way too long. The DMU functionality is a giant entire chapter, so it was impossible for me to actually author that much HTML.

With how amazing AI was with documentation and summarizing, I thought that I may give this a shot. I am using Claude Code. The results were astonishing. What would have take me 6 months (probably more... I would be bored to death) was done in about 10 hours. What was by and large monetarily unfeasible is now possible.

I do want to emphasize the large amount of mistakes it made. Yes, I audited every single page it touched, to make sure it doesn't make any mistakes. What's funny is that the mistakes it makes are the same as the ones humans make. Forgetting that it did something, or forgetting what it did before when it has been a few days ago, or not being consistent in style. One mistake was quite amusing: it make a link to a wrong section, because the PDF has a link to the wrong section.

I asked it to generate a summary. Again, they can be quite dumb, so I had to correct it twice before it gave me a summary which I considered accurate. Here's it is. AI generated:

The HTML edition of the VA FileMan 22.2 Programmer Manual at hardhats.org has been brought fully up to date with the PDF. The headline news is two **brand-new chapters** that did not exist in the V.22.0 manual: the **Data Access Control (DAC) API** (Chapter 10), which documents the field-level read/write/delete-access hooks, and the **Data Mapping Utility (DMU)**, which describes the ENTITY (#1.5) file and the table-driven mechanism for emitting XML/JSON from VistA data against models such as HL7, FHIR, and InterSystems SDA. Several other 22.2-specific additions are now documented in full: the **Universal Time Conversion (UTC) API** (Ch 9), the **Metadata Dictionary (MDD) API** (Ch 14), **BUILDNEW^DIBTED** (Ch 15), **^DIKCBLD** (cross-reference builder), **LANG^DIALOGZ**, **EN^DITP** (the Repointer), and the **new 22.2 data types**. Content that is new in or specific to V.22.2 is marked with a yellow `22.2` badge throughout the manual, and the title page now explains what the badge means.

Beyond the new material, every existing chapter has been re-synced page-by-page against the 22.2 PDF. That covers Chapters 1–8 (front matter, Classic VA FileMan API, DBS API, ScreenMan forms/editor/API, Auditing, Browser), Chapters 18–26 (`^DI`, Global File Structure, Advanced File Definition, Trigger Cross-References, the DIALOG file, creating VA FileMan functions, and DIFROM), and Appendix A (Error Codes — all 91 codes verified against the PDF, with stale "new in V.22.0" markers retired). The Glossary was rebuilt from 44 to 126 terms to match the PDF, and both the main Index and the API Index were regenerated, including new entries for the DDMOD, DIALOGZ, and DIKCBLD families.

A consistency pass across the whole manual makes the CSS, header images, and footer styling uniform from page to page, removes the broken VA / OI / HSD&D site-map footer block that pointed at links that have been dead for years, and replaces remaining `vista.med.va.gov` URLs with `hardhats.org`. The user-facing effect is simply that the manual now looks the same on every page. Source, feedback, and pull requests welcome at **github.com/shabiel/FM-HTML-Documentation**.

--Sam

[Kimball Bighorse]

Thanks, Sam!

[Joel]

Impressive.  Thanks, Sam.

[jordan lenchitz]

lovely work, cheers and thanks!

--
--
http://groups.google.com/group/Hardhats
To unsubscribe, send email to Hardhats+u...@googlegroups.com

---
You received this message because you are subscribed to the Google Groups "Hardhats" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hardhats+u...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/hardhats/55d7df1b-9fbf-4c5b-bfc2-ec38909189adn%40googlegroups.com.

[Nancy Anthracite]

Wonderful, Sam, thank you!  I assume you kept a backup!

--

Nancy Anthracite

[Sam Habiel]

Git = old copy in case I need to go back. I did zip the old content just in case I made a mistake when deploying.

--Sam

[Nancy Anthracite]

I knew it was stupid to ask!

--

Nancy Anthracite