Writing Clear and Effective Training Manuals

Most people don’t actually struggle with learning. They struggle with 𝘵𝘩𝘪𝘯𝘬𝘪𝘯𝘨 𝘵𝘩𝘦𝘺 𝘶𝘯𝘥𝘦𝘳𝘴𝘵𝘢𝘯𝘥 𝘴𝘰𝘮𝘦𝘵𝘩𝘪𝘯𝘨 when they only recognize the words. That’s why I love this prompt. It turns ChatGPT or Claude into the kind of tutor that does more than hand you answers. It pushes you to 𝘦𝘹𝘱𝘭𝘢𝘪𝘯 𝘸𝘩𝘢𝘵 𝘺𝘰𝘶’𝘷𝘦 𝘭𝘦𝘢𝘳𝘯𝘦𝘥 𝘪𝘯 𝘺𝘰𝘶𝘳 𝘰𝘸𝘯 𝘸𝘰𝘳𝘥𝘴, the same way Richard Feynman believed real understanding works. Instead of memorizing facts, it helps you break ideas down simply, spot the parts that still feel fuzzy, and rebuild your understanding step by step until it clicks. By the end, you should be able to teach the concept to someone else clearly and confidently. That’s when you know you truly understand it. Here’s the full prompt: --- <System> You are a master explainer who channels Richard Feynman’s ability to break complex ideas into simple, intuitive truths. Your goal is to help the user understand any topic through analogy, questioning, and iterative refinement until they can teach it back confidently. </System> <Context> The user wants to deeply learn a topic using a step-by-step Feynman learning loop: • simplify • identify gaps • question assumptions • refine understanding • apply the concept • compress it into a teachable insight </Context> <Instructions>  1. Ask the user for:  • the topic they want to learn  • their current understanding level 2. Give a simple explanation with a clean analogy. 3. Highlight common confusion points. 4. Ask 3 to 5 targeted questions to reveal gaps. 5. Refine the explanation in 2 to 3 increasingly intuitive cycles. 6. Test understanding through application or teaching. 7. Create a final “teaching snapshot” that compresses the idea. </Instructions> <Constraints>  • Use analogies in every explanation  • No jargon early on  • Define any technical term simply  • Each refinement must be clearer  • Prioritize understanding over recall  </Constraints> <Output Format>  Step 1: Simple Explanation  Step 2: Confusion Check  Step 3: Refinement Cycles  Step 4: Understanding Challenge  Step 5: Teaching Snapshot  </Output Format> <User Input> “I’m ready. What topic do you want to master and how well do you understand it?” </User Input> Tools can give answers. Understanding comes when you can make the idea simple enough for someone else to grasp. That’s the difference between knowing about something and truly knowing it. P.S. ~ For more updates like this: 1. Scroll to the top 2. Click "View my newsletter" 3. Subscribe, and you'll never miss a thing in the world of AI ever again.

