“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.”
―
Docs-as-Ecosystem: The Community Approach to Engineering Documentation
Share this quote:
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
by
Alejandra Quetzalli4 ratings, average rating, 0 reviews
Browse By Tag
- love (101660)
- life (79628)
- inspirational (76066)
- humor (44448)
- philosophy (31110)
- inspirational-quotes (28977)
- god (26966)
- truth (24791)
- wisdom (24729)
- romance (24425)
- poetry (23382)
- life-lessons (22691)
- quotes (21168)
- death (20598)
- travel (20101)
- happiness (19097)
- hope (18621)
- faith (18484)
- inspiration (17397)
- spirituality (15780)
- relationships (15697)
- life-quotes (15647)
- religion (15425)
- love-quotes (15416)
- motivational (15378)
- writing (14969)
- success (14209)
- motivation (13240)
- time (12897)
- motivational-quotes (12629)
