Re: INFORMAL VOTE REQUIRED - DOCUMENTATION WORDING

[Tamas K Lengyel <tamas.k.lengyel@xxxxxxxxx>]

Hi all,
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.

Tamas

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
> >
> >