LUMIERA.clone/doc/devel/rfc/MasterRepositorySetup.txt
Ichthyostega 051cb31e28 clean-up: re-classify essential RfCs
The RfC documents were written to complement discussions of the Lumiera developers;
yet since the time where ''Ichthyo'' is working basically alone on the project,
this kind of discussions have ceased. During the following years, some ideas
promoted by the existing RfC documents became rather detached from the
actual state of development in the code base.

Many of the existing RfC documents require some commentary to place them
into context, and some of the decisions taken in the early stage of the
project should be **re-assessed**. This includes the decision to reject
some proposals, which initially might have seemed desirable, yet could not
be reconciled with the understanding of the matter and topic in question,
as was gained through the ongoing analysis and development.
2025-10-08 00:48:13 +02:00

81 lines
3.2 KiB
Text

Design Process : Master Repository
==================================
[options="autowidth"]
|====================================
|*State* | _Final_
|*Date* | _2008-04-08_
|*Proposed by* | ct
|====================================
Shared Master Repository setup
------------------------------
This describes how the shared MASTER is set up and syncronized.
Description
~~~~~~~~~~~
We have now a shared master repository in
https://git.lumiera.org/?p=LUMIERA;a=summary[/git/LUMIERA].
- The public/anonymous git url is [yellow-background]#`git://git.lumiera.org/LUMIERA`#
- for people with ssh access it is pushable at [purple]#`UID@git.lumiera.org:/git/LUMIERA`#.
The repository is maintained by _cehteh_. It updates daily by a script.
There are the following branches updated from their respective maintainer repositories:
[options="header", cols="^m,3<,2e"]
|====================================
|BRANCHNAME | DESCRIPTION | Updated from...
| master | Stable branch; generic entry point. | cehteh, ichthyo
| library | Support library development | cehteh, ichthyo
| proc | Render core development | ichthyo
| backend | Data backend development, | cehteh
| gui | GUI development | joel
|====================================
Automatic syncronization is only done for `fast-forward' updates, conflicting
changes are rejected. It is still possible to manually push to this repository
to override automatic syncronization.
Comments
--------
Instead of this polling @daily update, maintainers might use git hooks on their
repos to push relevant things, be careful not to push cruft or tags (which tags
shall be present here is not yet resolved -> no tags for now)
ct:: '2008-04-08T21:48:51Z'
''''
[[historical_remark]]
[underline]#Historical remark#: This RfC describes the setup we used up to ~2012. +
After that point, I was working alone basically (not counting occasional small contributions),
and consequently the current state could be found in the ``ichthyo'' Git repository
most of the time -- yet the shared master repository is still updated occasionally,
as is a mirror at https://github.com/Ichthyostega/Lumiera/[Github]
This summer I decided to switch the project over to the
link:{ldoc}/technical/code/GitBranching.html[Git-flow] branching model,
knowing from my own professional background that this scheme is a good fit
for this kind of project.
This has the consequence however that the usage pattern described in this RfC
*becomes obsolete*, as actual development mostly takes place on development or
feature branches now, consolidating all progress into the branch `integration`.
The branch `master` carries only tested and released code going forward.
That being said -- the shared master at [yellow-background]#`git://git.lumiera.org/LUMIERA`#
still contains the _official_ state of the Lumiera codebase, while
actual development is published first in a repository per developer
(so effectively in
https://git.lumiera.org/?p=lumiera/ichthyo;a=summary[the Ichthyo repository]
for the time being);
development is consolidated intermittently into the
https://git.lumiera.org/?p=LUMIERA;a=summary[LUMIERA Git].
''''
Back to link:/x/DesignProcess.html[Lumiera Design Process overview]