PhD Students - How to write the Introduction section of your paper? Introduction section is the make or break for your paper. It is where you must establish your point, or your paper might fail to fly. Here is how you can write a good introduction section. 𝟏. 𝐈𝐧𝐭𝐫𝐨𝐝𝐮𝐜𝐞 𝐲𝐨𝐮𝐫 𝐭𝐨𝐩𝐢𝐜 Start your introduction section by introducing the broader topic of the paper. Then slowly go into the details that why this topic is important. You need to bring some interesting facts and stats here to convince the reader that this paper is worth reading. 𝟐. 𝐃𝐞𝐬𝐜𝐫𝐢𝐛𝐞 𝐭𝐡𝐞 𝐛𝐚𝐜𝐤𝐠𝐫𝐨𝐮𝐧𝐝 After introducing the topic, now you need to briefly report what work has already been done on this topic. You can mention the most related 4-6 papers that covered this topic. These papers should not be discussed in as much detail as you discuss them in the related work section. The point here is to move the reader towards the gap statement i.e., what is missing in the existing literature. 𝟑. 𝐄𝐬𝐭𝐚𝐛𝐥𝐢𝐬𝐡 𝐲𝐨𝐮𝐫 𝐫𝐞𝐬𝐞𝐚𝐫𝐜𝐡 𝐩𝐫𝐨𝐛𝐥𝐞𝐦 After discussing the existing work, you should clearly state what is the crisp problem being addressed in this paper. You have to make sure that the research problem is directly connected to the background section reported in the previous part. 𝟒. 𝐂𝐥𝐞𝐚𝐫𝐥𝐲 𝐬𝐭𝐚𝐭𝐞 𝐲𝐨𝐮𝐫 𝐨𝐛𝐣𝐞𝐜𝐭𝐢𝐯𝐞𝐬 Once the overall research problem is established, now you need to go into a bit more specifics. This you will do via presenting your objectives. Now objectives can be specified in two ways - a thesis statement or research questions. You can present this part in bold or italics so that it can be easily focused by the reader. 𝟓. 𝐁𝐫𝐢𝐞𝐟𝐥𝐲 𝐫𝐞𝐩𝐨𝐫𝐭 𝐲𝐨𝐮𝐫 𝐦𝐞𝐭𝐡𝐨𝐝𝐨𝐥𝐨𝐠𝐲 Now the reader knows what exactly has been done in this research. So, here you tell the reader how this research has been carried out. You don't need to go full scale but in a shorter form, report what methodology has been used to conduct this research. 𝟔. 𝐏𝐫𝐞𝐬𝐞𝐧𝐭 𝐭𝐡𝐞 𝐨𝐮𝐭𝐥𝐢𝐧𝐞 𝐨𝐟 𝐭𝐡𝐞 𝐩𝐚𝐩𝐞𝐫 In this final part, you should tell the reader what they should expect in the rest of the paper. This means how the rest of the paper has been structured i.e., what are the different sections and what is in each section. Some researchers also present contributions before the outline of the paper. 𝑆𝑜𝑚𝑒 𝑔𝑒𝑛𝑒𝑟𝑎𝑙 𝑡𝑖𝑝𝑠 1) Use solid references to support your motivation. 2) Do not make big claims that your results can't support. 3) Avoid complexity, explain in simple terms. 4) Keep its flow like a story. Avoid abrupt jumps. 5) Avoid typos at any cost in the introduction section. PS: There are many styles for writing introduction section, which varies across domains. This is just one of them. Anything you'd like to add? #research #phd

My paper was rejected 7 times. Here's how to fix the one thing that's killing your acceptance rate - your introduction: Seven rejections. Same research. Same data. Same groundbreaking conclusions. But every reviewer said the same thing: "The introduction fails to engage." That feedback destroyed me. I spent 3 years on that research. And reviewers weren't even reading past page 1. Here's what I discovered: Academic introductions aren't about being "scholarly." They're about making reviewers CARE. I rebuilt my introduction using this 7-step framework: 1. Importance Hook → Start with global impact, not your study → "Climate change threatens 1 billion coastal residents" → NOT "This study investigates coastal vulnerability" 2. Background Context → Show existing work WITHOUT listing every paper → Create a narrative, not a bibliography **3. Problem Statement** → Make the gap feel urgent → "But nobody has studied X in context Y" 4. Research Gap Revelation → Your "aha" moment for readers → "This missing piece changes everything" 5. Evidence Foundation → Back your claims with data → Prove this isn't just your opinion 6. Local Context Connection → Make abstract research tangible → "This affects real communities, real people" 7. Study Objectives Bridge → Connect everything to your specific aims → "Here's exactly what we'll achieve" I rewrote my introduction following this framework. Submission #8: Accepted by a top-tier journal. Reviewer comments: "Compelling introduction that clearly establishes significance." Same research. Different introduction. Different outcome. Your brilliant work deserves to be read. Not rejected because of a weak first page. Which of these 7 steps is hardest for you right now? Tell me in the comments. I'll share specific examples from my accepted papers. #AcademicWriting #ResearchTips #PhDLife #AcademicSuccess #PublishOrPerish

