I'll probably be poorly ranked here, but in my opinion there are more important things to fix in Koha... (randomly chosen: clean the wiki from severely outdated pages, test one of the 205 patches waiting for sign-off, improve documentation, investigate why we have 10 blockers or critical bugs open -without a patch-, one of them BZ14731 being >1yr old)

additional comment: note that changes not related to code comment will change translations & translators will have additional work to do to fix.


Le 19/04/2017 à 02:25, Eric Phetteplace a écrit :
Hi list,

I opened bug #18432 https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18432 because I saw several places in the Koha codebase where the pronoun "he" was being used to refer to a generic third person who could be of any gender. Jonathan Druart noted that this should be a coding guideline, as otherwise new instances of gendered pronouns might continue to be added. Perhaps it belongs on the "Terminology" page of the wiki?

So here's my proposal. I'm trying to be concise.

----

*Use gender neutral pronouns*
*
*
When referring to a person who could be of any gender, you should use the words they/them/their. This goes for code comments, text in templates, and strings in tests. For example, here's a string from a patrons test updated to be gender neutral.

Before*:*
*
*
is( $total, $enrolmentfee_K + $enrolmentfee_J, "Kid growing and become a juvenile, he should pay " . ( $enrolmentfee_K + $enrolmentfee_J ) );

After:

is( $total, $enrolmentfee_K + $enrolmentfee_J, "Kid growing and become a juvenile, they should pay " . ( $enrolmentfee_K + $enrolmentfee_J ) );

Gender neutral terms are preferable for a few reasons. They're more welcoming, showing that Koha expects users and contributors to be of any gender. They're also more accurate. Inappropriately using a particular gender can cause confusion, leading someone to believe that code operates differently based on the value of borrowers.sex, for instance.

----

I hope that's clear. I'm happy to reword it, and to attend the next Koha developers meeting to explain further if need be.

Best,
Eric Phetteplace
Systems Librarian
California College of the Arts
libraries.cca.edu <http://libraries.cca.edu> | vault.cca.edu <http://vault.cca.edu>
510.594.3660
2>/dev/null


_______________________________________________
Koha-devel mailing list
Koha-devel@lists.koha-community.org
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
website : http://www.koha-community.org/
git : http://git.koha-community.org/
bugs : http://bugs.koha-community.org/

--
Paul Poulain, Associé-gérant / co-owner
BibLibre, Services en logiciels libres pour les bibliothèques
BibLibre, Open Source software and services for libraries

_______________________________________________
Koha-devel mailing list
Koha-devel@lists.koha-community.org
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
website : http://www.koha-community.org/
git : http://git.koha-community.org/
bugs : http://bugs.koha-community.org/

Reply via email to