Blame Manual/repository-html/repository_7.html

ee1f37
ee1f37
<html>
d1db00
d1db00
organization, and administration of CentOS Artwork Repository.
d1db00
d1db00
Copyright C 2009-2011 Alain Reguera Delgado
ee1f37
ee1f37
Permission is granted to copy, distribute and/or modify this document
ee1f37
under the terms of the GNU Free Documentation License, Version 1.2 or
ee1f37
any later version published by the Free Software Foundation; with no
ee1f37
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
ee1f37
copy of the license is included in the section entitled GNU Free
ee1f37
Documentation License.  
ee1f37
-->
9bfd15
ee1f37
ee1f37
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
ee1f37
            Karl Berry  <karl@freefriends.org>
ee1f37
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
ee1f37
            and many others.
ee1f37
Maintained by: Many creative people <dev@texi2html.cvshome.org>
ee1f37
Send bugs and suggestions to <users@texi2html.cvshome.org>
ee1f37
ee1f37
-->
ee1f37
<head>
671838
<title>CentOS Artwork Repository: 2.3 The trunk Directory</title>
ee1f37
671838
<meta name="description" content="CentOS Artwork Repository: 2.3 The trunk Directory">
671838
<meta name="keywords" content="CentOS Artwork Repository: 2.3 The trunk Directory">
ee1f37
<meta name="resource-type" content="document">
ee1f37
<meta name="distribution" content="global">
ee1f37
<meta name="Generator" content="texi2html 1.76">
ee1f37
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
ee1f37
<style type="text/css">
ee1f37
ee1f37
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
ee1f37
ee1f37
a.summary-letter {text-decoration: none}
ee1f37
pre.display {font-family: serif}
ee1f37
pre.format {font-family: serif}
ee1f37
pre.menu-comment {font-family: serif}
ee1f37
pre.menu-preformatted {font-family: serif}
ee1f37
pre.smalldisplay {font-family: serif; font-size: smaller}
ee1f37
pre.smallexample {font-size: smaller}
ee1f37
pre.smallformat {font-family: serif; font-size: smaller}
ee1f37
pre.smalllisp {font-size: smaller}
ee1f37
span.sansserif {font-family:sans-serif; font-weight:normal;}
ee1f37
ul.toc {list-style: none}
ee1f37
-->
ee1f37
</style>
ee1f37
ee1f37
ee1f37
</head>
ee1f37
ee1f37
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
ee1f37
ee1f37
9bfd15
[ < ]
9bfd15
[ > ]
ee1f37
   
671838
[ << ]
671838
[ Up ]
9bfd15
[ >> ]
ee1f37
   
ee1f37
   
ee1f37
   
ee1f37
   
56a476
[Top]
56a476
[Contents]
9bfd15
[Index]
56a476
[ ? ]
ee1f37
671838
9bfd15
671838

2.3 The <tt>`trunk'</tt> Directory

ee1f37
ee1f37
9bfd15
9bfd15

2.3.1 Goals

9bfd15
9bfd15

This directory implements the Subversion's trunk concept in a

9bfd15
trunk, branches, tags repository structure.
9bfd15

9bfd15
9bfd15
9bfd15

2.3.2 Description

9bfd15
9bfd15

The <tt>`trunk/'</tt> directory structure is the main development line

9bfd15
inside the CentOS Artwork Repository. Here is where we produce the
9bfd15
information required by The CentOS Project corporate visual identity.
9bfd15
Additionally, here is where documentation and automation scripts are
9bfd15
conceived to make both understanding and using of CentOS Artwork
9bfd15
Repository easier for everyone.
9bfd15

9bfd15

The <tt>`trunk/'</tt> directory structure covers the following topics:

9bfd15

9bfd15
9bfd15
Identity
9bfd15

This directory organizes the production of images in different formats

9bfd15
and some non-image formats like XHTML and text files, as well. This is
9bfd15
the perfect place to consolidate The CentOS Artwork SIG. If you
9bfd15
are interested in producing art works for The CentOS Project, this
9bfd15
place is for you. 
9bfd15

9bfd15

See section The <tt>`trunk/Identity'</tt> Directory, for more information.

9bfd15

9bfd15
9bfd15
Documentation
9bfd15

This directory organizes the production of CentOS Artwork

9bfd15
Repository Manual (i.e., the place where the documentation you are
9bfd15
reading right now is stored in).  If you are interested on improving
9bfd15
The CentOS Artwork Repository Manual, in this place you'll find the
9bfd15
Texinfo documentation structure you need to work with.
9bfd15

9bfd15

See section The <tt>`trunk/Manual'</tt> Directory, for more information.

9bfd15

9bfd15
9bfd15
Localization
9bfd15

This directory organizes translation messages specifically produced to

9bfd15
satisfy internationalization needs inside the CentOS Artwork
9bfd15
Repository. This place is perfect to consolidate The CentOS
9bfd15
Translation SIG. If you love translating, you'll find lot of messages
9bfd15
waiting for you to translate here.  
9bfd15

9bfd15

See section The <tt>`trunk/Locales'</tt> Directory, for more information.

