PAVEMENT VIEWS

This article highlights three common documentation errors: explaining what users already know, detailing things they can't control, and failing to explain non-obvious yet crucial information. It stresses that such "noise" frustrates users, increases costs, and indicates a fundamental failure to prioritize user needs in documentation.

Stop documenting basic tasks! Your microwave manual nails it: 80% cooking, 20% how-to. Software docs often flip this, acting as a band-aid for bad UI. Focus on complex "secondary scenarios" and let friction-free design speak for itself. Documentation isn't a safety net; it's a tactical weapon. Use its limited ammo wisely, or it's just noise.

Want to ace your next interview? Here's your cheat sheet: research the company, interviewer, and your projects.

Struggling to get hired? Here's how to make your application stand out.

When someone complains about poor documentation, they’re usually looking for something that isn’t a straightforward process.

AI initiatives fall into external (customer-facing) and internal (efficiency-driven).

Hiding Help docs behind a sign-in harms discovery, limits prospects, and doesn't deter competitors.

Pageviews can mislead about documentation quality. Focus on user experience for true insights.

Tech writers missed the UX bus, but it’s not too late—there’s still time to jump in, collaborate early, and make a real impact.

Success isn’t always planned. Embrace uncertainty, work hard, keep learning, and be ready when luck strikes. Life’s path isn’t always linear

Prepare for the "Why this company?" interview question by aligning your skills, research, and growth potential with company needs.

The post emphasizes showcasing impact over tasks in resumes, urging applicants to highlight their contributions and measurable achievements.

Way back in the early 2010s, I remember explaining my concept of a perfect Help site as a collection of documents in a bucket with no...

Technological tools enhance but don't replace fundamental writing skills, emphasizing the need for skilled writers despite advancements.

The article emphasizes the importance of meticulous preparation and attention to detail in the job application process for writers.

Exploring how GAI is set to revolutionize the role of product documenters, transform the landscape of documentation and user guides.

Discover how letting go and empowering others can unlock new opportunities for personal and professional growth."

As product documenters, it is our remit to solve customer queries without making them reach out to the support team. But figuring out...

Much of the documentation we churn out today is mostly aimed at procedures and troubleshooting

The technical writing or product documentation team must step in to add information about impacts, considerations, and gotchas.