When we develop ontologies, we’re carefully crafting taxonomies, relationships and hierarchies. This is knowledge engineering. But at a deeper level, as we start to blend ontologies into AI, we’re also doing something mathematically elegant: we’re projecting high-dimensional data into a lower-dimensional conceptual space, much like dimensionality-reduction techniques in linear algebra. We’re factorising data. 🔵 What Do I Mean by Factorisation? In linear algebra or machine learning, factorisation is the process of breaking down a complex system into a set of simpler, lower-dimensional components. It’s how we go from messy, high-dimensional data to something more structured and usable - for instance, latent features in a matrix factorisation model. Ontology achieves a similar compression, but through abstraction and discretisation rather than algebraic multiplication. The first step is deciding what matters. What are the meaningful concepts we care about? What should we be paying attention to? This act of naming - of defining ontological classes - is not just descriptive. It’s selective. It’s a cognitive filter. Once you’ve made those choices, you’re effectively projecting the chaotic surface of your data onto a smaller, more meaningful subspace - a conceptual lens. This is your factorised view of the world. 🔵 Ontological Classes as Features Let’s say you’re working in tax law, healthcare, or finance. The raw data is sprawling - case notes, transaction logs, guidance manuals, APIs, spreadsheets. But once you define your ontological classes - Travel Expense, Employee, Business Purpose, or Diagnosis - you begin to compress that data into a smaller set of dimensions. These aren’t just labels. They’re axes of interpretation. Your AI models now have something to hook into. Your data pipelines know what to extract, link, store and serve. You’ve constrained the entropy of your system, not by discarding information, but by organising it around meaning. 🔵 Why This Matters for AI LLMs are famously good at handling unstructured data. But their real potential shines when they’re coupled with structure, especially when that structure reflects your domain’s core distinctions. A well-designed ontology acts as a kind of “feature engineering” for knowledge-centric AI. You’ve defined priors for your latent variables. You’ve chosen which concepts should anchor your interpretation, and you’ve factorised your data accordingly. The result? Faster iteration, more explainable results, and a far more coherent internal representation of your domain. 🔵 The Takeaway Ontology isn’t just a documentation exercise or a knowledge management tool. It’s a strategic, high-leverage move in the data pipeline. When done well, it’s a way of compressing meaning, factorising chaos, and bringing clarity to your AI efforts. If you’re serious about data-driven systems - especially those that aim to be intelligent - then ontology is not optional. It’s your starting point.

🎨🖊️ "Draw two circles under a rectangle…" "Now, make the circles connect to the rectangle" - some of the instructions that were given to me by our Head of Architecture during a recent offsite. We engaged in an exercise that underscored the importance of clear and effective communication. Each participant paired up, with one partner facing a screen displaying an image and the other facing a blank wall with a pen and paper. The challenge? The partner facing the screen had to guide their teammate in drawing the image using only directional and descriptive language. This exercise was a powerful reminder of how crucial it is to be clear, descriptive and thoughtful when sharing requirements, feedback or instructions. In the world of technology, we often fall into the trap of using complex language, acronyms, and omitting details we assume are "obvious." This can lead to confusion, misunderstandings, rework, and ultimately, wasted time. The key takeaway? Being specific doesn't always mean being overly detailed or long-winded. There's a beautiful balance between being specific and descriptive. It's about conveying the right amount of information in a way that's easily understood. Here are some common pitfalls to avoid when striving for specificity in communication: - Overloading with Details: Focus on the most relevant information to avoid overwhelming your audience. - Using Jargon and Acronyms: Consider your audience and provide explanations when necessary. - Assuming Shared Knowledge: Provide necessary context to ensure understanding. - Being Vague: Use precise language to prevent misunderstandings. - Neglecting the Audience's Perspective: Tailor your communication to the needs and understanding of your audience. I am reminded of a quote by Mark Twain: "I apologize for such a long letter - I didn't have time to write a short one." Concise communication takes time and effort, but it's always worth it. In our fast-paced world, mastering the art of effective communication is essential. It not only enhances collaboration but also drives efficiency and innovation. #Communication #Leadership #EffectiveCommunication

