{"course":{"slug":"ai-careers","title":"Working in AI","url":"https://addaly.com/learn/ai-careers","level":"beginner","track":"work"},"lesson":{"slug":"writing-in-public","title":"Publishing, and the inbound it creates","url":"https://addaly.com/learn/ai-careers/writing-in-public","position":37,"of":85,"minutes":9,"answer":"Published writing works because it is found by strangers months later, which rewards narrow, specific answers to real problems over broad guides written from a week's knowledge.","keyIdea":"Published writing works because it is found by strangers months later, which rewards narrow, specific answers to real problems over broad guides written from a week's knowledge."},"body":{"format":"markdown","text":"## The asymmetry\n\nWriting to strangers is linear: one message, one chance. Publishing is not. A page you wrote in March is read in September by somebody you have never heard of who is hiring, and you did no work in September.\n\nThat is the entire mechanism, and it is worth being precise about it rather than mystical. Two things bring the reader: a search engine or a model answering a question you happened to have written the answer to, and a person forwarding your link to somebody else. Both reward the same thing: writing that is specific enough to be the best available answer to a narrow question.\n\n## What to write, in order of return\n\n**1. The thing that just took you two days.** You spent nine hours on a Docker networking error, an obscure `dbt` incremental bug, a Hindi tokenisation problem. Write it up the following morning while you still remember the wrong turns. This is the highest-value writing on the internet and almost nobody does it, because once you have solved it, it feels obvious. It is not obvious. It was not obvious to you on Monday.\n\n**2. A comparison with numbers.** \"I ran the same 200-row extraction task through four approaches; here is the accuracy, the cost per thousand documents and the latency.\" Anybody can have an opinion. Almost nobody has run the test.\n\n**3. A decision record.** The case-study format from the evidence module, published. What you were trying to do, what you rejected, what the number was.\n\n**4. Notes on something you are learning.** Weakest, but not worthless, provided you write as a learner rather than as an authority. \"Three things that confused me about embeddings, and what finally made them click\" is honest and useful. \"The Ultimate Guide to Embeddings\", written by somebody who learned them last week, is neither.\n\n## The shape that gets read\n\n- **Title it as the question somebody would type.** \"Why my dbt incremental model silently dropped rows after a schema change\" is a title. \"Data Engineering Lessons\" is not.\n- **Answer in the first paragraph.** Readers who need the answer will take it and go. That is a success, not a theft; they will remember where they got it.\n- **Show the error text, the command and the version numbers.** These are what search finds and what makes the page credible.\n- **Say what you are unsure about.** A sentence admitting a limit does more for a reader's trust than three paragraphs of confidence.\n- **Length is whatever the thing needs.** Six hundred honest words beat three thousand padded ones, and the padding is visible.\n\n## Where, and at what cost\n\nYour own site first, because links you own accrue to you and a platform can disappear or paywall you. Free hosting on GitHub Pages, Cloudflare Pages or Netlify; free static generators: Hugo, Eleventy, Quarto, or plain HTML. Then cross-post where the readers are, with a link back: Dev.to, Medium, Hashnode, LinkedIn, Reddit's topic communities, Hacker News occasionally. On LinkedIn, paste the text into the post itself rather than posting a bare link, because the feed suppresses outbound links and a post nobody sees helps nobody.\n\n## The limitation, stated plainly\n\nMost posts are read by about forty people. Many are read by four. The compounding is real but slow and unreliable: a fair expectation is six to twelve months of monthly writing before anything traceable happens, and a substantial number of people write for a year and get nothing but the writing itself.\n\nThat should change what you optimise for. Write things that are useful to *you* in six months (your own notes, findable) and treat the inbound as the second-order effect it is. People who write for the audience quit at post four. People who write to remember things keep going, and the audience arrives later.\n\n## One rule with teeth\n\nNever publish your employer's data, code, incident details or customer names, and be careful with anything under an agreement. Write about the method, the tool, the general problem. This is not a formality: it is the one way that public writing can cost you a career rather than build one."},"check":{"question":"Which of these posts is most likely to bring a stranger to a writer's profile six months after publication?","options":[{"text":"\"A Complete Introduction to Large Language Models\", written after finishing a course on the subject.","correct":false,"tempting":"Competes with thousands of near-identical broad guides on a topic where the writer holds no advantage, so nothing directs a searcher to it."},{"text":"\"Why my dbt incremental model silently dropped 12,000 rows after an upstream schema change\", including the error output and the fix.","correct":true},{"text":"\"Ten lessons from my first year learning data engineering\", a reflective personal essay.","correct":false,"tempting":"Reads well for people who already follow the writer, but answers no question anybody types into a search box."},{"text":"\"The future of AI jobs in 2027\", an opinion piece designed to be shared widely.","correct":false,"tempting":"Optimises for a burst of attention that decays in days, rather than for being the answer to a recurring question."}]},"prev":{"slug":"writing-to-strangers","title":"Writing to strangers, and what to say","url":"https://addaly.com/learn/ai-careers/writing-to-strangers"},"next":{"slug":"open-source-as-a-door","title":"A merged pull request as evidence","url":"https://addaly.com/learn/ai-careers/open-source-as-a-door"},"authorship":"Founder and series editor: Dr Mustafa Mun. Written by AI models to a written standard. Exam keys checked blind by a second model: 3,665 of 3,666 agreed. Academic review invited.","review":{"status":"Draft, open for academic review"},"cite":"Addaly (2026) 'Publishing, and the inbound it creates', in Working in AI. Edited by M. Mun. Addaly. Available at: https://addaly.com/learn/ai-careers/writing-in-public (Accessed: 13 October 2026).","licence":{"name":"CC BY-NC-SA 4.0","url":"https://creativecommons.org/licenses/by-nc-sa/4.0/"},"reader":{"schema":1,"title":"Publishing, and the inbound it creates","courseTitle":"Working in AI","module":{"index":4,"slug":"getting-seen","title":"Getting seen: the routes that put a person in front of your work"},"answer":null,"keyIdea":"Published writing works because it is found by strangers months later, which rewards narrow, specific answers to real problems over broad guides written from a week’s knowledge.","hero":{"kind":"plate","image":null,"alt":null,"caption":null},"blocks":[{"t":"h2","id":"the-asymmetry","runs":[{"text":"The asymmetry"}]},{"t":"p","runs":[{"text":"Writing to strangers is linear: one message, one chance. Publishing is not. A page you wrote in March is read in September by somebody you have never heard of who is hiring, and you did no work in September."}]},{"t":"p","runs":[{"text":"That is the entire mechanism, and it is worth being precise about it rather than mystical. Two things bring the reader: a search engine or a model answering a question you happened to have written the answer to, and a person forwarding your link to somebody else. Both reward the same thing: writing that is specific enough to be the best available answer to a narrow question."}]},{"t":"h2","id":"what-to-write-in-order-of-return","runs":[{"text":"What to write, in order of return"}]},{"t":"p","runs":[{"text":"1. The thing that just took you two days.","b":true},{"text":" You spent nine hours on a Docker networking error, an obscure "},{"text":"dbt","code":true},{"text":" incremental bug, a Hindi tokenisation problem. Write it up the following morning while you still remember the wrong turns. This is the highest-value writing on the internet and almost nobody does it, because once you have solved it, it feels obvious. It is not obvious. It was not obvious to you on Monday."}]},{"t":"p","runs":[{"text":"2. A comparison with numbers.","b":true},{"text":" “I ran the same 200-row extraction task through four approaches; here is the accuracy, the cost per thousand documents and the latency.” Anybody can have an opinion. Almost nobody has run the test."}]},{"t":"p","runs":[{"text":"3. A decision record.","b":true},{"text":" The case-study format from the evidence module, published. What you were trying to do, what you rejected, what the number was."}]},{"t":"p","runs":[{"text":"4. Notes on something you are learning.","b":true},{"text":" Weakest, but not worthless, provided you write as a learner rather than as an authority. “Three things that confused me about embeddings, and what finally made them click” is honest and useful. “The Ultimate Guide to Embeddings”, written by somebody who learned them last week, is neither."}]},{"t":"h2","id":"the-shape-that-gets-read","runs":[{"text":"The shape that gets read"}]},{"t":"ul","items":[[{"text":"Title it as the question somebody would type.","b":true},{"text":" “Why my dbt incremental model silently dropped rows after a schema change” is a title. “Data Engineering Lessons” is not."}],[{"text":"Answer in the first paragraph.","b":true},{"text":" Readers who need the answer will take it and go. That is a success, not a theft; they will remember where they got it."}],[{"text":"Show the error text, the command and the version numbers.","b":true},{"text":" These are what search finds and what makes the page credible."}],[{"text":"Say what you are unsure about.","b":true},{"text":" A sentence admitting a limit does more for a reader’s trust than three paragraphs of confidence."}],[{"text":"Length is whatever the thing needs.","b":true},{"text":" Six hundred honest words beat three thousand padded ones, and the padding is visible."}]]},{"t":"h2","id":"where-and-at-what-cost","runs":[{"text":"Where, and at what cost"}]},{"t":"p","runs":[{"text":"Your own site first, because links you own accrue to you and a platform can disappear or paywall you. Free hosting on GitHub Pages, Cloudflare Pages or Netlify; free static generators: Hugo, Eleventy, Quarto, or plain HTML. Then cross-post where the readers are, with a link back: Dev.to, Medium, Hashnode, LinkedIn, Reddit’s topic communities, Hacker News occasionally. On LinkedIn, paste the text into the post itself rather than posting a bare link, because the feed suppresses outbound links and a post nobody sees helps nobody."}]},{"t":"h2","id":"the-limitation-stated-plainly","runs":[{"text":"The limitation, stated plainly"}],"role":"limit"},{"t":"p","runs":[{"text":"Most posts are read by about forty people. Many are read by four. The compounding is real but slow and unreliable: a fair expectation is six to twelve months of monthly writing before anything traceable happens, and a substantial number of people write for a year and get nothing but the writing itself."}]},{"t":"p","runs":[{"text":"That should change what you optimise for. Write things that are useful to "},{"text":"you","i":true},{"text":" in six months (your own notes, findable) and treat the inbound as the second-order effect it is. People who write for the audience quit at post four. People who write to remember things keep going, and the audience arrives later."}]},{"t":"h2","id":"one-rule-with-teeth","runs":[{"text":"One rule with teeth"}]},{"t":"p","runs":[{"text":"Never publish your employer’s data, code, incident details or customer names, and be careful with anything under an agreement. Write about the method, the tool, the general problem. This is not a formality: it is the one way that public writing can cost you a career rather than build one."}]}],"check":{"question":[{"text":"Which of these posts is most likely to bring a stranger to a writer’s profile six months after publication?"}],"options":[{"text":[{"text":"“A Complete Introduction to Large Language Models”, written after finishing a course on the subject."}],"correct":false,"tempting":[{"text":"Competes with thousands of near-identical broad guides on a topic where the writer holds no advantage, so nothing directs a searcher to it."}]},{"text":[{"text":"“Why my dbt incremental model silently dropped 12,000 rows after an upstream schema change”, including the error output and the fix."}],"correct":true,"tempting":null},{"text":[{"text":"“Ten lessons from my first year learning data engineering”, a reflective personal essay."}],"correct":false,"tempting":[{"text":"Reads well for people who already follow the writer, but answers no question anybody types into a search box."}]},{"text":[{"text":"“The future of AI jobs in 2027”, an opinion piece designed to be shared widely."}],"correct":false,"tempting":[{"text":"Optimises for a burst of attention that decays in days, rather than for being the answer to a recurring question."}]}],"order":[0,3,2,1],"why":null},"prev":{"slug":"writing-to-strangers","title":"Writing to strangers, and what to say","minutes":8},"next":{"slug":"open-source-as-a-door","title":"A merged pull request as evidence","minutes":9}}}