From nobody Thu Sep 26 02:00:02 2024 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4XDcHQ5T41z5Y1yC for ; Thu, 26 Sep 2024 02:00:02 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4XDcHQ1hlvz4NkK for ; Thu, 26 Sep 2024 02:00:02 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1727316002; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=hJ3asJOhH0vII/MHXhpev89OqzjrcFo9zYexYIuX2Is=; b=W4hX0UB7abTdx8u/1SFgnxcthx9ZFrCvd4Bqc0Xa7Qmr2+n3UEO7h01MoWRLdQYBXYskt4 9ZaXcEwK+HT+V72rdYbs0Q5/k/TYoPYIs5AMRrlaMwshuxA+RkYnNJpQfq8FW/+y+t12XP IxDwrcbzvAG3a0alWMGA6BqOsvF6Wns4HqZheXnMbTrSgNyDUuoRcZR3ronyTNIJSoV+wz 47jDShSxzJgVI1BgVW1CFIEqE6O5fMm8Y7Lttr0UzLvQqLNBCjaQ1FwW4QweiXZTtk2wCx 8LLE+cnn765JSQanbI1CZpBiIVyn0fDvzTSI943nUkUGl1CvvfNwzPkPl3d9nQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1727316002; a=rsa-sha256; cv=none; b=kzjVSVZWywTnMqgxpuzzGrlmFwRTjA/QAh8lGglUGfQ2pNCejNtOru+hroWegNOuOcBEqh f/b978+uSaJ4UX/5+J2425Q4SIH55FLQP6lDhROdJqu5hj6yxUOGTlffSYJiGu3MWJyBdE 1EvLO7PwsohtnMugmDpHOW8bJj4FERO53xGIAaeLE1yl95Qr3Xw6qFGq+l6Koo1D9eva6j MSVF7IX+hcDCnd+4YU7Kh9IsrXxdRnTF842l1n8wKL48HdSCNBty7unx3V390a5Z3ict3L RwPVU27oFzM7YQbPAqas/tytTFJw5McYAejRAFZ6vWR9rzAowU5bKORF1EPSNg== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4XDcHQ19StzcY4 for ; Thu, 26 Sep 2024 02:00:02 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 48Q2027t037536 for ; Thu, 26 Sep 2024 02:00:02 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 48Q202Zo037533 for doc@FreeBSD.org; Thu, 26 Sep 2024 02:00:02 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 266357] cripple (pejorative) in doc and src trees Date: Thu, 26 Sep 2024 02:00:02 +0000 X-Bugzilla-Reason: AssignedTo CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Books & Articles X-Bugzilla-Version: Latest X-Bugzilla-Keywords: needs-patch X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: milios@ccsys.com X-Bugzilla-Status: Open X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@FreeBSD.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D266357 --- Comment #11 from Chad Jacob Milios --- (In reply to Ceri Davies from comment #9) I completely agree with Ceri that there is no reason not to -e s/crippled/broken/g;s/cripple/break/g across the entire codebase. I'm sorry= I did not make that abundantly clear sooner than today. This is one very simp= le case where we can easily improve the inclusivity and civility of the projec= t. I completely agree with Dru Lavigne that technical accuracy is paramount an= d I can see no reason that this proposed change should reduce the fidelity of t= he documentation. An example or reference mentioned "will result in denied connections" and t= he memory that invokes for me is adjusting one's firewall remotely from the command line. A "jarring" (bad word choice of mine in #3; I wasn't saying we should insult our users.) warning is always best because if to deny some connections and allow some connections is what you intend, then by the suggested text alone one plausibly might fail to realize they are holding a gigantic foot-gun. Of course that warning can just as easily become "will result in denying all connections". OTOH, "cripple" stands in for 5 of 6 words there and [imho] adequately so w= hen the context sufficiently supplies all the technicals. I don't know about y'= all but I read/skim enough technical jargon as it is in one day to give an arac= hnid cataracts. However, I would never stand in the way of this particular change proposal. When I said #3 I was probably going through something. Oh yeah, I felt some typa way after the master/slave debacle swept through open source years bac= k. While it works that Unbound switched to primary/secondary, I know of at lea= st one system I support that requires the slaves be online and responding _bef= ore_ the master rounds them up to kick off the show. (a performant, not h.a. sys= tem) So, I opted to reject ambiguity and pray the mob passed over me rather than invite any additional support calls from confused clients to placate the mo= b of the day. Sure, if pressed, we could've come up with some other vernacular t= hat avoided contradiction in the documented procedure but thought to myself "How far must we erode our language? We're going to be communicating in grunts a= gain soon." I know the slippery-slope argument is always a logical fallacy when applied= to any single and particular case. That being said, it *is* indeed a valid gen= eral argument in the hypothetical sense. I would invite everyone to enjoy this t= en minute insightful and empathy-rich segment about "soft language" from [imho] the greatest philosopher of the modern era, George Carlin: https://youtu.be/-ZAo_dUbh9s (NSFW, rated PG-13) --=20 You are receiving this mail because: You are the assignee for the bug. You are on the CC list for the bug.=