git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Documentation/howto: tracking git.git

From
Đoàn Trần Công Danh <congdanhqx@gmail.com>
Date
May 14, 2021, 15:27 UTC
Message-ID
<YJ6W50M+EJlIO1GJ@danh.dev>
In-Reply-To
<xmqqwns177cv.fsf@gitster.g>
On 2021-05-14 22:49:52+0900, Junio C Hamano <gitster@pobox.com> wrote:
Show 35 quoted lines
> Bagas Sanjaya <bagasdotme@gmail.com> writes:
> 
> > +Available Branches
> > +------------------
> > +
> > +There are several branches on git.git with different purposes:
> > +
> > +master::
> > +This is the most stable branch. Changes (topics) that are merged
> > +to master should have been stabilized in next and suitable for
> > +production use. Feature releases (vX.Y.0) are cut from this
> > +branch.
> 
> Isn't "maint" meant to be more stable?
> 
> > +next::
> > +This is where topics that haven't been yet merged to master are
> > +stabilized and tested for breakage and regressions. It gives
> > +a summary forecast of what next batch of topics that will be
> > +merged to master looks like.
> > +
> > +seen::
> > +This is the most bleeding edge branch where all excited
> > +developments happened. All proposed topics are queued in seen
> > +by the maintainer. However, these may be buggy (have breakage or
> > +regressions). When topics queued are deemed good and ready for
> > +inclusion, they are graduated to next for stabilization.
> 
> This is inconsistent with what has been written elsewhere about this
> integration branch.  In short, you should not read anything more
> than "the maintainer happens to have seen these topics" out of the
> fact that a topic is in 'seen'.  Not all proposed topics will be in
> this branch, and a branch that was in 'seen' on one day may not be
> there the next day, but that does not mean anything (certainly it
> does not mean the topic has been "rejected").

Well, I think most of this document's points has been written in Documentation/howto/maintain-git.txt and Documentation/SubmittingPatches.txt.

With only 2 above points, I think if we have this document in, we'll have more things to maintain :shrug:

-- 
Danh
Previous: Junio C HamanoNext: Bagas Sanjaya
Message 3 of 5 in “Documentation/howto: tracking git.git”
  1. Documentation/howto: tracking git.gitBagas Sanjaya, May 14, 2021
  2. Junio C HamanoMay 14, 2021
  3. Đoàn Trần Công DanhMay 14, 2021
  4. Bagas SanjayaMay 15, 2021
  5. Junio C HamanoMay 16, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.