Stop overcomplicating your content. You don’t need to make it harder than it is. People want simple, actionable advice they can implement right away. Here’s how to keep it straightforward: •Focus on one idea, not ten. •Break down complex concepts into bite-sized pieces. •Avoid jargon and technical terms. •Use examples to make your point clearer. •Give actionable takeaways that are easy to follow. Your content doesn’t have to be a deep dive to be valuable. The simpler it is, the more people will understand—and act on—it. Overcomplicating content only makes it harder for your audience to engage. So, keep it simple, practical, and easy to digest. That’s how you create content that connects.

Most DeepTech founders either dumb down their science (lose credibility) or write academic papers (lose readers). To avoid this trap, here's my 5-step roadmap on how to explain complex tech without compromise: Step 1: The "Technical Sandwich" Method. To master this: → Start with a simple outcome ("We reduce ocean plastic by 40%") → Layer in the technical mechanism ("using bio-enzymatic polymer chains") → Close with the human impact ("saving 2M marine animals annually") Start here, then move onto Step 2. Step 2: Choose your Precision Framework. Now you have two options: 1/ Analogies (quantum computing = library with infinite books in one space) 2/ Metrics (latency from 200ms to 3ms = Netflix vs buffering) There's no wrong answer, but you must decide. Step 3: Master two Core Communication Pillars. 1/ Simple Hooks. → 9 words or less in your opener → Lead with outcomes, not process → Use contrast ("$100K sensors vs our $4,900 buoy") Once you master this, focus on: 2/ Technical Credibility. → Drop one precise term per paragraph → Link to peer-reviewed sources → Show the math when it matters Step 4: Know when to embrace complexity. Most founders oversimplify everything. Your audience is smarter than you think. Here are your options: → Technical founders? Go deeper on mechanism → Investors? Show the physics constraint you solved → General audience? Keep the complexity in comments The key is matching depth to reader expertise. Step 5: The credibility check. This final step is how you: → Validate claims with independent sources → Show real deployment numbers → Name the institutions backing you Do this and you can unlock both reach and respect. It's as easy as that. — What's the hardest technical concept you've had to explain in plain English? PS. I've ghostwritten for 10+ climate tech founders. The ones who balance simplicity with precision get 10x the engagement.

"Remove all throat clearing." Great advice for anyone who writes legal texts in English. But... If English is not your mother tongue, you might not know what that means. Or, if you know what it means, you might not know what tangible steps you can take to remove throat clearing from your writing in English. So let's break it down. 🔍 First, what is throat clearing in legal writing? It's the unnecessary introduction or inclusion of prefatory material that doesn't add value to your argument or analysis. In plain English, it’s using a lot of unnecessary words before getting to the point. Why should you avoid it? 👉 It can make your writing vague. 👉 It often includes generic background information that your reader doesn't need to know (while obscuring important information that your reader might need instead). 👉 It sometimes relies on overly broad generalizations that weaken your argument. 🧠 What do you need to know about legal English to know how to remove throat clearing from your writing? 👉 Legal English typically uses fewer words than its counterparts in other languages, like Romance languages. So very long sentences are hard to follow. 👉 Even though legal English is more formal than ordinary English, you don't need to use long-winded phrases to introduce new ideas or connect previous ideas in your writing. We use pointing words, conjunctions, and other linguistic tools for that instead. 👉 Legal English prioritizes clarity and precision, meaning every word should serve a specific purpose. What can you do to remove throat clearing when English is not your mother tongue? 👉 Start with the Main Point: Begin your paragraphs and sentences with the core idea or argument. ❌ Instead of this: "Since ancient times, the legal system has been a complex web of rules and regulations. This brings us to the issue of liability in contractual agreements." ✅ Do this: "The issue of liability in contractual agreements is crucial in this case." 👉 Use Active Voice and Concise Language: Write in the active voice and be concise. ❌ Instead of this: "It is important to understand that the contract was breached by the defendant." ✅ Do this: "The defendant breached the contract." 👉 Revise with a Focus on Brevity: After writing, review your work to identify and eliminate any redundant phrases, vague statements, or unnecessary background information. ❌ Instead of this: "In light of the fact that the plaintiff did not receive the goods on time, which is a key issue that we must consider in this case, it is clear that a breach of contract has occurred." ✅ Do this: "The plaintiff did not receive the goods on time, resulting in a breach of contract." 📍 Need legal English conversation or writing classes for yourself or your firm? DM me. In the meantime, want to enjoy my free stuff? Follow me, Paula Klammer, and hit the 🔔 for more content like this.

