After Writing for the Web
Thank you so much for joining us at Sharing is Caring’s Writing for the Web where we discussed better practices for developing online content. If you are looking for more directions on what to do next, we have a few resources to support you along your journey.
Attend more free hands-on training sessions
If you are interested in contributing to docs.microsoft.com or Microsoft 365 Community Content, a community-driven repository of articles focusing on the why behind the decisions we make in Microsoft 365, we have additional courses you can attend.
First Time Contributor
By the end of this session, all attendees will have completed their first pull request and navigated through GitHub. Many people learn best by doing, so creating this separate GitHub repository as a safe practice space allows us to learn together. This session removes the technical barriers empowering you to contribute to docs.microsoft.com. Register for a First Time Contributor session.
Community Docs
This session takes what you learned in First Time Contributor and takes it a step further. We will focus on writing in markdown, adding GitHub media files, creating branches and bulk pull requests to support contributing articles to Microsoft 365 Community Content. Register for a Community Docs session.
Contribute to existing initiatives
Microsoft 365 Community (PnP) Blog
This blog focuses on technical posts by the community on how to extend Microsoft 365 with custom-coded and low-code solutions. It spans over a variety of topics such as SharePoint frameworks (SPFx) solutions, SharePoint List formatting, Viva Connections Adaptive Card Extensions, Microsoft Teams Development, Power Platform solutions, Microsoft Graph Toolkit, and more. It also holds the summary blog posts and recordings of all community calls, podcasts, and monthly updates in the Microsoft 365 developer ecosystem. To submit a blog post, follow this shortened guide. As an experienced open-source contributor, read our contributing guide. If you seek for hands-on guidance as a new contributor, also consider signing up for our Sharing-is-Caring sessions.
Microsoft Community Content
Microsoft Community Content lives on the same platform as docs.microsoft.com though its focus is less on the how to complete actions within Microsoft 365 and more the why behind the choices we make in Microsoft 365. This platform also houses content for the Maturity Model for Microsoft 365.
You can attend a Sharing is Caring session to learn how to contribute or you can follow our handy guide on how to submit articles.
Explore more free writing resources
We highlighted better practices and metrics from the following articles in the Writing for the Web session. You may want to explore these further to solidify some of the concepts. These articles are listed in chronologic order to match the session agenda.
How people read online
Satisficing in UX Design: Fast Access to Good-Enough Stuff (nngroup.com)
Information Scent: How Users Decide Where to Go Next (nngroup.com)
How People Read Online: New and Old Findings (nngroup.com)
How to write to support online reading patterns
Page Structure
Inverted Pyramid: Writing for Comprehension (nngroup.com)
Accordions for Complex Website Content on Desktops (nngroup.com)
Using Collapsible Sections with User Experience in Mind – Emily Mancini
Content
First 2 Words: A Signal for the Scanning Eye (nngroup.com)
“Learn More” Links: You Can Do Better (nngroup.com)
A Link is a Promise (nngroup.com)
Information Pollution (nngroup.com)
Writing for Web Accessibility – Tips for Getting Started | Web Accessibility Initiative (WAI) | W3C
Microsoft-specific writing guidance
Top 10 tips for Microsoft style and voice – Microsoft Style Guide | Microsoft Docs
Formatting text in instructions – Microsoft Style Guide | Microsoft Docs
Describing interactions with UI – Microsoft Style Guide | Microsoft Docs
Free tools to support writing
Get your document’s readability and level statistics in Word (microsoft.com)
Emily Mancini 