Blame Documentation/Models/Docbook/Tcar-ug/Repository/Conventions/worklines.docbook

cc88a3
<section id="repo-convs-worklines">
3c5068
3c5068
    <title>Repository Work Lines</title>
3c5068
3c5068
    <para>
c6510a
        The content production inside &TCAR; has been divided into
c6510a
        individual work lines that relate one another based on the
c6510a
        idea of doing one thing well. In this model, the content
c6510a
        produced individually by each work line is combined one
c6510a
        another later to achieve higher purposes (e.g., corporate
c6510a
        identity for &TC;;). The repository work lines, as conceived
Alain Reguera Delgado 1e543d
        here, provide a reliable environment for people to work
Alain Reguera Delgado 1e543d
        synchronized and decentralized.
c6510a
    </para>
c6510a
c6510a
    <para>
Alain Reguera Delgado 1e543d
        The action of combining work lines inside &TCAR; is also known
Alain Reguera Delgado 1e543d
        as the <quote>Production Cycle</quote> of CentOS corporate
Alain Reguera Delgado 1e543d
        visual identity. The rest of this section describes the work
Alain Reguera Delgado 1e543d
        lines available in the repository and how they integrate one
Alain Reguera Delgado 1e543d
        another.
3c5068
    </para>
3c5068
Alain Reguera Delgado 1e543d
    <section id="repo-convs-worklines-artworks">
3c5068
Alain Reguera Delgado 1e543d
    <title>Artworks</title>
3c5068
3c5068
    <para>
Alain Reguera Delgado 1e543d
        <emphasis>Artworks</emphasis> is the first component we work
Alain Reguera Delgado 1e543d
        out in order to produce new corporate visual identities.
Alain Reguera Delgado 1e543d
        Through this work line, graphic designers create
Alain Reguera Delgado 1e543d
        <quote>models</quote> and <quote>motifs</quote> for all the
Alain Reguera Delgado 1e543d
        visual manifestation &TC;; is made of.  Once design models and
Alain Reguera Delgado 1e543d
        artistic motifs are set in place, graphic designers use the
Alain Reguera Delgado 1e543d
        <xref linkend="scripts-bash-render" /> functionality to
Alain Reguera Delgado 1e543d
        combine them into final images.
c6510a
    </para>
c6510a
c6510a
    <para>
Alain Reguera Delgado 1e543d
        The mission of <emphasis>Artworks</emphasis> work line is
Alain Reguera Delgado 1e543d
        define all the visual manifestations the &TC;; is made of and
Alain Reguera Delgado 1e543d
        provide design models and artistic motifs for them in order to
Alain Reguera Delgado 1e543d
        produce the image files required to transmit the visual style
Alain Reguera Delgado 1e543d
        that identifies &TC;; as unique organization.
3c5068
    </para>
c6510a
3c5068
    <para>
Alain Reguera Delgado 1e543d
        To know more about &TCPCVI;, read <xref linkend="identity" />.
3c5068
    </para>
3c5068
cc88a3
    </section>
3c5068
cc88a3
    <section id="repo-convs-worklines-l10n">
3c5068
3c5068
    <title>Localization</title>
3c5068
3c5068
    <para>
Alain Reguera Delgado 1e543d
        <emphasis>Localization</emphasis> is the second component that
Alain Reguera Delgado 1e543d
        must be worked out in the production cycle of CentOS corporate
Alain Reguera Delgado 1e543d
        visual identity.  Through this work line translators localize
Alain Reguera Delgado 1e543d
        source files (e.g., SVG, DocBook, Shell scripts) which are
Alain Reguera Delgado 1e543d
        later used to produce localized images, localized
Alain Reguera Delgado 1e543d
        documentation and localized automation scripts.  To localize
Alain Reguera Delgado 1e543d
        source files, translators use the 
Alain Reguera Delgado 1e543d
        linkend="scripts-bash-locale" /> functionality which takes
Alain Reguera Delgado 1e543d
        care of retrieving translatable strings from source files and
Alain Reguera Delgado 1e543d
        provide a consistent localization interface based on GNU
3c5068
        <application>gettext</application> multi-lingual message
3c5068
        production tool set and <command>xml2po</command> command.
3c5068
    </para>
3c5068
c6510a
    <para>
Alain Reguera Delgado 1e543d
        The localization process takes place inside the
Alain Reguera Delgado 1e543d
        <quote>
Alain Reguera Delgado 1e543d
        class="directory">Localization/</filename></quote> directory
Alain Reguera Delgado 1e543d
        in the first level of each repository directory structure.
Alain Reguera Delgado 1e543d
        This directory mirrors the renderable directory structures
Alain Reguera Delgado 1e543d
        outside it and stores 
Alain Reguera Delgado 1e543d
        class="extension">.po</filename> and 