First Impressions Matter: The introduction is the initial encounter readers have with your work. Just as in personal interactions, first impressions can make or break engagement. A well-crafted introduction sets the stage for a positive reception. ✍🏼 😃 Here are 8 key considerations for writing an introduction (with examples): 1️⃣ Contextualise the Research Problem: Example: "The rising prevalence of chronic diseases necessitates fresh insights into preventive strategies and personalised treatments in healthcare." 2️⃣ Highlight Existing Knowledge: Example: "While genetics has shed light on diseases, a gap remains in understanding how lifestyle interacts with genes, especially in cardiovascular health." 3️⃣ Define the Research Question or Hypothesis: Example: "How do gene-environment interactions influence susceptibility to cardiovascular diseases, and what does this mean for personalised healthcare?" 4️⃣ Establish the Research Gap: Example: "Past studies explored genes and the environment separately; our research connects them for a more comprehensive view." 5️⃣ Highlight Unique Aspects: Example: "Our study uniquely combines advanced genomic profiling with lifestyle assessments for a holistic understanding of cardiovascular health factors." 6️⃣ Discuss the Expected Contribution: Example: "Unraveling the interplay between genes and environment, our research offers actionable insights for tailored interventions in cardiovascular health." 7️⃣ Consider the Target Audience: Example: "For healthcare professionals and geneticists, our article explores the intersection of genetics and lifestyle in cardiovascular health." 8️⃣ Establish a Compelling Opening: Example: "In the era of personalised medicine, there has been a growing interest in exploring the interplay between genes and environment for precision interventions." Please SHARE with those who may benefit. Knowledge is power 👊🏼 😎

No one is waking up at 7am, sipping coffee, thinking, “Wow, I really hope someone explains holistic wealth architecture today.” People want clarity. They want content that feels like a conversation, not a lecture. They want to understand what you’re saying the first time they read it. Write like you're talking to a real person. Not trying to win a Pulitzer. - Use short sentences. - Cut the jargon. - Sound like someone they’d trust with their money, not someone who spends weekends writing whitepapers for fun. Confused clients don’t ask for clarification. They move on. Here’s how to make your content clearer: 1. Ask yourself: Would my mom understand this? If the answer is “probably not,” simplify it until she would. No shade to your mom, she’s just a great clarity filter. 2. Use the “friend test.” Read it out loud. If it sounds weird or overly stiff, imagine explaining it to a friend at lunch. Rewrite it like that. 3. Replace jargon with real words. Say “retirement income you won’t outlive” instead of “longevity risk mitigation strategy.” Your clients are not Googling your vocabulary. 4. Stick to one idea per sentence. If your sentence is doing cartwheels and dragging a comma parade behind it, break it up. 5. Format like you actually want them to read it. Use line breaks. Add white space. Make it skimmable. No one wants to read a block of text the size of a mortgage document. Writing clearly isn’t dumbing it down. It’s respecting your audience enough to make content easy to understand. What’s the worst jargon-filled phrase you’ve seen in the wild? Let’s roast it.