9bfd15

9bfd15
9bfd15
Automation
9bfd15

This directory organizes the production of centos-art, a

9bfd15
command-line interface specially designed to automate most frequent
9bfd15
tasks in the repository (e.g., image rendition, documenting directory
9bfd15
structures, translating content, etc.).  If you can't resist the idea
9bfd15
of automating repeatable tasks, then take a look here.
9bfd15

9bfd15

See section The <tt>`trunk/Scripts'</tt> Directory, for more information.

9bfd15

9bfd15
9bfd15
9bfd15
9bfd15
9bfd15

2.3.3 Usage

9bfd15
9bfd15

When we need to create branches or tags, the <tt>`trunk/'</tt> directory

9bfd15
structure is the one used as reference to build them. Take a look at
9bfd15
the following directory structure construction and notice how the
9bfd15
<tt>`/Scripts/Bash/Cli'</tt> string is repeated in the paths and how it is
9bfd15
put on it:
9bfd15

9bfd15
9bfd15
<tt>`trunk/Scripts/Bash/Cli'</tt>
9bfd15
9bfd15

This directory structure provides the main development line of the

9bfd15
<tt>`centos-art'</tt> command-line interface written in bash. In this
9bfd15
directory changes may occur pretty fast and in unpredicted ways. This
9bfd15
configuration could provoke that the <tt>`centos-art'</tt> command-line
9bfd15
stop working in a manner unprediceted due the way changes are
9bfd15
introduced to it.
9bfd15

9bfd15
9bfd15
<tt>`branches/Scripts/Bash/Cli/1'</tt>
9bfd15
9bfd15

This directory structure, however, provides an intermediate place for

9bfd15
less unpredicted changes and that way to provide more stability than
9bfd15
<tt>`trunk/'</tt> directory structure is able to provide. 
9bfd15

9bfd15

Notice that we used a number to identify the branch (the number `1' in

9bfd15
this case).  Changing this number we could create several branches
9bfd15
that could be maintained at the same time to fix specific problems
9bfd15
simultaneausly otherwise difficult to fix in an unpredictable area
9bfd15
like that provided by <tt>`trunk/'</tt> directory structure.  Once the
9bfd15
specific problems has been fixed, the branch is merged into
9bfd15
<tt>`trunk/'</tt> and removed from the repository file system.
9bfd15

9bfd15

If you are the only person working in the repository, you probably

9bfd15
don't want to worry about creating branches at all and prefer going
9bfd15
straight from trunk to tags. Ask yourself: If I'm the only person
9bfd15
working in the trunk directory structure whom else could introduce
9bfd15
unpredictable changes but myself? In that case, such changes wouldn't
9bfd15
be unpredictable at all, don't you think? 
9bfd15

9bfd15
9bfd15
<tt>`tags/Scripts/Bash/Cli/1.0'</tt>
9bfd15
9bfd15

Instead of removing the branch directory structure from the repository

9bfd15
file system, it could be very convenient to create a check-point in
9bfd15
time with such problems fixed and so providing a predictable release
9bfd15
of the <tt>`centos-art'</tt> command-line interface.
9bfd15

9bfd15

Notice that we used the number 1.0 to store the tag. These means that

9bfd15
we are creating the tag number 0 from the branch numbered as 1 (i.e.,
9bfd15
the first number before the dot represents the branch number and the
9bfd15
second number after the dot represents the tag number).  
9bfd15

9bfd15

Using the <tt>`centos-art'</tt> command-line from tags diectory structure

9bfd15
does provide more stable results than those from branches or trunk
9bfd15
directory structures. The tags directory structure doesn't introduce
9bfd15
changes at all, so you are safe to get what you expect after reading
9bfd15
the release notes for that tag. This configuration is not possible
9bfd15
supported on trunk nor branches since they do change through time.
9bfd15

9bfd15
9bfd15
9bfd15

It seems to be no other immediate use for this directory but those

9bfd15
described above.
9bfd15

9bfd15
9bfd15
9bfd15

2.3.4 See also

9bfd15
9bfd15
9bfd15
2.1 The <tt>`branches'</tt> Directory  
9bfd15
9bfd15
2.2 The <tt>`tags'</tt> Directory  
9bfd15
9bfd15
9bfd15
9bfd15
ee1f37
ee1f37
9bfd15
[ < ]
9bfd15
[ > ]
ee1f37
   
671838
[ << ]
9bfd15
[ Up ]
9bfd15
[ >> ]
ee1f37
ee1f37

ee1f37
 <font size="-1">
9bfd15
  This document was generated on March, 8 2011 using texi2html 1.76.
ee1f37
 </font>
ee1f37
 
ee1f37
ee1f37

ee1f37
</body>
ee1f37
</html>