Alain Reguera Delgado 1e543d
        class="extension">.pot</filename> files mainly.
c6510a
    </para>
c6510a
c6510a
    <para>
Alain Reguera Delgado 1e543d
        The mission of <emphasis>Localization</emphasis> work line is
Alain Reguera Delgado 1e543d
        extend the visual identity (produced in English language) to
Alain Reguera Delgado 1e543d
        as many native languages as possible, in order for people
Alain Reguera Delgado 1e543d
        which doesn't understand English language to feel more
Alain Reguera Delgado 1e543d
        comfortable with &TC;; in their own native languages.
Alain Reguera Delgado 1e543d
    </para>
Alain Reguera Delgado 1e543d
    
Alain Reguera Delgado 1e543d
    <para>
Alain Reguera Delgado 1e543d
        To know more about the specific localization process read
Alain Reguera Delgado 1e543d
        <xref linkend="locale" />.
c6510a
    </para>
c6510a
cc88a3
    </section>
3c5068
cc88a3
    <section id="repo-convs-worklines-manuals">
3c5068
3c5068
    <title>Documentation</title>
3c5068
3c5068
    <para>
c6510a
        The documentation work line is the third component that must
c6510a
        be worked out in the corporate identity production cycle.
c6510a
        Through this work line documentors settle down the conceptual
c6510a
        and practical used to edificate &TCAR;.  To write
c6510a
        documentation, documentors use the <function>help</function>
c6510a
        functionality described in 
c6510a
        /> which provides a consistent interface for building
c6510a
        documentation through different documentation backends (e.g.,
c6510a
        Texinfo, DocBook, LaTeX, etc.).
c6510a
    </para>
c6510a
c6510a
    <para>
c6510a
        The main purpose of this work line is describe the standard
c6510a
        procedures &TCAR; realies on, as well as conceive a place to
c6510a
        help you understand what &TCAR; is and what can you do with
c6510a
        it.
c6510a
    </para>
c6510a
c6510a
    <para>
c6510a
        The documentation work line takes palce in the 
47422e
        url="https://projects.centos.org/~al/artwork.git/Manuals">
47422e
        class="directory">Manuals</filename></ulink> directory.
3c5068
    </para>
3c5068
cc88a3
    </section>
c6510a
Alain Reguera Delgado 1e543d
    <section id="repo-convs-worklines-packages">
Alain Reguera Delgado 1e543d
    <title>Packages</title>
c6510a
3c5068
    <para>
Alain Reguera Delgado 1e543d
        The packages work line is the fourth component that must be
4ffac7
        worked out in the corporate identity production cycle. Through
4ffac7
        this work line packager gather final images, final
4ffac7
        translations and final documentation related to art works and
4ffac7
        put all together inside RPM packages. For this purpose,
4ffac7
        packagers use the <function>pack</function> describe in
4ffac7
        <xref linkend="scripts-bash-pack" /> which provides a
4ffac7
        consistent interface for building packages inside the
4ffac7
        repository.
4ffac7
    </para>
4ffac7
4ffac7
    <para>
4ffac7
        The main purpose of this work line is pack all the information
4ffac7
        &TC;; requires to rebrand &TC;; according Red Hat
4ffac7
        redistribution guidelines.
4ffac7
    </para>
4ffac7
4ffac7
    <para>
Alain Reguera Delgado 1e543d
        The packages work line takes palce in the 
47422e
        url="https://projects.centos.org/~al/artwork.git/Packages">
47422e
        class="directory">Packages</filename></ulink> directory.
3c5068
    </para>
3c5068
cc88a3
    </section>
3c5068
cc88a3
    <section id="repo-convs-worklines-scripts">
3c5068
3c5068
    <title>Automation</title>
3c5068
3c5068
    <para>
c6510a
        The automation work line is the fifth and last component that
c6510a
        must be worked out in the corporate identity production cycle.
c6510a
        This work line closes the production cycle and provides the
c6510a
        production standards graphic designers, documentors,
c6510a
        translators and packagers need to make their work consistent
c6510a
        and reusable.  For this purpose, programmers develop the
c6510a
        <command>centos-art.sh</command> script described in 
c6510a
        linkend="scripts" />.
c6510a
    </para>
c6510a
c6510a
    <para>
c6510a
        The main purpose of this work line is standardize the
c6510a
        interaction of work lines in a reliable way.
c6510a
    </para>
3c5068
3c5068
    <para>
c6510a
        The automation work line takes palce in the 
47422e
        url="https://projects.centos.org/~al/artwork.git/Scripts">
47422e
        class="directory">Scripts</filename></ulink> directory.
3c5068
    </para>
3c5068
cc88a3
    </section>
3c5068
cc88a3
</section>