diff --git a/Manuals/Repository/Docbook/Introduction/Repoconvs/worklines.docbook b/Manuals/Repository/Docbook/Introduction/Repoconvs/worklines.docbook index 02bd6f8..42403f9 100644 --- a/Manuals/Repository/Docbook/Introduction/Repoconvs/worklines.docbook +++ b/Manuals/Repository/Docbook/Introduction/Repoconvs/worklines.docbook @@ -3,63 +3,91 @@ Work Lines - Content production inside the repository is organized by - work lines. There are three major work - lines of production inside The CentOS Artwork Repository, - which are: Graphic design, - Documentation and - Localization. The specific way of - producing content inside each specific work line is - standardized by mean of centos-art.sh - script (which in turn, can be considered a work line by itself - [e.g., the Automation work line]). The - centos-art.sh script provides one specific - functionality for automating each major work line of content - production (e.g., render for producing images, - help for manage documentation, and - locale for localizing contents). + To organize content production inside &TCAR;, production has + been divided into individual work lines that relate one + another. The is based on the idea of doing one thing well and + later combine the result of each individual part to achieve a + higher purpose. Work lines, as conceived here, provide + relayable output components that combine one another to close + the production cycle inside &TCAR;. - + + + + Graphic Design + - The graphic design work line exists to cover brand design, - typography design and themes design mainly. Additionally, - some auxiliar areas like icon design, illustration design, - brushes design, patterns designs and palettes of colors are - also included here for completeness. The graphic design work - line is organized in the trunk/Identity directory. + In the production cycle, the first step takes place through + graphic design and is focused on preparing design models for + all the visual manifestation &TCP; is made of. Here, graphic + designers describe the visual characteristics of each visual + manifestation (e.g., image dimensions, position of text in the + visible area, translation markers, etc.). Later, once design + models have been defined, graphic designers take care of + artistic motifs to define the visual style of those design + models already created (e.g., how the look and feel). + Furthermore, graphic designers use the + render functionality of + centos-art.sh script to combine both design + models and artistic motifs in order to produce the final + images required by each visual manifestaions. + + + + Localization + - The documentation work line exists to describe what each - directory inside &TCAR; is for, the conceptual ideas behind - them and, if possible, how automation scripts make use of - them. The documentation work line is organized in the - trunk/Manuals - directory. + The second step in the production cycle is to localize + source files (e.g., SVG, DocBook, Shell scripts). This step + makes possible to produce localized images, localized + documentation and localized automation scripts. The + localization tasks are carried on by translators using the + locale functionality of the + centos-art.sh script which take care of + retriving translatable strings from source files and provide a + consistent localization interface based on the ideas behind + GNU gettext multi-lingual message + production. + + + + Documentation + - The localization work line exists to provide the translation - messages required to produce content in different languages. - Translation messages inside the repository are stored as - portable objects (e.g., .po, .pot) and machine objects (.mo). - The localization work line is organized in the trunk/Locales directory. + The third step in the production cycle is to document &TCAR;, + what it is and how to use it. This step provides the + conceptual ideas used as base to edificate &TCPCVI; and is + implemented by mean of &TCARUG;. To write documentation, + documentors use the help functionality of + centos-art.sh script which provide an + consistent interface for building documentation through + different documentation backends (e.g., Texinfo, DocBook). + + + + Automation + - The automation work line exists to standardize content - production inside the working copies of CentOS Artwork - Repository. Here is developed the - centos-art.sh script, a bash script - specially designed to automate most frequent tasks (e.g., - rendition, documentation and localization) inside the - repository. There is no need to type several tasks, time - after time, if they can be programmed into just one executable - script. The automation work line is organized in the - trunk/Scripts - directory. + The fourth step in the production cycle is to automate + frequent tasks inside &TCAR;. This step closes the production + cycle and provides the production standards needed by all + different work lines to coexist together. Here is where we + develop the centos-art.sh script and all + its functionalities (e.g., render for + rendition, help for documentation, + locale for localization, etc.). At this + point it should be obvious, but we consider worth to remember + that: there is no need to type several tasks, time after time, + if they can be programmed into just one executable script. + + +