← Back to issue list

docs: use more inclusive language in flask tutorial

View original Github issue

Metadata

Project
rockcraft
Number
#707
Type
pull request
State
merged
Author
erinecon
Labels
Created
Updated
Closed

Current evaluation

Merged documentation update to the Flask tutorial, replacing second-person phrasing with collaborative language for a more inclusive learning experience. Approved by four reviewers and merged with 17 additions and 17 deletions across one file.

Suggested action:

No scores available.

Issue body

I discussed with tutorial with Daniele, who expressed some concerns about the way the tutorial was written. Emphasizing the user doing something ("you do X, then you do Y, ...") gives the impression of a how-to guide. A tutorial is more about doing something together with the user as a learning experience. Therefore, I changed some of the language from "you" to "we" to frame the experience as more of a tutorial. We're doing this together with the user so that they can learn how to build a rock for a Flask app. I left some instances of "you" alone where I thought it was appropriate to include. - [X] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)? -----

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.6-35b-a3b Merged documentation update to the Flask tutorial, replacing second-person phrasing with collaborative language for a more inclusive learning experience. Approved by four reviewers and merged with 17 additions and 17 deletions across one file.
qwen3.6-35b-a3b-mtp-q6 Merged documentation update to the Flask tutorial. Replaced second-person phrasing with inclusive, collaborative language to frame the guide as a shared learning experience.
qwen3.6-35b-a3b-mtp-q6 Merged an external contribution updating the Flask tutorial documentation. Changes replace second-person phrasing with collaborative we to foster a more inclusive, shared learning experience, per reviewer feedback.

Update history

No update history recorded yet.

Related issues

Issue Project State Summary Similarity
#594 Flask docs rockcraft merged Merged Flask documentation updates, resolving issue #587. Restructured tutorials and reference guides, clarified prerequisites, and explained rock sizing. Approved by two reviewers, passed CI, and merged June 21, 2024.
71%