Technical Writing: How to Write Software Documentation vs Good with Words: Writing and Editing Specialization

The course is structured across twelve thematic modules that map the complete technical writing lifecycle: foundational writing principles, documentation in software development teams, GitHub Wiki with Markdown, style guide construction, structured writing theory, the twelve principles of technical communication, DITA XML authoring inside Oxygen Author, visual communication with Canva and Google Slides, user research via card sorting in Mural, metadata and taxonomy for findability, information architecture strategies, and the technical writer's role within agile development workflows. Learners consistently describe the curriculum as "perfectly structured" and "immediately applicable" — two themes that surface across the vast majority of positive reviews. Karina Delcheva, a career-switcher who used the course to land her first technical writing role, noted that exercises with "easy-to-follow instructions and examples" were the deciding factor in her preparedness. Grace Tan echoed this by crediting the course with orienting her to "the standard and best practices in technical writing as well as the common tools that are used nowadays." The primary content limitation is currency: the course was last updated in February 2021. While foundational writing principles age slowly, tool-specific walkthroughs — particularly the Oxygen Author DITA XML demonstrations and Mural user research sections — reference interface versions that have since changed. Learners who prioritise learning the principles and adapt independently to updated tool UIs will find the content holds up; those expecting step-by-step current tool walkthroughs may encounter friction in a small number of modules.

Jordan Stanchev is a User Assistance Development Architect with eighteen-plus years in technical communications. He began his career as a Java developer before transitioning to information architecture, a dual background that gives him rare credibility when teaching the intersection of software development culture and documentation practice. He currently leads DITA XML-based infrastructure projects at a Fortune 500 company, which means the course is grounded in lived enterprise-scale documentation work rather than theoretical instruction. Reviewers across the JPDocu School's catalogue of ten courses (collectively serving 40,000+ students) consistently praise Stanchev's ability to demystify intimidating tools and workflows. His slides are described as "clear and simple" without being reductive. The course has been adopted as a teaching resource in European university curricula and used for onboarding new technical writers at multiple large organisations — third-party validation of the instructor's authority. The critique that surfaces most often is the absence of live Q&A or direct instructor feedback. Given the course's one-time purchase model and asynchronous delivery, learners who want mentorship during exercises must rely on the Udemy Q&A forum rather than direct coaching. For a course explicitly designed to prepare people for their first technical writing job, this gap is noticeable — peer discussion threads do not fully substitute for expert editorial review.

At approximately $17.99 (standard Udemy promotional pricing), the course offers an exceptional content-to-cost ratio. Nearly ten hours of on-demand video, nine articles, and fourteen downloadable resources — including style guide templates, DITA topic samples, and portfolio exercise assets — represent substantial material for a career-oriented curriculum in this price bracket. The downloadable resources are a particular differentiator: learners leave the course with portfolio-ready documentation samples and reusable templates, which IIM Skills and ClickHelp both highlight as key reasons to prefer this course over cheaper alternatives that provide only passive video content. For a learner whose goal is to secure a first technical writing role, the ability to demonstrate real documentation artefacts is worth considerably more than the course price in interview preparation value. The course is not free to audit — unlike some Coursera alternatives — but its one-time purchase model means no ongoing subscription. For learners who want the Coursera-style free option, the framing shifts: this course's value is in its practical deliverables, not in passive content consumption, which makes the audit-versus-purchase question less relevant.

The course's defining strength is its explicit career-transition orientation. Rather than teaching writing in the abstract, every module is framed around the tools, workflows, and expectations a technical writer encounters in a software development team. The GitHub Wiki with Markdown module alone equips learners with a skill required in nearly every entry-level technical writing job posting. The DITA XML module — while steep for beginners — introduces the structured authoring standard used in enterprise documentation at scale. The card sorting user research module, taught using Mural, is unusual in technical writing curricula and gives learners an edge when applying to companies that practice information architecture methodologies. Portfolio building is woven throughout: every major module includes a practical exercise designed to produce a documentation artefact that can be shared in a job application. One reviewer on Medium noted that the course "helped me understand more about software documentation as a relationship with all the parts involved in software development" — capturing the course's real differentiator: it teaches documentation as a systems problem, not merely a writing problem. This framing is far more useful in a professional context than courses that focus exclusively on grammar and style.

