Technical Writing Portfolio
Published Books
Review copies in PDF format are availble upon request. Links below are to websites with links to samples you can download on your own.
Sustainable Dev Environments with Docker and Bash
Build a Stable and Maintainable Place to Code
- Released: Apr 2024
- Publisher: Self
- Length: 70 pages
- Style: Expert Tutorial with Sample App and Code; neutral opinions
- Website: https://devbox.computer
Ruby on Rails Background Jobs with Sidekiq
Run Code Later without Complicating Your App
- Released: Oct 2023
- Publisher: Pragmatic Programmers
- Length: 70 pages
- Style: Expert Tutorial with Sample App and Code; neutral opinions
- Website: https://sidekiqrails.com
Sustainable Web Development with Ruby on Rails
Practical Tips for Building Web Applications that Last
- Released: Jan 2020
- Publisher: Self
- Length: 470 pages
- Style: Intermediate Tips with Running Example; moderately opinionated
- Website: https://sustainable-rails.com
Technical Documentation
Note: I have written many pages of documentation for companies I've worked for that is closed source and I cannot access or release. This is has covered tutorials, API documentation, project plans, HOWTOs and more. It covers a wide variety of tools such as Ruby, Rails, Java, JavaScript, Docker, and proprietary systems.
MelangeCSS
Utility-based CSS framework
- Contribution: Wrote all documentation and code.
- Period: 2023–
- Link: melangecss.com
- Notes: Documentation is written in a combination of HTML and information extracted from the code itself
Stitches RubyGem
Rails library for creating RESTful API-only microservices
- Contribution: Wrote draft of Wiki documentation and Project README. Current status appears very close to my original draft.
- Period: 2015–2019
- Link: github.com/stitchfix/stitches/wiki
- Link: github.com/stitchfix/stitches/blob/main/README.md
Blog Posts / Web Links
Getting Save to Home Screen to Work on iOS
Short technical tutorial on progressive web apps and iOS
- Contribution: Wrote everything
- Period: 2023
- Style: Short Tutorial w/ Code
- Link: blog/2023/08/24/braindump-of-pwa-on-ios.html
- Contribution: Wrote everything
- Period: 2023
- Style: Short Tutorial w/ Code
- Link: blog/2023/08/24/braindump-of-pwa-on-ios.html
Brutalist Web Design
- Contribution: Wrote everything
- Period: 2018–
- Style: Opinion
- Link: brutalist-web.design
Picard Sidekiq Tip: Split Up Independant Operations
Blog post about managing background processing
- Contribution:Wrote all.
- Period: 2024
- Style: Technical deep dive with diagrams and code
- Link: blog/2023/12/20/picard-sidekiq-tip-split-up-independant-operations.html
Names Matter
Blog post about naming and its impact on the wider world outside tech
- Contribution:Wrote all.
- Period: 2020
- Style: Opinion and Analysis
- Link: blog/2020/06/11/names-matter.html