Blame Manual/Directories/trunk/Identity/Themes.texi

41622d
@subheading Goals
d18d63
d18d63
The @file{trunk/Identity/Themes/} directory exists to organize
d18d63
production of CentOS themes.
d18d63
41622d
@subheading Description
d18d63
41622d
@subsubheading Work Flow
87b0e4
87b0e4
Initially, we start working themes on their trunk development line
87b0e4
(e.g., @file{trunk/Identity/Themes/Motifs/TreeFlower/}), here we
87b0e4
organize information that cannot be produced automatically (i.e.,
87b0e4
background images, concepts, color information, screenshots, etc.).
87b0e4
87b0e4
Later, when theme trunk development line is considered ``ready'' for
87b0e4
implementation (e.g.,  all required backgrounds have been designed),
87b0e4
we create a branch for it (e.g.,
87b0e4
@file{branches/Identity/Themes/Motifs/TreeFlower/1/}).  Once the
87b0e4
branch has been created, we forget that branch and continue working
87b0e4
the trunk development line while others (e.g., an artwork quality
87b0e4
assurance team) test the new branch for tunning it up. 
87b0e4
87b0e4
Once the branch has been tunned up, and considered ``ready'' for
87b0e4
release, it is freezed under @file{tags/} directory (e.g.,
87b0e4
@file{tags/Identity/Themes/Motifs/TreeFower/1.0/}) for packagers,
87b0e4
webmasters, promoters, and anyone who needs images from that CentOS
87b0e4
theme the tag was created for.
87b0e4
87b0e4
Both branches and tags, inside CentOS Artwork Repository, use
87b0e4
numerical values to identify themselves under the same location.
87b0e4
Branches start at one (i.e., @samp{1}) and increment one unit for each
87b0e4
branch created from the same trunk development line.  Tags start at
87b0e4
zero (i.e., @samp{0}) and increment one unit for each tag created from
87b0e4
the same branch development line.
87b0e4
87b0e4
@quotation
87b0e4
@strong{Convenction} Do not freeze trunk development lines using tags
87b0e4
directly.  If you think you need to freeze a trunk development line,
87b0e4
create a branch for it and then freeze that branch instead.
87b0e4
@end quotation
87b0e4
87b0e4
The trunk development line may introduce problems we cannot see
87b0e4
immediatly. Certainly, the high changable nature of trunk development
87b0e4
line complicates finding and fixing such problems. On the other hand,
87b0e4
the branched development lines provide a more predictable area where
87b0e4
only fixes/corrections to current content are commited up to
87b0e4
repository. 
87b0e4
87b0e4
If others find and fix bugs inside the branched development line, we
87b0e4
could merge such changes/experiences back to trunk development line
87b0e4
(not visversa) in order for future branches, created from trunk, to
87b0e4
benefit.
87b0e4
87b0e4
Time intervals used to create branches and tags may vary, just as
87b0e4
different needs may arrive. For example, consider the release schema
87b0e4
of CentOS distribution: one major release every 2 years, security
87b0e4
updates every 6 months, support for 7 years long. Each time a CentOS
87b0e4
distribution is released, specially if it is a major release, there is
87b0e4
a theme need in order to cover CentOS distribution artwork
87b0e4
requirements. At this point, is where CentOS Artwork Repository comes
87b0e4
up to scene. 
87b0e4
87b0e4
Before releasing a new major release of CentOS distribution we create
87b0e4
a branch for one of several theme development lines available inside
87b0e4
the CentOS Artwork Repository, perform quality assurance on it, and
87b0e4
later, freeze that branch using tags. Once a the theme branch has been
87b0e4
frozen (under @file{tags/} directory), CentOS Packagers (the persons
87b0e4
whom build CentOS distribution) can use that frozen branch as source
87b0e4
location to fulfill CentOS distribution artwork needs. The same
87b0e4
applies to CentOS Webmasters (the persons whom build CentOS websites),
87b0e4
and any other visual manifestation required by the project.
87b0e4
41622d
@subheading Usage
d18d63
d18d63
In this location themes are organized in ``Models'' ---to store common
d18d63
information--- and ``Motifs''---to store unique information.  At
d18d63
rendering time, both motifs and models are combined to produce the
d18d63
final CentOS themes.  CentOS themes can be tagged as ``Default'' or
d18d63
``Alternative''. CentOS themes are maintained by CentOS community. 
d18d63
d18d63
@menu
be55d4
* Directories trunk Identity Themes Models::
be55d4
* Directories trunk Identity Themes Motifs::
d18d63
@end menu
d18d63
41622d
@subheading See also
d18d63
d18d63
@menu
be55d4
* Directories trunk Identity::
be55d4
* Directories trunk:: 
d18d63
@end menu