The Good with Words specialization is a four-course sequence covering Word Choice and Word Order, Structure and Organization, Drafting, and Revising — totalling roughly 63 hours of instructional content. Each course is tightly scaffolded so that concepts introduced in week one compound across subsequent modules. The first course alone covers persuasive word choice, grammar and syntax, stylistic devices like alliteration and the Rule of Three, and the S-H-A-P-E framework for specificity. Learners who analysed the content describe the progression as genuinely cumulative — not a grab-bag of writing tips but a coherent system for thinking about how sentences function. The specialization's roots in University of Michigan Law School give the content a precision that generic writing courses lack. Barry draws on legal writing examples — persuasive briefs, judicial opinions, contract clauses — but consistently translates the principles for non-lawyers. Concepts like "zombie nouns" (nominalisations that drain energy from verbs), "verbal clutter," and the distinction between facts and truths appear across multiple modules and are reinforced through concrete before-and-after sentence pairs. Iryna Lobko noted that beyond teaching which words or constructions are better, the course also covered how to work more productively and manage the writing process — a level of metacognitive instruction unusual for a writing MOOC. The Drafting course is particularly well regarded for addressing the psychological side of writing — managing perfectionism, pre-mortem planning for long documents, the distinction between summaries and scenes, and productivity principles borrowed from professional writers. The Revising course introduces the E-D-I-T framework (a concrete checklist for self-editing) and techniques for concision that reviewers describe as immediately deployable on any document already in progress. The specialization also includes a curated monthly "Good Sentences" email and supplementary essays written by Barry himself that demonstrate the concepts in professional prose. Jorge González wrote specifically that "reading Barry's essays helped me see how to apply many concepts I learned throughout this specialization, including the nuance moves and punctuation best practices." A handful of learners note that the legal-writing emphasis means some examples are initially unfamiliar to writers outside law, but the principles transfer with minimal adjustment. The 4.7 content-quality score reflects a specialization that is genuinely well engineered and substantively rich.

Patrick Barry is a Clinical Assistant Professor of Law at the University of Michigan Law School and the Director of Digital Academic Initiatives. He holds a PhD in English from the University of Michigan and a law degree from the University of Chicago, where he won the Wayne Booth Prize for Teaching Excellence. On Coursera, his instructor profile shows a 4.8/5.0 rating across 670 individual instructor evaluations, and more than 261,602 learners have enrolled in his 16 courses. The learner descriptions of Barry's teaching style are strikingly consistent across every course in the specialization and across the entire 52-opinion sample. Reviewers use words like "engaged," "warm," "clear," "fantastic," and "exceptional" with a frequency that is unusual even for highly rated MOOC instructors. CS noted: "Prof. Barry is a fantastic teacher." MB called him "an exceptional mentor that you will get hooked into becoming better and better as a writer." ML wrote: "Professor Barry brings English to life through engaging lectures and video presentations." The warm tone and clear enunciation make even the more technical modules on syntax and grammar feel accessible rather than dry. What distinguishes Barry from generic writing instructors is his ability to demonstrate the concepts he is teaching in real time — his lecture videos themselves are models of the word choice, sentence variety, and structural clarity he is advocating. Several reviewers remark that you can hear the principles in action as Barry speaks, which creates an unusually coherent feedback loop between the lesson content and the instructional medium. Hanan Bashir Attawil put it directly: "Professor Barry made everything enjoyable, and he made me love writing more." This emotional register appears in a surprising proportion of reviews — not just ratings of quality but expressions of genuine affection for the instructor and regret when the courses end. L. Molina's famously enthusiastic review — "NOOOOOO! I cant believe this course is over!!!! This course was FANTASTIC!" — captures a sentiment that recurs across many reviews. No reviewer in the 52-opinion sample criticises Barry's instruction, his preparation, or his clarity — a unanimity of positive sentiment that is rare even for highly rated courses.

