Yes, +1

I was looking at the pyproject.toml file. Based on this discussion you will
remove the +incubating from the version, and we also must not use it in the
name field. But I would consider using the word "incubating" either in the
authors or description fields, or both:

description = "Apache Otava Incubator project: Change Detection for
Continuous Performance Engineering"
authors = ["Apache Otava Incubator <dev@otava.apache.org>"]

Just an idea, you can choose whichever you like, including neither.

henrik

On Wed, Jun 4, 2025 at 8:02 PM Alexander Sorokoumov <
aleksandr.sorokou...@gmail.com> wrote:

> To summarize, here is the structure we want in
> https://dist.apache.org/repos/dist/dev/incubator/otava/:
>
> 0.6.0-incubating-rc-5/
>   apache-otava-incubating-0.6.0-rc5-src.tar.gz (the payload is the github
> tag archive - exactly what we had in this RC).
>   apache-otava-incubating-0.6.0-rc5-src.tar.gz.asc
>   apache-otava-incubating-0.6.0-rc5-src.tar.gz.sha512
>   pypi/ (poetry build files)
>     apache-otava-0.6.0-rc5.tar.gz
>     apache-otava-0.6.0-rc5.tar.gz.asc
>     apache-otava-0.6.0-rc5.tar.gz.sha512
>     apache-otava-0.6.0-rc5-py3-none-any.whl
>     apache-otava-0.6.0-rc5-py3-none-any.whl.asc
>     apache-otava-0.6.0-rc5-py3-none-any.whl.sha512
>
> Is this a fair summary?
>
> Best,
> Alex
>
>
> On Wed, Jun 4, 2025 at 8:12 AM Dave Fisher <w...@apache.org> wrote:
>
> >
> >
> > > On Jun 4, 2025, at 7:30 AM, Henrik Ingo <hen...@nyrkio.com> wrote:
> > >
> > > On Wed, Jun 4, 2025 at 5:36 AM Dave Fisher <w...@apache.org> wrote:
> > >
> > >> Let’s discuss the rule, ASF Release policy, and how PyPi distributions
> > are
> > >> presenting the conflict.
> > >>
> > >>
> > > Thanks. We also had a sidebar with Mick and I will include here our
> > > conclusions (which on a high level align with your advice).
> > >
> > >
> > >
> > >> 1. Official Apache Releases are the ones that are currently found on
> > >> downloads.apache.org and are staged through svn on dist.apache.org.
> > (work
> > >> is ongoing on new platform.)
> > >> 2. The `-incubating` naming rule applies to Official Apache Releases.
> > The
> > >> rule is to make it clear to downstream users that this is a release
> > from an
> > >> Incubator podling. Including a DISCLAIMER or DISCLAIMER-wip in the
> > package
> > >> accomplishes this as well.
> > >> 3. Release artifacts that are distributed to a Distribution Channel
> like
> > >> Maven Central and PyPi may require variations in policies.
> > >>
> > >> Solution is to create a poetry source release, rename the packet to
> use
> > >> the -incubator for the vote and release, but use the poetry created
> > >> artifact as needed for PiPyTest and PyPi distribution channels.
> > >>
> > >
> > > Yes. So the general solution from both of you is to separate the
> official
> > > ASF release, and any other files, which Mick calls "convenience files".
> > > (For example, a project might release compiled binaries or platform
> > > specific files simultaneously with the official ASF release, but only
> the
> > > source tar file under dist.apache.org is the official ASF release.
> > >
> > > At the end of the discussion related to the rc3 attempt, I think we
> > already
> > > had a consensus to adopt the same structure as
> > > https://dlcdn.apache.org/datasketches/python/5.2.0/ (Then I started
> > reading
> > > the python guidelines and we went off track from there...) It seems
> likke
> > > this will actually help us satisfy all requirements.
> > >
> > > - In https://dist.apache.org/repos/dist/dev/incubator/otava/0.6.0-rc5/
> > > <https://dist.apache.org/repos/dist/dev/incubator/otava/0.6.0-rc4/> we
> > will
> > > put the official asf source release
> > >    - This needs to adhere to asf policy requirements, and need not
> > satisfy
> > > any python requirements
> > >    - My suggested name: apache-otava-incubator-0.6.0-rc5-src.tar.gz
> > >      - Note the -src (or -sources also ok) this distinguishes the
> > official
> > > asf release from the pypi tar file.
> > >      - In particular, I'm trying to think ahead also into the future
> when
> > > we graduate the incubator.
> > >    - Content: This should IMO be just a tar package of the git
> > repository.
> > > (minus .git/ dir), which is what Aleks has been doing all the time
> > >
> > > - Under a subdirectory pypi/
> > >    - files built with poetry build and intended for pypi.org
> > >   - These must adhere to python and pypi naming and other policies.
> They
> > > are not part of the official asf release.
> > >   - apache-otava-0.6.0-rc5.tar.gz aka the source distribution or
> "sdist"
> > > for short
> > >   - apache-otava-0.6.0-rc5-py3-none-any.whl
> > >   - These files shoukld still include the disclaimer, and append
> > > "(incubating)" to the project name in the README, NOTICE and the
> > > description of pyproject.toml
> > >
> > >
> > > I think that covers everything?
> > >
> > > To make it exolicit, above proposal deviates from Dave's proposal in
> that
> > > the official asf release is just a tar package of the git repository.
> > (I'm
> > > flexible on this detail.)
> >
> > For this tar of the git repository you will need to make sure not to
> > include the .git directory along with .gitignore files. Also be careful
> > with any binary artifacts.
> >
> > Best,
> > Dave
> >
> > >
> > > henrik
> >
> >
>

Reply via email to