[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: INFORMAL VOTE REQUIRED - DOCUMENTATION WORDING
- To: Tamas K Lengyel <tamas.k.lengyel@xxxxxxxxx>, Stefano Stabellini <sstabellini@xxxxxxxxxx>, Kelly Choi <kelly.choi@xxxxxxxxx>
- From: Jan Beulich <jbeulich@xxxxxxxx>
- Date: Fri, 1 Dec 2023 08:02:31 +0100
- Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=suse.com; dmarc=pass action=none header.from=suse.com; dkim=pass header.d=suse.com; arc=none
- Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=hc3VbQwl8iBqZ+QVA34SczUndA6xgUTDtNFyAweavFA=; b=Ne+kbDXh374czzAA5l1oz+OumYXsHpEuM26xIDkxLUFDCjW1580RLgv98R5KUdbhv/iKRwu57V14gaPygkBj+qUrK7xW8CexBusbN4MtaQ4jUu3+U5qpFKsfJdlbAVhWIHuTDYKYioHMdWkEsZZOC7gq7K+zBe8jhwu3u6uC0K28AP+1/cN/tYS6rdpLhlaK77op2QZuG0OO3II6DVLutzx2x3/rdnqu0ohbYCOpdXzTeux92jgPG9tRWK/uWAXlB8gF9ZB311uLndX4Xz/RMKeoLQIZkSNFda6hrHhg6KYiigfx5Cu34imqpJWEqVwbVztf/G1JWzaluCor97vTGQ==
- Arc-seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QuISm9tBMpr4MxVNQM+uH3MYjXdL50Riz4tN/umFt/SboE3tAq0cgFyN26D6Hip0xuSOde/eKVhxYeJkWZUiPCQzNWltveXH25iUK8EIcTgKdmPprsnS1243hE73VlAeb/H8vLiXY4bRlwsIW9M5BD3k5VZlxUBODcCGRRNrNrmGJBoO2Xz/xEWPmlPUOs7P6CfYeD5KxwWVsaP9u2iUFNxH5g6S2IEcfuV3l20eBmACp/b1BmaVja3BVADDyEHmCRZ18mm+MbDy3Xm0kYMneSfsj8lOJ9Rm8jzZqKxohhTUUvLSdKAJOtiLvdTkaqXlOEO2ndkSx31KKv3R2rQW6g==
- Authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=suse.com;
- Autocrypt: addr=jbeulich@xxxxxxxx; keydata= xsDiBFk3nEQRBADAEaSw6zC/EJkiwGPXbWtPxl2xCdSoeepS07jW8UgcHNurfHvUzogEq5xk hu507c3BarVjyWCJOylMNR98Yd8VqD9UfmX0Hb8/BrA+Hl6/DB/eqGptrf4BSRwcZQM32aZK 7Pj2XbGWIUrZrd70x1eAP9QE3P79Y2oLrsCgbZJfEwCgvz9JjGmQqQkRiTVzlZVCJYcyGGsD /0tbFCzD2h20ahe8rC1gbb3K3qk+LpBtvjBu1RY9drYk0NymiGbJWZgab6t1jM7sk2vuf0Py O9Hf9XBmK0uE9IgMaiCpc32XV9oASz6UJebwkX+zF2jG5I1BfnO9g7KlotcA/v5ClMjgo6Gl MDY4HxoSRu3i1cqqSDtVlt+AOVBJBACrZcnHAUSuCXBPy0jOlBhxPqRWv6ND4c9PH1xjQ3NP nxJuMBS8rnNg22uyfAgmBKNLpLgAGVRMZGaGoJObGf72s6TeIqKJo/LtggAS9qAUiuKVnygo 3wjfkS9A3DRO+SpU7JqWdsveeIQyeyEJ/8PTowmSQLakF+3fote9ybzd880fSmFuIEJldWxp Y2ggPGpiZXVsaWNoQHN1c2UuY29tPsJgBBMRAgAgBQJZN5xEAhsDBgsJCAcDAgQVAggDBBYC AwECHgECF4AACgkQoDSui/t3IH4J+wCfQ5jHdEjCRHj23O/5ttg9r9OIruwAn3103WUITZee e7Sbg12UgcQ5lv7SzsFNBFk3nEQQCACCuTjCjFOUdi5Nm244F+78kLghRcin/awv+IrTcIWF hUpSs1Y91iQQ7KItirz5uwCPlwejSJDQJLIS+QtJHaXDXeV6NI0Uef1hP20+y8qydDiVkv6l IreXjTb7DvksRgJNvCkWtYnlS3mYvQ9NzS9PhyALWbXnH6sIJd2O9lKS1Mrfq+y0IXCP10eS FFGg+Av3IQeFatkJAyju0PPthyTqxSI4lZYuJVPknzgaeuJv/2NccrPvmeDg6Coe7ZIeQ8Yj t0ARxu2xytAkkLCel1Lz1WLmwLstV30g80nkgZf/wr+/BXJW/oIvRlonUkxv+IbBM3dX2OV8 AmRv1ySWPTP7AAMFB/9PQK/VtlNUJvg8GXj9ootzrteGfVZVVT4XBJkfwBcpC/XcPzldjv+3 HYudvpdNK3lLujXeA5fLOH+Z/G9WBc5pFVSMocI71I8bT8lIAzreg0WvkWg5V2WZsUMlnDL9 mpwIGFhlbM3gfDMs7MPMu8YQRFVdUvtSpaAs8OFfGQ0ia3LGZcjA6Ik2+xcqscEJzNH+qh8V m5jjp28yZgaqTaRbg3M/+MTbMpicpZuqF4rnB0AQD12/3BNWDR6bmh+EkYSMcEIpQmBM51qM EKYTQGybRCjpnKHGOxG0rfFY1085mBDZCH5Kx0cl0HVJuQKC+dV2ZY5AqjcKwAxpE75MLFkr wkkEGBECAAkFAlk3nEQCGwwACgkQoDSui/t3IH7nnwCfcJWUDUFKdCsBH/E5d+0ZnMQi+G0A nAuWpQkjM1ASeQwSHEeAWPgskBQL
- Cc: xen-devel@xxxxxxxxxxxxxxxxxxxx, committers@xxxxxxxxxxxxxx
- Delivery-date: Fri, 01 Dec 2023 07:02:42 +0000
- List-id: Xen developer discussion <xen-devel.lists.xenproject.org>
On 30.11.2023 23:57, Tamas K Lengyel wrote:
> I think this form is bad and is not helpful. We ought to be able to
> recommend an alternative term beside "broken" and "deprecated". I
> would not use the term broken in this context but that also doesn't
> mean we shouldn't use it in any context. But also in this context
> deprecated is not the right term to use either since deprecated would
> require us to actually make the old hypercalls stop working altogether
> at some future point, which we won't ever do AFAIU. My vote would be
> to use the term superseded in this context, which I can't express
> clearly in the form so I'm not going to cast a vote.
+1
This really supports my earlier voiced concern that reducing things too
much for "ease" of voting isn't helpful. (That said, I don't share
Tamas'es view on the use of "deprecated".)
Jan
> On Thu, Nov 30, 2023 at 5:28 PM Stefano Stabellini
> <sstabellini@xxxxxxxxxx> wrote:
>>
>> Hi all,
>>
>> This vote is in the context of this thread:
>> https://marc.info/?l=xen-devel&m=169213351810075
>>
>>
>> On Thu, 30 Nov 2023, Kelly Choi wrote:
>>> Hi all,
>>> There have been a few discussions about how we use documentation wording
>>> within the community. Whilst there are differences in opinions and
>>> perceptions of the definition, it would be helpful to see a wider consensus
>>> of how we feel.
>>>
>>> Discussion: Should we use the term 'broken' in our documentation, or do you
>>> think an alternative wording would be better? If you agree or
>>> disagree, please vote as this will impact future discussions.
>>>
>>> I have purposely made the vote between two options to help us move in a
>>> forward direction.
>>>
>>> PLEASE VOTE HERE. Deadline 15th December 2023.
>>> Your name will be required but will be private. If you answer anonymously,
>>> your vote will not count. This is to ensure it is fair and each
>>> person gets one vote.
>>>
>>> As an open-source project, we need to come to a common ground, which
>>> sometimes means we may not personally agree. To make this fair, please
>>> note the final results will be used to determine our future actions within
>>> the community.
>>>
>>> If the majority votes for/against, we will respect the majority and
>>> implement this accordingly.
>>>
>>> Many thanks,
>>> Kelly Choi
>>>
>>> Xen Project Community Manager
>>> XenServer, Cloud Software Group
>>>
>>>
|
