Skip to content

Commit 8e0ea2e

Browse files
committed
Add to our 'Links for technical writers' page
1 parent 3489c7c commit 8e0ea2e

File tree

1 file changed

+39
-21
lines changed

1 file changed

+39
-21
lines changed

website/library/reference/links-for-technical-writers.md

Lines changed: 39 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,58 @@
11
# Links for technical writers
22

3+
4+
## Blogs
5+
6+
- [I'd Rather Be Writing](https://idratherbewriting.com/): Tom Johnson’s blog on technical writing, docs-as-code, and APIs.
7+
- [Passo uno](https://passo.uno/): Fabrizio Ferri Benedetti’s blog on technical writing, documentation, and language.
8+
39
## Community
410

5-
- [Write the Docs](https://www.writethedocs.org/): a global community of people who care about documentation.
6-
- [The Good Docs Project](https://www.thegooddocsproject.dev/): volunteers empowering developers to create good documentation.
711
- [Google Season of Docs](https://developers.google.com/season-of-docs): support for open source projects to improve their documentation.
12+
- [The Good Docs Project](https://www.thegooddocsproject.dev/): volunteers empowering developers to create good documentation.
813
- [Top 5 Technical Writing Communities of 2024](https://hackmamba.io/blog/2024/03/top-5-technical-writing-communities-of-2024/): list of 2024's top 5 technical writing communities according to Hackmamba.
14+
- [Write the Docs](https://www.writethedocs.org/): a global community of people who care about documentation.
915

10-
## Training
16+
## Frameworks
1117

12-
- [Google's Technical Writing Courses](https://developers.google.com/tech-writing): learn how to plan and author technical documents.
13-
- [GOV.UK: Documenting APIs](https://www.gov.uk/guidance/how-to-document-apis): structuring, designing and publishing your API documentation.
14-
- [Best Technical Writing Courses & Certificates](https://www.coursera.org/courses?query=technical%20writing): Selected list of technical writing courses from Coursera.
15-
- [Become a Certified Technical Writer](https://technicalwriterhq.com): Technical Writer HQ specializes in providing courses for various types of writing certifications.
18+
- [AsciiDoc](https://asciidoc.org/): a plain text markup language for writing technical content.
19+
- [Docusaurus](https://docusaurus.io/): MDX-powered documentation publishing platform.
20+
- [LaTeX](https://www.latex-project.org/): text-based markup for type setting, especially for scientific documentation.
21+
- [Sphinx](https://www.sphinx-doc.org/en/master/index.html): use RST or MyST Markdown to author highly structured technical documents.
22+
23+
## Great documentation examples
24+
25+
- [Arch Linux wiki](https://wiki.archlinux.org/): community-driven in-depth articles on many aspects of Linux and open source.
26+
- [Django documentation](https://docs.djangoproject.com/en/): a web framework developed to publish data-driven websites.
27+
- [Google Workspace Learning Center](https://support.google.com/a/users/answer/9389764?visit_id=638775740206409702-380102409&hl=en&rd=1): collection of resources of Google's Learning Center.
28+
- [Microsoft technical documentation](https://learn.microsoft.com/en-us/docs/): in-depth guides and articles organised by product.
29+
- [Mozilla Developer Network](https://developer.mozilla.org/en-US/): documenting web technologies, including CSS, HTML, and JavaScript.
30+
- [Stripe API documentation](https://docs.stripe.com/api): documentation for an efficient and correct use of Stripe API.
31+
32+
## Podcasts
33+
34+
- [API The Docs](https://apithedocs.org/podcast): podcast about API documentation and developer portals.
35+
- [CherryLeaf](https://www.cherryleaf.com/podcast/): podcast on technical writing skills and interviews with technical writers.
36+
- [The Not-Boring Tech Writer](https://thenotboringtechwriter.com/): podcast about the complexities of technical writing.
37+
_ [I'd Rather Be Writing](https://idratherbewriting.com/podcasts/): podcast about technical writing trends and best.practices
1638

1739
## Style and structure
1840

19-
- [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/): writing style guide and terminology for all communication.
20-
- [Google Style Guides](https://google.github.io/styleguide/): guides on style for languages from AngularJS to Vim script.
2141
- [Diátaxis](https://diataxis.fr/): a systematic approach to technical documentation authoring.
42+
- [Google Style Guides](https://google.github.io/styleguide/): guides on style for languages from AngularJS to Vim script.
2243
- [Introduction to DITA](https://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part3-all-inclusive/archSpec/base/introduction-to-dita.html#introduction-to-dita): an open standard and architecture for technical information.
44+
- [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/): writing style guide and terminology for all communication.
2345
- [Technical Writing Resources](https://developers.google.com/tech-writing/resources): resources and style guides from Google for developers.
2446
- [What is a Technical Writer Style Guide? With Examples](https://document360.com/blog/technical-writer-style-guide/): guide with style examples from Document360.
2547

26-
## Frameworks
48+
## Training
49+
50+
- [Become a Certified Technical Writer](https://technicalwriterhq.com): courses for various types of writing certifications.
51+
- [Best Technical Writing Courses & Certificates](https://www.coursera.org/courses?query=technical%20writing): selected list of technical writing courses from Coursera.
52+
- [Google's Technical Writing Courses](https://developers.google.com/tech-writing): learn how to plan and author technical documents.
53+
- [GOV.UK: Documenting APIs](https://www.gov.uk/guidance/how-to-document-apis): learn about structuring, designing, and publishing your API documentation.
54+
55+
2756

28-
- [AsciiDoc](https://asciidoc.org/): a plain text markup language for writing technical content.
29-
- [Docusaurus](https://docusaurus.io/): MDX-powered documentation publishing platform.
30-
- [Sphinx](https://www.sphinx-doc.org/en/master/index.html): use RST or MyST Markdown to author highly structured technical documents.
31-
- [LaTeX](https://www.latex-project.org/): text-based markup for type setting, especially for scientific documentation.
3257

33-
## Great documentation examples
3458

35-
- [Mozilla Developer Network](https://developer.mozilla.org/en-US/): documenting web technologies, including CSS, HTML, and JavaScript.
36-
- [Django documentation](https://docs.djangoproject.com/en/): a web framework developed to publish data-driven websites.
37-
- [Arch Linux wiki](https://wiki.archlinux.org/): community-driven in-depth articles on many aspects of Linux and open source.
38-
- [Microsoft technical documentation](https://learn.microsoft.com/en-us/docs/): in-depth guides and articles organised by product.
39-
- [Google Workspace Learning Center](https://support.google.com/a/users/answer/9389764?visit_id=638775740206409702-380102409&hl=en&rd=1): collection of resources of Google's Learning Center.
40-
- [Stripe API documentation](https://docs.stripe.com/api): documentation for an efficient and correct use of Stripe API.

0 commit comments

Comments
 (0)