{"id":11795,"date":"2026-11-09T22:30:00","date_gmt":"2026-11-09T22:30:00","guid":{"rendered":"https:\/\/www.cotocus.com\/blog\/?p=11795"},"modified":"2026-11-09T22:30:00","modified_gmt":"2026-11-09T22:30:00","slug":"faq-what-i-learned-this-week","status":"publish","type":"post","link":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/","title":{"rendered":"Questions Answered: Writing Up What You Learned This Week"},"content":{"rendered":"<p>Our training sessions keep producing the same question from people who have just finished a tricky topic: should I write about it now, or wait until I really know it? Our answer is nearly always &#8220;now&#8221;. A short &#8220;what I learned this week&#8221; write-up, composed before the puzzlement has faded, ranks among the most efficient study tools we know. Below are the questions we hear most, answered the way we would answer them over a cup of tea.<\/p>\n<h2>What exactly is a &#8220;what I learned this week&#8221; write-up?<\/h2>\n<p>It is a short, plain-language note explaining one thing you worked out recently, aimed at someone who has not worked it out yet. It is not a tutorial from an authority and not a diary of your whole week. One lesson, one reader, one page. Think of it as the note you wish someone had slipped under your door at the start of the confusion.<\/p>\n<h2>Why bother if I can just read the documentation again?<\/h2>\n<p>Re-reading documentation confirms that the words are familiar. Explaining a concept confirms that you can rebuild it. Try describing a pipeline stage or a deployment step to a beginner in plain words, and the difference shows within a minute: the places where you hesitate are the places you only half understood. The write-up works like a spot-check for your own mental model.<\/p>\n<h2>Do I need to be experienced to do this?<\/h2>\n<p>No, and being slightly ahead of your reader is actually an advantage. People who learned something yesterday still remember the misleading error message, the term nobody defined and the step the guide skipped. Veterans have lost those memories. If you are working through a roadmap such as our <a href=\"https:\/\/www.cotocus.com\/blog\/mlops-roadmap-a-complete-guide-for-data-scientists-and-engineering-teams\/\">stage-by-stage plan for machine learning delivery<\/a>, each stage you finish is a fresh topic that someone else is about to start.<\/p>\n<h2>How long should the note be?<\/h2>\n<p>Long enough to cover one idea and short enough to finish in a sitting. Roughly five to eight short paragraphs works for most technical topics. If you cannot stop writing, you probably have two posts. Split them and publish the second next week. A tight note also respects the reader, who is often reading on a phone between other jobs and wants one clean answer rather than a survey of the field.<\/p>\n<h2>What should I include?<\/h2>\n<ul>\n<li>The question or error that started it.<\/li>\n<li>What you believed before.<\/li>\n<li>What turned out to be true.<\/li>\n<li>A small example someone can try.<\/li>\n<li>One thing you are still unsure about.<\/li>\n<\/ul>\n<p>That last item surprises people, but a stated uncertainty makes the note more trustworthy, not less. It also tells a more experienced reader where a correction would be welcome.<\/p>\n<h2>Can I write about security or other sensitive subjects?<\/h2>\n<p>You can write about your understanding of the concepts, but never include real credentials, internal hostnames, client details or anything from a confidential environment. Use invented names and toy examples. For a gentle starting point on a security topic, our <a href=\"https:\/\/www.cotocus.com\/blog\/how-to-shift-security-left-in-software-development-a-beginners-guide\/\">beginner&#8217;s introduction to moving checks earlier in development<\/a> shows how a concept can be explained without exposing anything real.<\/p>\n<h2>What if someone points out a mistake?<\/h2>\n<p>Treat it as the second half of your lesson. A correction is an expert reviewing your thinking at no cost. Update the note, mention what changed and say thank you. Over time, your corrected posts become more reliable than the first drafts of people who never published anything at all.<\/p>\n<h2>Where can I publish it?<\/h2>\n<p>An internal wiki is a fine first stop. For a public home you control, <a href=\"https:\/\/myblogpad.com\/\">MyBlogPad<\/a> is a publishing network that describes itself as free, gives every blog a subdomain of its own, and has Discover and Latest pages where readers browse what others have written. Any platform you will actually keep using is the right one.<\/p>\n<h2>Should I write it as if I am teaching a class?<\/h2>\n<p>Please do not. Write the way you would talk to one curious friend across a table. Short sentences, concrete examples and the occasional admission of &#8220;this part confused me too&#8221; will carry a beginner much further than a lecture voice. Formal tone tends to hide uncertainty, and uncertainty is exactly what a fellow learner wants to see named.<\/p>\n<h2>How often should I do this?<\/h2>\n<p>Do it after anything that puzzled you for more than an hour. Some people manage one note a week; others write one a month. Frequency matters less than timing: the closer you write to the moment of understanding, the more of the confusion survives on the page, and confusion is what the next reader is carrying.<\/p>\n<h2>Will this really make me better at my job?<\/h2>\n<p>We have watched trainees go from vague answers in review sessions to crisp ones after a couple of months of this habit. The reason is mechanical. Each note is practice at stating a problem clearly, and clear problem statements are what incident calls, design discussions and interviews reward.<\/p>\n<h2>What is a simple template to start with?<\/h2>\n<ol>\n<li>Title: the question, in your own words.<\/li>\n<li>Opening: where you were stuck, in two sentences.<\/li>\n<li>Middle: the explanation you would give a friend, with one example.<\/li>\n<li>Close: what you still want to test, and how a reader can check your claim.<\/li>\n<\/ol>\n<p>If you have been putting this off, take the thing that frustrated you most this week and answer, in writing, the question a beginner would ask about it. Twenty minutes later you will know the topic better, and you will have something you can hand to the next person who asks.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Should you write it up now or wait until you are sure? Answers to the questions we hear most about explaining a fresh lesson to a beginner.<\/p>\n","protected":false},"author":37,"featured_media":11796,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[147],"tags":[],"class_list":["post-11795","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Questions Answered: Writing Up What You Learned This Week - Cotocus<\/title>\n<meta name=\"description\" content=\"FAQ on writing a short what-I-learned-this-week note: why explaining a new topic to a beginner finds your gaps fast, what to include and where to publish.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Questions Answered: Writing Up What You Learned This Week - Cotocus\" \/>\n<meta property=\"og:description\" content=\"FAQ on writing a short what-I-learned-this-week note: why explaining a new topic to a beginner finds your gaps fast, what to include and where to publish.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/\" \/>\n<meta property=\"og:site_name\" content=\"Cotocus\" \/>\n<meta property=\"article:published_time\" content=\"2026-11-09T22:30:00+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.cotocus.com\/blog\/wp-content\/uploads\/2026\/11\/b2a-banner-555052-banner.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Nikhil Farooqui\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Nikhil Farooqui\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/\"},\"author\":{\"name\":\"Nikhil Farooqui\",\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/#\\\/schema\\\/person\\\/419007bef27e8d85890550d783b96c50\"},\"headline\":\"Questions Answered: Writing Up What You Learned This Week\",\"datePublished\":\"2026-11-09T22:30:00+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/\"},\"wordCount\":928,\"commentCount\":0,\"image\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/b2a-banner-555052-banner.png\",\"articleSection\":[\"DevOps\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/\",\"url\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/\",\"name\":\"Questions Answered: Writing Up What You Learned This Week - Cotocus\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/b2a-banner-555052-banner.png\",\"datePublished\":\"2026-11-09T22:30:00+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/#\\\/schema\\\/person\\\/419007bef27e8d85890550d783b96c50\"},\"description\":\"FAQ on writing a short what-I-learned-this-week note: why explaining a new topic to a beginner finds your gaps fast, what to include and where to publish.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/b2a-banner-555052-banner.png\",\"contentUrl\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/b2a-banner-555052-banner.png\",\"width\":1200,\"height\":630},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/faq-what-i-learned-this-week\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Questions Answered: Writing Up What You Learned This Week\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/\",\"name\":\"Cotocus\",\"description\":\"Shaping Tomorrow\u2019s Tech Today\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/#\\\/schema\\\/person\\\/419007bef27e8d85890550d783b96c50\",\"name\":\"Nikhil Farooqui\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d855702dac00a5af0405bb329101be495718d611233e52c86fe360c8fca6f6dc?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d855702dac00a5af0405bb329101be495718d611233e52c86fe360c8fca6f6dc?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d855702dac00a5af0405bb329101be495718d611233e52c86fe360c8fca6f6dc?s=96&d=mm&r=g\",\"caption\":\"Nikhil Farooqui\"},\"url\":\"https:\\\/\\\/www.cotocus.com\\\/blog\\\/author\\\/nikhil-farooqui\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Questions Answered: Writing Up What You Learned This Week - Cotocus","description":"FAQ on writing a short what-I-learned-this-week note: why explaining a new topic to a beginner finds your gaps fast, what to include and where to publish.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/","og_locale":"en_US","og_type":"article","og_title":"Questions Answered: Writing Up What You Learned This Week - Cotocus","og_description":"FAQ on writing a short what-I-learned-this-week note: why explaining a new topic to a beginner finds your gaps fast, what to include and where to publish.","og_url":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/","og_site_name":"Cotocus","article_published_time":"2026-11-09T22:30:00+00:00","og_image":[{"width":1200,"height":630,"url":"https:\/\/www.cotocus.com\/blog\/wp-content\/uploads\/2026\/11\/b2a-banner-555052-banner.png","type":"image\/png"}],"author":"Nikhil Farooqui","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Nikhil Farooqui","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#article","isPartOf":{"@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/"},"author":{"name":"Nikhil Farooqui","@id":"https:\/\/www.cotocus.com\/blog\/#\/schema\/person\/419007bef27e8d85890550d783b96c50"},"headline":"Questions Answered: Writing Up What You Learned This Week","datePublished":"2026-11-09T22:30:00+00:00","mainEntityOfPage":{"@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/"},"wordCount":928,"commentCount":0,"image":{"@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#primaryimage"},"thumbnailUrl":"https:\/\/www.cotocus.com\/blog\/wp-content\/uploads\/2026\/11\/b2a-banner-555052-banner.png","articleSection":["DevOps"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/","url":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/","name":"Questions Answered: Writing Up What You Learned This Week - Cotocus","isPartOf":{"@id":"https:\/\/www.cotocus.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#primaryimage"},"image":{"@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#primaryimage"},"thumbnailUrl":"https:\/\/www.cotocus.com\/blog\/wp-content\/uploads\/2026\/11\/b2a-banner-555052-banner.png","datePublished":"2026-11-09T22:30:00+00:00","author":{"@id":"https:\/\/www.cotocus.com\/blog\/#\/schema\/person\/419007bef27e8d85890550d783b96c50"},"description":"FAQ on writing a short what-I-learned-this-week note: why explaining a new topic to a beginner finds your gaps fast, what to include and where to publish.","breadcrumb":{"@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#primaryimage","url":"https:\/\/www.cotocus.com\/blog\/wp-content\/uploads\/2026\/11\/b2a-banner-555052-banner.png","contentUrl":"https:\/\/www.cotocus.com\/blog\/wp-content\/uploads\/2026\/11\/b2a-banner-555052-banner.png","width":1200,"height":630},{"@type":"BreadcrumbList","@id":"https:\/\/www.cotocus.com\/blog\/faq-what-i-learned-this-week\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.cotocus.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Questions Answered: Writing Up What You Learned This Week"}]},{"@type":"WebSite","@id":"https:\/\/www.cotocus.com\/blog\/#website","url":"https:\/\/www.cotocus.com\/blog\/","name":"Cotocus","description":"Shaping Tomorrow\u2019s Tech Today","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.cotocus.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.cotocus.com\/blog\/#\/schema\/person\/419007bef27e8d85890550d783b96c50","name":"Nikhil Farooqui","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/d855702dac00a5af0405bb329101be495718d611233e52c86fe360c8fca6f6dc?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/d855702dac00a5af0405bb329101be495718d611233e52c86fe360c8fca6f6dc?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/d855702dac00a5af0405bb329101be495718d611233e52c86fe360c8fca6f6dc?s=96&d=mm&r=g","caption":"Nikhil Farooqui"},"url":"https:\/\/www.cotocus.com\/blog\/author\/nikhil-farooqui\/"}]}},"_links":{"self":[{"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/posts\/11795","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/users\/37"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/comments?post=11795"}],"version-history":[{"count":1,"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/posts\/11795\/revisions"}],"predecessor-version":[{"id":11861,"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/posts\/11795\/revisions\/11861"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/media\/11796"}],"wp:attachment":[{"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/media?parent=11795"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/categories?post=11795"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.cotocus.com\/blog\/wp-json\/wp\/v2\/tags?post=11795"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}