Technical Writing: How to Write Software Documentation vs Writing in English at University

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 content is organised into four logically sequenced modules that cover the full cycle of academic writing: an introduction to academic conventions and process writing; structuring arguments and text organisation; using sources, paraphrasing, quoting, and academic integrity; and a final "writer's toolbox" module focused on editing and proofreading. Each module combines short video lectures, reading assignments, quizzes, and reflective self-assessment questions, giving learners multiple modes of engagement with the material. A standout feature is the free electronic textbook "Writing in English at University: A Guide for Second Language Writers," written by the same Lund University instructors specifically to complement the MOOC. This means learners get a professionally authored reference they can return to beyond the course itself — a rarity for free MOOCs. The course materials were substantially revised and updated in 2023, adding new exercises and modernised content. This keeps the curriculum current, which is particularly important for topics like citation standards and academic integrity, where guidelines change over time. Learners consistently highlight the clarity and relevance of the materials. One reviewer noted that "videos, quizzes, and written material used to teach the topic were clear, pertinent, short, and very well structured." The course earned a 4.7-star rating across 839 reviews, with 78.54% of learners awarding five stars — a strong signal that the content quality resonates across a very large and diverse learner base spanning multiple continents and language backgrounds. The one limitation noted in an academic peer review (Nigar, 2020, published in Teaching English with Technology) is that the course does not fully employ the Presentation-Practice-Production (PPP) framework, which means some practice activities feel limited — for example, a paragraph structuring lesson backed by only a two-question quiz. Despite this, the breadth and coherence of the four modules represent very strong content quality for a free resource.

The course features five instructors from Lund University's Faculty of Humanities: Satu Manninen, Ellen Turner, Cecilia Wadsö Lecaros, Nicolette Karst, and Fredrik Vanek. Lund University is one of Scandinavia's oldest and most prestigious research universities, founded in 1666, and its English department has deep expertise in applied linguistics and second-language academic writing. The multi-instructor format is a meaningful strength: learners encounter different teaching voices across modules, which prevents monotony and reflects the collaborative nature of academic writing instruction at the university level. Each instructor brings a distinct perspective — some focusing on grammar and style, others on argument construction or source ethics — giving the course a well-rounded pedagogical character. The video lectures are widely praised for being concise and accessible. Multiple learners noted that the instructors explain complex academic writing conventions in plain language, without assuming prior writing experience. One learner highlighted that the course "focuses on the fundamental aspect of constructing an argument and incorporating sources in academic writing" — suggesting instructors successfully convey the core intellectual moves of academic discourse rather than just surface-level grammar rules. A minor limitation is the absence of live office hours or direct instructor Q&A, which is common in large MOOCs. Feedback comes primarily through peer review and automated quizzes rather than from the instructors themselves. Still, the quality and warmth of the video lectures — combined with Lund University's academic credentials — make the instructor dimension one of the course's genuine assets.

"Writing in English at University" is free to audit in full, meaning any learner worldwide can access all four modules, all video lectures, all readings, all quizzes, and the full peer review exercises without paying a single cent. This is genuinely exceptional: comparable academic writing courses on Udemy cost between $15 and $100, while specialisations on Coursera with similar content typically require a Coursera Plus subscription at approximately $59 per month. The optional certificate of completion — which requires completing graded assignments at the end of each module — carries a modest administrative fee, but the core learning experience is not gated behind that fee. Learners who choose to pursue the certificate get a Lund University credential that they can share on LinkedIn or attach to job applications, which adds further value for those who do pay. Coursera Plus subscribers can access the certificate at no additional cost beyond their subscription, making this an even stronger value proposition for anyone already subscribing. The bundled free textbook ("Writing in English at University: A Guide for Second Language Writers") would cost money if purchased as a standalone publication, yet it is included as part of the free course experience. This raises the effective value significantly. For international students, ESL learners, and anyone entering university or preparing graduate school applications on a budget, the combination of world-class university authorship, zero cost to learn, and a highly practical curriculum represents extraordinary value. Few competing courses at any price point offer this combination.

The course includes peer review exercises across its modules, allowing learners to submit short written pieces and evaluate each other's work using structured rubrics. This is the primary mechanism through which learners receive feedback on their own writing — the instructors do not personally grade or respond to individual submissions given the large global enrollment. The peer review design has genuine strengths: learners must both give and receive structured feedback, which research in writing pedagogy suggests is itself a valuable learning activity. Evaluating another person's argument structure or source integration forces the reviewer to articulate what makes academic writing effective, reinforcing their own understanding. However, academic analysis of the course (Nigar, 2020) notes that the course "lacks sufficient production phases where peer review could occur," meaning learners have fewer opportunities to produce and receive feedback on extended writing than would be ideal. Some modules rely primarily on quizzes rather than open-ended writing tasks, limiting the quantity of authentic feedback learners receive. The quality of peer feedback is also variable by nature: in a MOOC with a diverse global learner base, some peers are highly experienced writers while others are true beginners. There is no mechanism for instructors to moderate or quality-check peer reviews, so learners occasionally receive vague or unhelpful feedback. The automated quizzes provide immediate right/wrong feedback but cannot evaluate nuanced writing choices. For learners who are preparing for high-stakes academic work and want substantive editorial feedback on full essays, the course's feedback mechanisms are sufficient for orientation but may feel incomplete. This is an inherent constraint of the free MOOC format rather than a specific failure of course design.

The skills taught in this course map directly onto the demands of undergraduate and postgraduate academic work: constructing a thesis-driven argument, integrating secondary sources ethically and effectively, structuring long-form texts with clear signposting, and polishing prose through editing and proofreading. These are precisely the competencies that university instructors and writing tutors identify as most commonly underdeveloped in student writers, particularly those writing in English as a second language. Learners report applying course skills immediately to ongoing coursework. One reviewer wrote that "this four course modules were really essential for our academics in universities and higher studies," suggesting direct carry-over to real assignments. Another noted that the course "gave me a very good basis" for continued academic writing development, implying it serves as a strong foundation rather than a terminal endpoint. The course's emphasis on academic integrity and citation practices — covering paraphrasing, quotation, attribution, and how to avoid plagiarism — is directly applicable to any discipline, making the skills transferable across STEM, social sciences, and humanities writing contexts. Beyond university, the argumentation and structuring skills taught in the course translate to professional writing contexts: research reports, policy briefs, grant proposals, and business analyses all benefit from the same logical organisation the course teaches. The course's own materials acknowledge this, describing academic writing skills as "essential for effective communication in university studies, professional life and lifelong learning." The course is particularly impactful for non-native English speakers entering Anglophone or international academic environments, where writing conventions differ substantially from those in many national educational systems. Graduates of the course are better positioned to meet the writing expectations of English-medium institutions worldwide.