CourseVerdict

Technical Writing: How to Write Software Documentation vs Grammar and Punctuation

Same Bayesian formula, same rubric — so the difference in scores reflects the difference in the courses, not the difference in how we evaluated them.

Udemy · Academic Writing

Technical Writing: How to Write Software Documentation

4.3/ 5 · 3750 opinions
3175 positive350 neutral225 negative/ 3750 total

University of California, Irvine (Coursera) · Academic Writing

Grammar and Punctuation

3.9/ 5 · 30 opinions
22 positive4 neutral4 negative/ 30 total

Per-criterion

Technical Writing: How to Write Software Documentation

Content quality4.3 / 5

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.

Instructor4.4 / 5

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.

Value for money4.5 / 5

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.

Real-world use4.3 / 5

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.

Grammar and Punctuation

Content quality3.9 / 5

Four tightly-scoped modules on verb tenses, conjunctions, compound and complex sentences, commas and parallel structure. Reviewers consistently praise the clear, methodical structure and find it a strong refresher — but several flag the scope as narrow for a course titled "Grammar and Punctuation," noting punctuation beyond the comma gets little airtime.

Instructor3.7 / 5

Tamy Chapman and the UC Irvine team draw praise for clear, well-organised explanations that build step by step. The recurring complaint is delivery pace — multiple reviewers describe the lecture tone as slow, with one watching everything at double speed and another comparing the professor's pace unfavourably.

Value for money4.3 / 5

Free to audit the full lecture content, with paid access (Coursera subscription or Coursera Plus) only required for graded quizzes, peer-reviewed assignments and the certificate. The biggest negative reviews are not about content but about the paywall not being signposted before enrolment.

Feedback quality3.0 / 5

Graded work is split between auto-graded quizzes and peer-reviewed writing assignments. The peer-grading model is the single most-criticised mechanic — reviewers note that classmates are learning the same material, English proficiency varies widely, and there is no instructor or professional sign-off on submitted work.

Real-world use3.9 / 5

Directly applicable to academic and professional writing — learners repeatedly report writing with more confidence and catching long-standing mistakes. It is a mechanics-and-sentence-structure course, not an essay course, so it builds the foundation rather than the finished academic essay.

Scoring methodology applies identically to every course on the site — see the formula.