Differences between revisions 1 and 3 (spanning 2 versions)
Revision 1 as of 2015-05-21 03:26:01
Size: 619
Comment:
Revision 3 as of 2015-05-21 15:49:13
Size: 1550
Editor: AugieFackler
Comment:
Deletions are marked like this. Additions are marked like this.
Line 11: Line 11:
assign topics to non-public changesets Assign topics to non-public changesets. A topic is like a named branch, in that it is a label on a changeset (the initial prototype even stores the topic in the extra area in the changeset), but that topics just disappear when the change moves to public phase.
Line 15: Line 15:
=== What Topic solve === === What Topic solves ===
Line 17: Line 17:
(Use case Topic target to address) Bookmarks are a clone of git's refs, which seems to work more poorly in Mercurial than they do in Git, in part because the synchronization parts of bookmarks aren't really done. Adding the remaining functionality to bookmarks has been challenging, and seems to be adding a lot of conceptual complexity around configuration of the synchronization mechanism that AugieFackler finds frustrating.

The current implementation also makes it possible to say "what patches did I do while working on topic `issue1234`", which might be nice.
Line 27: Line 29:
== Principe == == Open Question ==
Line 29: Line 31:
 * Right now we use changeset extra for storing the topic. That might lead to bonus divergence problems.
 * Should changesets be allowed multiple topics?
 * How permissive should we be on topic names?

Note:

This page is primarily intended for developers of Mercurial.

A plan for light weight branching/categorization what would work with other Mercurial principle and actual DVCS idea.

Still a very early prototype stage.

Principle

Assign topics to non-public changesets. A topic is like a named branch, in that it is a label on a changeset (the initial prototype even stores the topic in the extra area in the changeset), but that topics just disappear when the change moves to public phase.

Problem solved

1. What Topic solves

Bookmarks are a clone of git's refs, which seems to work more poorly in Mercurial than they do in Git, in part because the synchronization parts of bookmarks aren't really done. Adding the remaining functionality to bookmarks has been challenging, and seems to be adding a lot of conceptual complexity around configuration of the synchronization mechanism that AugieFackler finds frustrating.

The current implementation also makes it possible to say "what patches did I do while working on topic issue1234", which might be nice.

2. What Topic may solve

(Use case that exists but it is not clear if Topic should try to solve them)

3. What Topic do not solve

(Use case we know belong to other feature)

Open Question

  • Right now we use changeset extra for storing the topic. That might lead to bonus divergence problems.
  • Should changesets be allowed multiple topics?
  • How permissive should we be on topic names?


CategoryDeveloper and CategoryNewFeatures

TopicPlan (last edited 2021-10-08 14:11:59 by GeorgesRacinet)