(?)
Quotes are added by the Goodreads community and are not verified by Goodreads. (Learn more)
Alejandra Quetzalli

“WHY COMMUNITY IS MORE REPRESENTATIVE THAN “USERS”
In the traditional software development model, we're used to writing technical documentation with a specific user in mind. However, this approach can be limiting because it assumes a single "ideal" user represents your entire user base.

The docs-as-ecosystem model proposes a different way of thinking about technical documentation; it recognizes technical documentation is not just a product but an ongoing conversation between diverse documentation creators (contributors) and the community.

Thinking in terms of community has several advantages over focusing only on users:

More inclusive: Focusing on the community is more inclusive than focusing only on users because it recognizes that many different types of stakeholders contribute to and read the documentation.

More diverse: Focusing on the community encourages diversity and inclusion because it recognizes many different backgrounds and experiences.

More collaborative: Focusing on the community also fosters a more collaborative approach to documentation because it encourages anyone from any background to participate.

By focusing on community, the docs-as-ecosystem approach offers a more flexible, adaptable, and sustainable way to approach technical documentation. Rather than assuming that there is a single "ideal" user, we recognize that technical documentation is a dynamic and ongoing conversation between documentation creators and the community.”

Alejandra Quetzalli, Docs-as-Ecosystem: The Community Approach to Engineering Documentation
Read more quotes from Alejandra Quetzalli


Share this quote:
Share on Twitter

Friends Who Liked This Quote

To see what your friends thought of this quote, please sign up!

0 likes
All Members Who Liked This Quote

None yet!


This Quote Is From

Docs-as-Ecosystem: The Community Approach to Engineering Documentation Docs-as-Ecosystem: The Community Approach to Engineering Documentation by Alejandra Quetzalli
4 ratings, average rating, 0 reviews
Open Preview

Browse By Tag