The Good with Words specialization operates on Coursera's standard model: all video lectures, readings, and exercises across all four courses are accessible by auditing for free. A paid Coursera subscription is required only for the shareable professional certificate and for submitting graded assignments for peer review. Financial aid is available for learners who cannot afford the subscription. This pricing structure means that the overwhelming majority of the pedagogical value is accessible at zero cost. More than 200,000 learners from around the world have enrolled in Barry's Coursera courses — a figure that reflects sustained organic word-of-mouth. For the target audience of professionals, graduate students, lawyers, and business writers who want to improve their prose without committing to a degree programme, the value proposition is strong. Professional writing coaches who teach the same calibre of legal and persuasive writing principles typically charge hundreds to thousands of dollars for workshops or one-on-one sessions. The supplementary textbook, Good with Words: Writing and Editing by Patrick Barry (University of Michigan Press), is a companion to the course and covers the same material in written form. Learners who use the book alongside the course report that the combination is more powerful than either alone. Kathleen Scanlon wrote: "My previous colleges don't measure up to University of Michigan, and I'm grateful for this opportunity to learn from the best." The main value caveat is the Coursera subscription model: learners who want the certificate and peer-review access must pay the ongoing monthly fee, and the cost accumulates if completion takes months rather than weeks. For learners who audit without the certificate, the value is essentially unlimited — but the absence of assessed feedback is a real limitation of the free tier.

Feedback in the Good with Words specialization is delivered primarily through two channels: peer review of written exercises (available on the paid tier) and ungraded self-assessment exercises that accompany most video lectures. The ungraded exercises are well designed — they typically ask learners to revise a sentence or paragraph using the concept just taught, then reveal Barry's preferred revision for comparison. This format gives immediate feedback on discrete skills and is available to all learners regardless of subscription tier. The peer-review component is the standard large-MOOC mechanism: learners submit a writing exercise, review three peers' submissions using a rubric, and receive reviews from three peers in return. The quality of this feedback is variable by design — it depends entirely on the quality and effort of the peers matched. Asisha Joseph praised the exercises themselves as "wonderful" but did not specifically praise the peer-review feedback quality, which is a common pattern across the reviews: praise for the exercises, silence on the peer feedback received. Instructor feedback on individual submissions is not available at the specialization's scale (96,258 enrolled, 2,608 reviews on the specialization page). Barry and his teaching assistants have clearly invested in the exercise design and in curating good examples, but the feedback loop from instructor to individual learner does not exist in the MOOC format. This is a structural reality of teaching 100,000 learners simultaneously, not a failure of Barry's commitment. Donna Chanderpaul-Singh offered an illuminating perspective: "Professor Barry presents his lessons in such a simple formula that it would be difficult to forget these concepts. Besides, I have already started to use some of them." For many learners, the self-application loop — watch, practise, compare, revise — functions adequately as feedback without requiring expert intervention at each step. The 3.7 score reflects the genuine strength of the exercise design, tempered by the absence of instructor-level feedback on individual work.

The case for real-world applicability begins with the course's origins: this material was developed for law students at the University of Michigan and the University of Chicago, professional contexts where the cost of unclear prose is measured in lost cases, botched contracts, and dismissed motions. Barry designed the curriculum to produce visible, measurable improvement in working documents — not to theorise about writing but to change how learners actually write on Monday morning. Reviewers across widely different professional backgrounds confirm that this design intent is realised in practice. Eduardo Jodi Kuninari noted explicitly that despite the course being dedicated to law students, it "can be applied to any area of knowledge." Iryna Lobko, an English learner rather than a native speaker, described the course as "extremely useful," citing the productivity and time-management content alongside the language instruction as immediately applicable. Daniela Thais Castro Caceres noted in 2024 that the Revising course helped improve both her English (second language) and Spanish (first language), a cross-linguistic transfer that speaks to the universality of the underlying principles. For legal professionals, the applicability is direct and well documented: the course covers persuasive syntax, strategic use of active and passive voice, precision in word choice, and the structuring of arguments for a reader who may be hostile or rushed. For business writers, the same principles apply to proposals, reports, and executive communications. Multiple reviewers explicitly describe applying concepts during the course rather than after it — drafting a document at work and immediately using a technique from that morning's lecture. The one applicability caveat is that learners from creative writing or fiction backgrounds occasionally find the course's emphasis on clarity, precision, and persuasion less relevant to their goals. The specialization is explicitly oriented toward professional, academic, and legal writing — genres where clarity serves the reader — rather than literary writing where ambiguity or voice may be deliberate effects. For the target audience of professionals, graduate students, and academics, the real-world applicability score of 4.6 is well supported.