Paper Arrow

  • Bookshelf 📚
    • A More Beautiful Question by Warren Berger
    • Better Small Talk
    • Co-Intelligence by Ethan Mollick
    • Duly Noted by Jorge Arango
    • Employment Is Dead by Deborah Perry Piscione and Josh Drean
    • How We Talk by N.J. Enfield
    • Job Moves by Ethan Bernstein, Michael B. Horn, Bob Moesta
    • More Than Words by John Warner
    • Revenge of the Tipping Point by Malcolm Gladwell
    • Slow Productivity by Cal Newport
    • Soundtracks
    • The Good Enough Job by Simone Stolzoff
    • The Microstress Effect by Rob Cross and Karen Dillon
    • Tiny Experiments by Anne-Laure Le Cunff
    • Your AI Roadmap by Dr. Joan Palmiter Bajorek
  • Knapsack 🗞️
    • Knapsack Issue 01: Into the Unknown
    • Knapsack Issue 02: The Liftoff Edition
    • Knapsack Issue 03: The Writing Exercise Edition
    • Knapsack Issue 04: The Answers to the Writing Exercise Edition
    • Knapsack Issue 05: The Mental Wellness Edition
    • Knapsack Issue 06: The Welcome 2022 Edition
    • Knapsack Issue 07: The Journey Resumes
    • Knapsack Issue 08: The Seventy-Percent Edition
    • Knapsack Issue 09: The Art of Showing Up Edition
  • news
    • Documentation for AI & Humans
    • Knapsack Redux
  • notes
    • 10-second relationships
    • 36 rules for writers by Umberto Eco
    • acedia
    • Adjectival hierarchy
    • Agentic AIs
    • Agentic AIs and technical writers
    • AI Personas
    • An intro to interstitial journaling
    • An Onion Chopper Analogy
    • anger superiority effect
    • attention residue
    • Avoid responsibility hoarding as a manager
    • build butterfly ideas 🦋
    • caitiff (n)
    • cardician (noun)
    • chyron (adjective)
    • co-intelligence
    • Connecting Future and Past Selfs
    • conversation machine
    • Crafting a personal learning curriculum for growth
    • Creating Your Personal Haystack with PKM
    • croggle (verb)
    • Designing ToCs
    • Do other planets have magnetic fields like our Earth?
    • Engage, don't show
    • Ethan Mollick's 4 principles
    • Expiring and Permanent Skills
    • Forced Task Superiority
    • friction log
    • good enough job
    • Graham island (Mediterranean Sea)
    • haecceity
    • hebdomadal (adjective)
    • Hill Charts
    • Hinge questions
    • How to use Google Fonts in SVG logos
    • ichi-go ichi-e
    • Jagged Frontier of AI
    • knowledge biome
    • knowledge garden
    • llms.txt
    • Losing well is the key to learning how to win
    • Mastering PKM
    • micro-mentorship
    • Modern for Wikipedia
    • Null Island
    • pandoc
    • personal mythology
    • personal user manual
    • pocket jury
    • segmentors and integrators
    • speech disfluency
    • spite buildings
    • story spine
    • The Agile Manifesto
    • The Allen Curve
    • The Kipling Method
    • The Parable of the Empty Boat đź›¶
    • the switch and dial model
    • The Turing Test
    • The what, why, how formula of technical writing
    • there will be bad days
    • Thoughts on Metrics
    • Thoughts on multi-layered calendars
    • using AI as an amanuenis
    • write for the smallest viable audience
    • zero-knowledge proof
  • paths
    • PKM path
    • Quotations
    • Strange New Words
  • Quotes đź’¬
    • 70% happy
    • a good writer
    • a psychological tip
    • apple pie from scratch
    • Eric Meyer on adoptedCallback() method
    • Explaining is a difficult art
    • giving away knowledge
    • graduate-today-uneducated-day-after
    • Hanlon's Razor
    • have a compost heap of ideas
    • ideas are a kaleidoscope
    • illusion of knowledge
    • In the beginner’s mind there are many possibilities
    • learning anything has several parts
    • never cease from exploration
    • never resent people for being happy
    • on remaining a beginner
    • same atoms as pine trees and galaxies
    • save or savour the world
    • there are always connections
    • We are expected to be brilliant every day at work.
    • we extend by strewing and weaving
  • thoughts
    • days like these
    • Executable Documentation
  • til
    • 2025-02-13
    • 2025-02-14
    • 2025-02-15
    • 2025-02-20
    • 2025-02-21
    • 2025-02-28
    • 2025-03-03
  • Colophon
  • Office Hours
  • Subscribe
🏠 Home

❯

Knapsack 🗞️

❯

Knapsack Issue 07: The Journey Resumes

