AppFlowy-Docs icon indicating copy to clipboard operation
AppFlowy-Docs copied to clipboard

Word choice can be perceived as offensive and vulgar

Open FakhriAz opened this issue 11 months ago • 2 comments

https://github.com/AppFlowy-IO/AppFlowy-Docs/blob/4f6d1276d66ea9f87cbcc70c4ff46d52505526f4/essential-documentation/contribute-to-appflowy/appflowy-mentorship-program/mentorship-2022/mentee-projects/templates.md?plain=1#L9 To be precise, I mean the use of "tits and bits" it is informal and may misinterpreted as offensive.

I suggest the use of other more formal expressions such as:

  • utilizing these features
  • leveraging these components
  • with these capabilities

Please also let me know if you have a style guide for AppFlowy documentations? I searched for it and I did not find it. Are you planning to create a style guide for the documentation?

FakhriAz avatar Jan 01 '25 13:01 FakhriAz

I'm not sure why those words are used, it should say "Using these bits and pieces ..."

Xazin avatar Jan 01 '25 14:01 Xazin

Maybe they relied on AI and did not reread everything carefully.

FakhriAz avatar Jan 01 '25 15:01 FakhriAz