Blame Documentation/Tcar-ug/Repository/Convenctions/worklines.docbook

3c5068
<sect1 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
c6510a
        here, provide a relaible environment for people to work
c6510a
        syncronized and descentralized.
c6510a
    </para>
c6510a
c6510a
    <para>
4ffac7
        The action of combining work lines inside &TCAR; is known as
4ffac7
        the corporate identity production cycle. The rest of this
4ffac7
        section describes the work lines available in the repository
4ffac7
        and how they fit inside the corporate identity production
4ffac7
        cycle.
3c5068
    </para>
3c5068
3c5068
    <sect2 id="repo-convs-worklines-idenity">
3c5068
3c5068
    <title>Visual Identity</title>
3c5068
3c5068
    <para>
c6510a
        The visual identity is the first component we work out in
c6510a
        order to produce a new corporate identity.  Through this work
c6510a
        line, graphic designers create <quote>models</quote> and
c6510a
        <quote>motifs</quote> for all the visual manifestation &TC;;
c6510a
        is made of.  Once design models and artistic motifs are set in
c6510a
        place, graphic designers use the <function>render</function>
c6510a
        functionality described in 
c6510a
        /> to combine both design models and artistic motifs into
c6510a
        final images.
c6510a
    </para>
c6510a
c6510a
    <para>
c6510a
        The main purposes of this work line is define all the visual
c6510a
        manifestations the &TC;; is made of and provide design models
c6510a
        and artistic motifs for them in order to render the set of
c6510a
        images required to transmit the visual style that identifies
c6510a
        &TC;; as unique organization. To know more about &TCPCVI;,
c6510a
        read <xref linkend="identity" />.
3c5068
    </para>
c6510a
3c5068
    <para>
c6510a
        The visual identity work line takes palce in the 
c6510a
        url="https://projects.centos.org/svn/artwork/trunk/Identity">
c6510a
        class="directory">trunk/Identity</filename></ulink> directory.
3c5068
    </para>
3c5068
c6510a
3c5068
    </sect2>
3c5068
3c5068
    <sect2 id="repo-convs-worklines-l10n">
3c5068
3c5068
    <title>Localization</title>
3c5068
3c5068
    <para>
c6510a
        The content localization is the second component that must be
c6510a
        worked out in the corporate identity production cycle.
c6510a
        Through this work line translators localize source files
c6510a
        (e.g., SVG, DocBook, Shell scripts) which are later use to
c6510a
        produce localized images, localized documentation and
c6510a
        localized automation scripts.  To localize source files,
c6510a
        translators use 
c6510a
        the <function>locale</function> functionality described in
c6510a
        <xref linkend="scripts-bash-locale" /> which takes 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
c6510a
    <para>
c6510a
        The main purpose of this work line is extend the visual
c6510a
        identity (produced in English language) to as many native
c6510a
        languages as possible in order for people which doesn't
c6510a
        understand English languague to feel more confortable with
c6510a
        &TC;; and its messages. To know more about the specific
c6510a
        localization process read <xref linkend="locale" />.
c6510a
    </para>
c6510a
c6510a
    <para>
c6510a
        The localization work line takes palce in the 
c6510a
        url="https://projects.centos.org/svn/artwork/trunk/Locales">
c6510a
        class="directory">trunk/Locales</filename></ulink> directory.
c6510a
    </para>
c6510a
3c5068
    </sect2>
3c5068
3c5068
    <sect2 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 
c6510a
        url="https://projects.centos.org/svn/artwork/trunk/Manuals">
c6510a
        class="directory">trunk/Manuals</filename></ulink> directory.
3c5068
    </para>
3c5068
c6510a
    </sect2>
c6510a
c6510a
    <sect2 id="repo-convs-worklines-packaging">
c6510a
    <title>Packaging</title>
c6510a
3c5068
    <para>
4ffac7
        The packaging 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>
4ffac7
        The packaging work line takes palce in the 
4ffac7
        url="https://projects.centos.org/svn/artwork/trunk/Packages">
4ffac7
        class="directory">trunk/Packages</filename></ulink> directory.
3c5068
    </para>
3c5068
3c5068
    </sect2>
3c5068
3c5068
    <sect2 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 
c6510a
        url="https://projects.centos.org/svn/artwork/trunk/Scripts">
c6510a
        class="directory">trunk/Scripts</filename></ulink> directory.
3c5068
    </para>
3c5068
3c5068
    </sect2>
3c5068
3c5068
</sect1>