Knapsack Issue 07: The Journey Resumes

Mar 27, 2025

Welcome to Knapsack đź‘‹

Hello again,

Last week, I gave a talk on the challenges of writing documentation for both humans and AI. As I reflected on it, I realized that this isn’t just about documentation—it’s about how we shape communication for different audiences, be it people or machines.

When I started writing online, I assumed my words would only reach other humans. Now, AI systems are parsing, summarizing, and even making decisions based on documentation. This shift raises fascinating questions: How do we write so both humans and AI understand? How do we ensure meaning isn’t lost in translation?

These are some of the ideas explored in this issue. We also have a book on AI careers, a curious new word about solitude, and a question to ponder.

If you enjoy this issue, share it with a friend, or better yet, reply and let me know what you think.

Let’s dive in.


🗣️Deep Dive: Writing Documentation for AI and Humans

Documentation for AI & Humans

I recently presented a talk, â€śDocumentation for AI and Humans: Writing for AI and Human readers,” which focused on the evolving landscape of technical communication in the age of AI.

Key takeaways from the talk:

  • The Rise of AI Agents: AI systems, particularly AI agents, are increasingly consuming and acting on technical documentation.
  • Human vs. AI Processing: Humans and AI process information differently, which has profound implications for documentation.
  • Dual-Audience Strategies: How to write documentation that serves both humans and AI effectively.
  • The Future of Documentation: The role of the technical writer is changing—what does that mean for the industry?

If this piques your interest, you can find more details in my âžˇď¸Ź LinkedIn post about the session.

Link to original


📚 Book Bites: Your AI Roadmap by Joan Palmiter Bajorek

“Your AI Roadmap” serves as a modern blueprint for navigating careers and income in the age of AI. Dr. Joan Palmiter Bajorek highlights the importance of human connections and a well-defined personal brand as essential tools for career growth, particularly in AI-driven fields.

The book provides concrete advice on:
âś… Leveraging LinkedIn to showcase expertise and connect with industry leaders
âś… Owning your professional story to stand out in a competitive job market
âś… Building financial resilience through multiple income streams and smart wealth-building strategies

Through personal anecdotes and actionable frameworks, Dr. Bajorek empowers readers to move beyond traditional job-centric thinking and take control of their professional and financial futures.

Why this book?
In an era where ai is reshaping industries, this book is a valuable guide to future-proofing your career. Whether you’re already in tech or looking to pivot, đź“— Your AI Roadmap offers practical steps to help you stay ahead.


🔍 Strange New Word: Isolophilia

I came across the word isolophilia while looking for background music to write to: 🎵 Isolophilia on YouTube.

đź“– Meaning: A strong affection for solitude and being alone.

While solitude is often seen as loneliness, isolophilia suggests a deep appreciation for being alone—not as isolation, but as a chosen state. It’s the joy of a quiet evening with a book, the comfort of an early morning walk before the world wakes up, or the satisfaction of working on a project uninterrupted.

Question

Do you identify with isolophilia? Or do you find energy in company?


🖼️ See What I See: Everyone is a Geek in Their Own Way

This issue’s image is a sketch from đź–Ľď¸Ź Sketchplanations: Geek.

It reminds me that everyone is a geek about something. Some geek out over the stars, others about sketching, languages, or even earthworms (which, by the way, are fascinating—Darwin once spent 39 years studying them 🤯.

Being a geek isn’t about a specific interest; it’s about curiosity and deep engagement.

Question

So, what’s something you geek out about?


🤔 Question to Ponder

đź’­ What is one skill or habit you wish you had started earlier?

We often look back and realize that certain small habits or skills—journaling, exercising, learning a language—would have made a huge impact if we had started earlier. But it’s never too late.

Question

What’s one thing you’d start today if you knew you’d stick with it?


That’s it for this issue! If you found something useful, share it with a friend. If you have thoughts or suggestions, just reply—I’d love to hear from you.

Till next time,
Xavier


Compass

This issue is part of Knapsack, a satchel of stories, wisdom, and wonder. You can explore past issues here.


  • topic/ai
  • Welcome to Knapsack đź‘‹
  • 🗣️Deep Dive: Writing Documentation for AI and Humans
  • 📚 Book Bites: Your AI Roadmap by Joan Palmiter Bajorek
  • 🔍 Strange New Word: Isolophilia
  • 🖼️ See What I See: Everyone is a Geek in Their Own Way
  • 🤔 Question to Ponder

Graph View

Backlinks

  • Knapsack Redux

Powered by Quartz v4.5.0 © 2025

  • Paper Arrow
  • 🏠 Home
  • 🧑🏾 Xavier
  • đź“„ Resume
  • 📢 RSS