Technical Writing: How to Write Software Documentation vs Writing in the Sciences

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 course covers an impressive breadth of scientific writing topics across eight weeks: principles of effective writing, cutting clutter, sentence and paragraph structure, manuscript organisation (IMRAD format), the peer review process, grant writing, ethical issues in publication, and communicating with general audiences. Learners consistently describe Weeks 1–6 as containing some of the most practically useful writing instruction available anywhere online, with concrete exercises and annotated real-world examples drawn primarily from published research. The main criticism from a minority of reviewers — particularly those from chemistry, engineering, or physics backgrounds — is that roughly 80% of the illustrative examples come from biomedical and epidemiological journals. Reviewers SchahrYar and Kristin Wenger each gave two-star ratings specifically because the course "should really be called Medical Journal Writing." That said, the principles themselves are universally applicable, and the majority of learners from non-biomedical fields still report significant improvement in their writing. The inclusion of three interviews with active journal editors was singled out by multiple reviewers as an unexpected highlight, giving learners insider perspective on what makes submissions succeed or fail. Content for later weeks — covering grant proposals, recommendation letters, review articles, and personal statements — rounds out a curriculum that goes well beyond introductory MOOC fare.

Dr. Kristin Sainani holds a PhD in epidemiology and an MS in statistics from Stanford University, and separately studied science writing at UC Santa Cruz. She has received multiple Excellence in Teaching Awards from Stanford's graduate epidemiology programme and publishes actively in both academic and mainstream science outlets. Her dual identity as researcher and science communicator is apparent throughout — she writes about the pitfalls of academic prose from direct personal experience, not just theory. Learner feedback about her delivery is almost uniformly glowing. Phrases like "just amazing," "personable and encouraging," "animated and educational," and "a genius" appear repeatedly across forums, Reddit threads, and official Coursera reviews. Reviewer Andrea López Salmerón wrote: "I am no longer afraid to write but the most important thing is that you inspired me." Lukman Aliyu's widely read Medium post noted that "her personable and encouraging teaching style makes the training approachable and fun." The only instructor-related criticism found across hundreds of forum posts was a single isolated comment questioning a minor point of English grammar — a complaint that did not resonate with the wider learner community given the 89% five-star rating. By any measure, Dr. Sainani is among the most consistently praised instructors across all Coursera courses.

The course is fully auditable for free, which is the dominant access mode cited on Reddit, r/PhD, r/AskAcademia, and r/Biochemistry. Free auditors gain access to all video lectures, transcripts, and most quizzes. A Coursera Plus subscription or one-time certificate purchase is required to submit peer-reviewed writing assignments and earn a shareable certificate — a cost-benefit that most learners describe as well worth it given the calibre of the instruction. For researchers considering the cost of equivalent in-person scientific writing workshops (which commonly run $500–$2,000 per day), the Coursera subscription model represents extraordinary value. A postdoc reviewer on Coursera wrote: "I am a postdoc and I feel that I should have taken this course earlier" — capturing the sentiment of many experienced researchers who wish they had encountered the material sooner in their careers. Financial aid is available via Coursera for learners who cannot afford the certificate fee, further improving accessibility. Given the 607,000+ enrolments and near-perfect ratings, the course clearly delivers returns well beyond its cost.

The course uses peer-reviewed written assignments as its primary assessment mechanism. Rather than a simple rubric-click system, students are asked to edit essays directly in a word processing environment, a design that several reviewers described as more substantive and useful than the peer review systems in other MOOCs they had tried. The main limitation is inherent to peer assessment at scale: the quality of peer feedback is uneven, and some learners report receiving superficial or unhelpful comments from co-learners who may themselves be early in their writing development. This is not a critique specific to this course — it is a structural feature of all large-scale MOOC peer review — but it does mean that learners seeking expert editorial feedback will need to supplement the course with other resources. Quizzes throughout the course are well-constructed and reinforce the core principles effectively. Multiple reviewers noted that the exercises and practice examples pushed them to apply principles immediately, which accelerated skill development compared to courses that rely on passive video consumption alone.

The real-world impact reported by learners is the course's most striking attribute. A first-year undergraduate on Reddit reported earning "top of the class grades for all my essays the past 2 semesters" after completing the course. A medical researcher wrote: "This course definitely improved my writing; I'm sure it will increase the likelihood of getting my work published." Another learner described it as "a game changer for me so far as my grasp of grammar and English is concerned." Reviewers consistently use the language of immediate application: tips and techniques transferred directly into manuscripts, grant applications, thesis chapters, and even emails and reports within weeks of completing the course. Brandon Lynn Sharp wrote that "Weeks 1–6 were filled with some of the most useful information I've ever read," and Ishan Agrawal confirmed "my writing has improved significantly in these 8 weeks." The AESA Network review by researchers Shaktiranjan Das and Ayush Emmanuel Lal concluded that the course is "an excellent choice for anyone seeking to grasp the nuances of effective scientific writing," and recommended that educators in other countries adopt its instructional approach for their own scientific writing curricula.