💾 Archived View for capsule.wetterberg.nu › 2021 › 2021-01-16-cfdocs.gmi captured on 2023-06-14 at 13:58:22. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2021-11-30)
-=-=-=-=-=-=-
I often have to consult the Cloud Formation resource docs at work, and they are pretty horrible to use. Infinite menus of resource names that provide no navigational aid whatsoever. Fortunately Amazon makes the underlying markdown data available in a git repo, so I'm free to build something that suits me better.
cfdocs converts the content to gemtext and indexes it in a bleve full text index. The UI, such as it is, is based off search and links to definitions.
The cfdocs instance that I host
This fits my use-case perfectly. I'm always looking for a specific resource, not browsing aimlessly. I want toi be able to load the docs; find a resource to read up on its properties, drill down into nested data stuctores, or check whether a straight !Ref will yield an ARN, name, or ID.
I originally planned to add some service/resource hierarchical awareness with navigation. But searching worked well enough for me to drop that for now.