Making documentation accessible to all

Talk about Documentation
1

Hello,

I am a new OpenWrt convert (abandoning pfsense, don’t think I’ll ever look back) and was reading about hardening the installation https://openwrt.org/docs/guide-user/security/openwrt_security..

Although the information was great, I was a bit put off by the running gag there, the mention of Katy Perry pictures. Not every reader of the documentation will be male and heterosexual, or maybe they are not comfortable with the idea of sexual content depicting women as sex objects, or potentially have a particular dislike of Katy Perry. Using such language in one of the first articles new users read does not feel very welcoming for anyone not stereotypically associated with more advanced tech subjects.

I think a more neutral joke (cute kittens, skateboarding squirrels) would be just as effective and would be more welcoming to a more diverse audience.

I would be happy to do the update myself if needed.

Thank you,
DQ

2

stereotype 'neutral' is a euphemism for lacking diversity and acceptance. the fantasy utopia you depict is a world void of acceptance, tolerance and culture.

if you'd prefer, i've got some dalai lama pictures if you want them?

1 Like
3

You are welcome to contribute:
https://openwrt.org/wiki/wikirules

4

Done, changed to something more neutral.

5

Thank you , much appreciated.

now back to getting my DNS forwarding working correctly...

6

If your problem is solved, please consider marking this topic as [Solved]. See How to mark a topic as [Solved] for a short how-to.

7

This topic was automatically closed 10 days after the last reply. New replies are no longer allowed.