> For the complete documentation index, see [llms.txt](https://tech.annelaurefreant.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.annelaurefreant.xyz/blog/start-here.md).

# Start here!

Welcome to my blog :clap:

I mostly write about books I enjoy about computing history, software and technology. I also share insights about technical writing topics from my daily experiences.

### About API docs

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-type="content-ref"></th><th data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td></td><td></td><td></td><td></td><td><a href="/blog/documenting-api-endpoint-deprecation-the-art-of-planning-ahead.md">Documenting API Endpoint Deprecation: the Art of Planning Ahead</a></td><td><a href="https://1927154691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2G8aJzbljMW78Ww5LCLV%2Fuploads%2Fbu2EVFelW6L9k6WPextL%2F286172992_3152781278318259_2424264415156584217_n.jpg?alt=media&amp;token=c2e6f705-01ba-4943-9230-242ec1b31ad9">286172992_3152781278318259_2424264415156584217_n.jpg</a></td></tr><tr><td></td><td></td><td></td><td><a href="/blog/readme-refactored-a-peek-at-the-new-features-for-documenting-apis-in-2025.md">&quot;Readme Refactored&quot;: A Peek at the New Features for Documenting APIs in 2025</a></td><td></td><td><a href="https://1927154691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2G8aJzbljMW78Ww5LCLV%2Fuploads%2FZy48N5j3Ko53okjYgK8k%2Fpopper.gif?alt=media&amp;token=8f2bc584-e8db-4817-9eda-6ae2e8e82155">popper.gif</a></td></tr></tbody></table>

### About books

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td></td><td><a href="/blog/close-to-the-machine-how-ellen-ullmans-books-inspired-me-as-a-technical-writer.md">&quot;Close to the Machine&quot;: How Ellen Ullman's books inspired me as a (technical) writer</a></td><td><a href="https://1927154691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2G8aJzbljMW78Ww5LCLV%2Fuploads%2FBjXwHWfjQsQoqOvqE5mB%2Flifeincode.jpg?alt=media&amp;token=271a6ecf-65c2-410e-88d7-14dfcbef1901">lifeincode.jpg</a></td></tr><tr><td></td><td><a href="/blog/you-are-not-expected-to-understand-this-26-stories-telling-the-history-of-code.md">&quot;You Are Not Expected to Understand This&quot; - 26 Stories Telling the History of Code</a></td><td><a href="https://1927154691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2G8aJzbljMW78Ww5LCLV%2Fuploads%2Fve28ggMdlW7HOLDUF2Hy%2Fyouarenotexpected.jpg?alt=media&amp;token=4797e727-be36-45c2-b7b1-5924538347c3">youarenotexpected.jpg</a></td></tr></tbody></table>