Blame Manuals/TCAR-UG/Repository/Convenctions/worklines.docbook

3c5068
<sect1 id="repo-convs-worklines">
3c5068
3c5068
    <title>Repository Work Lines</title>
3c5068
3c5068
    <para>
3c5068
        To organize content production inside &TCAR;, production has
3c5068
        been divided into individual work lines that relate one
3c5068
        another based on the idea of doing one thing well. Later, the
3c5068
        results produced individually by each work line are combined
3c5068
        to achieve a higher purpose. Work lines, as conceived here,
3c5068
        provide the relayable output components the production cycle
3c5068
        inside &TCAR; needs to let everyone to work syncronized in a
3c5068
        descentralized environment.
3c5068
    </para>
3c5068
3c5068
    <sect2 id="repo-convs-worklines-idenity">
3c5068
3c5068
    <title>Visual Identity</title>
3c5068
3c5068
    <para>
3c5068
        In the production cycle, the first step takes place through
3c5068
        graphic design. It is focused on preparing design models for
3c5068
        all the visual manifestation &TC;; is made of.  Here, graphic
3c5068
        designers describe the visual characteristics of each visual
3c5068
        manifestation (e.g., image dimensions, position of text in the
3c5068
        visible area, translation markers, etc.).  
3c5068
        Later, once design models have been defined, graphic designers
3c5068
        take care of artistic motifs to define the visual style of
3c5068
        those design models already created (e.g., how they look and
3c5068
        feel).  
3c5068
    </para>
3c5068
        
3c5068
    <para>
3c5068
        Finally, graphic designers use the
3c5068
        <function>render</function> functionality of
3c5068
        <command>centos-art.sh</command> script to combine both design
3c5068
        models and artistic motifs in order to produce the final
3c5068
        images required by each visual manifestaions.
3c5068
    </para>
3c5068
3c5068
    </sect2>
3c5068
3c5068
    <sect2 id="repo-convs-worklines-l10n">
3c5068
3c5068
    <title>Localization</title>
3c5068
3c5068
    <para>
3c5068
        The second step in the production cycle is to localize
3c5068
        source files (e.g., SVG, DocBook, Shell scripts). This step
3c5068
        makes possible to produce localized images, localized
3c5068
        documentation and localized automation scripts.
3c5068
    </para>
3c5068
    
3c5068
    <para>
3c5068
        The localization tasks are carried on by translators using the
3c5068
        <function>locale</function> functionality of the
3c5068
        <command>centos-art.sh</command> script which take care of
3c5068
        retriving translatable strings from source files and provide a
3c5068
        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
3c5068
    </sect2>
3c5068
3c5068
    <sect2 id="repo-convs-worklines-manuals">
3c5068
3c5068
    <title>Documentation</title>
3c5068
3c5068
    <para>
3c5068
        The third step in the production cycle is to document &TCAR;,
3c5068
        what it is and how to use it. This step provides the
3c5068
        conceptual ideas used as base to edificate &TCPCVI; and is
3c5068
        implemented through &TCARUG;.
3c5068
    </para>
3c5068
3c5068
    <para>
3c5068
        To write documentation, documentors use the
3c5068
        <function>help</function> functionality of
3c5068
        <command>centos-art.sh</command> script which provide an
3c5068
        consistent interface for building documentation through
3c5068
        different documentation backends (e.g., Texinfo and DocBook).
3c5068
    </para>
3c5068
3c5068
    </sect2>
3c5068
3c5068
    <sect2 id="repo-convs-worklines-scripts">
3c5068
3c5068
    <title>Automation</title>
3c5068
3c5068
    <para>
3c5068
        The fourth step in the production cycle is to automate
3c5068
        frequent tasks inside &TCAR;. This step closes the production
3c5068
        cycle and provides the production standards needed by all
3c5068
        different work lines to coexist together.  Here is where
3c5068
        the <command>centos-art.sh</command> script and all
3c5068
        its functionalities (e.g., <function>render</function> for
3c5068
        rendition, <function>help</function> for documentation,
3c5068
        <function>locale</function> for localization, etc.) are
3c5068
        developed.
3c5068
    </para>  
3c5068
3c5068
    <para>
3c5068
        At this point it should be obvious, but we consider worth to
3c5068
        remember that: there is no need to type several tasks, time
3c5068
        after time, if they can be programmed into just one executable
3c5068
        script. 
3c5068
    </para>
3c5068
3c5068
    </sect2>
3c5068
3c5068
</sect1>