source: main/trunk/documentation/src/main/webapp/xml/html_content/about/Welcome.xml @ 25316

Last change on this file since 25316 was 25316, checked in by GarthBraithwaite_STG, 2 months ago

docs - moved html_content sub dirs to main html_content for v3 upgrade.

File size: 7.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2
3<HTML_CONTENT xmlns:ibis="http://www.ibisph.org">
4
5        <ibis:doc>
6                <name>home/Welcome</name>
7                <summary>Documentation Page</summary>
8                <description>
9                </description>
10
11                <author>Garth Braithwaite</author>
12                <company>Utah Department of Health/Software Technology Group</company>
13
14        </ibis:doc>
15
16
17        <TITLE>IBIS-PH System Documentation - Welcome</TITLE>
18
19
20        <CONTENT>
21                Welcome to the IBIS-PH System Documentation.  This page provides an overview
22                of the system documentation for the three applications that comprise the
23                IBIS-PH system (View, IBIS-Q, Data Admin).  This documentation does NOT include
24                end user documentation.  It is intended to aid system administrators, content
25                managers, application developers, and potential adopting agencies learn how
26                to install, extend, and manage the IBIS applications.  Please see the
27                <a href="#prerequisits">Reader Prerequisite Knowledge</a> section below
28                which describes the intended reader audience and the requisite knowledge
29                needed for the content contained on this site.
30                <br/><br/>
31
32                <div class="Error">
33                        <h2>Documentation Status:</h2>
34                        Due to limited funding, the documentation presented on this site is not
35                        complete nor has it been proofed or edited.  The View System documentation
36                        is up to date for System Information, Installation, and Content Management
37                        other than the IBIS-Q related pages.  The appendicies are mostly accurate
38                        but not 100% proofed or complete.  The various reports listed have not
39                        been tested recently and most likely do not work.  The IBIS-Q documentation
40                        is lacking in all areas other than the content management section and
41                        Appendix A - of which neither has been proofed.  The Data Maint and Admin
42                        documentation is complete for System Information and Installation but has
43                        not been proofed.  The IBIS-PH Admin Technical Reference is an MS-Word
44                        document and is quite old but the database data element definitions are
45                        still mostly correct and accurate in this document.
46                </div><br/>
47
48                <h2>Documentation Orgainization:</h2>
49                The documentation is organized into three sections which correspond to the
50                three IBIS-PH web applications (see the <a ibis:href="home/Architecture.html">Architecture</a>
51                page for a more detailed definition of each application and where it fits). 
52                Each application's section documentation is then broken down into a series
53                of high level categories.  Each category contains an introduction or overview
54                type page that describes what type of pages and information that are contained
55                within the category.  The main categories that are consistent across all
56                application documentation sections include:
57
58                <ul class="ExtraWhiteSpace">
59                        <li><h3>System Information</h3>
60                                This category contains pages that are helpful to understand the
61                                application from the 30,000 foot level like architecture, features,
62                                requirements, naming conventions, the directory structure and files
63                                descriptions.
64                        </li>
65                        <li><h3>Administration/Installation</h3>
66                                This category provides the details on how to setup and install the
67                                application, how to configure and customize it, as well as any system
68                                issue type pages.
69                        </li>
70                        <li><h3>Content Management</h3>
71                                These pages are task oriented and provide the needed information on
72                                how the "super/power user" can understand and maintain the "data" or
73                                content presented.
74                        </li>
75                </ul>
76                <br/>
77
78                Other high level categories are typically referred to as an "Appendix". 
79                These appendices contain technical reference information.  Examples are:
80
81                <ul class="ExtraWhiteSpace">
82                        <li><h3>Implementation Reference</h3>
83                                Contains pages that describe the actual design and lower level
84                                implementation detail.  This includes topics like request flows,
85                                how errors are handled, URL parameters and what they do, etc.
86                        </li>
87                        <li><h3>Technical Reference Categories</h3>
88                                These include pages that provide detailed information like Java Docs,
89                                XSLT APIs, data file element descriptions/model pages, view related
90                                topics, special reports etc.
91                        </li>
92                </ul><br/>
93
94                <a name="prerequisits"/>
95                <div style="font-size: 0.9em;">
96                        <h2>Audience and Reader Prerequisite Knowledge</h2>
97                        The intended audience for this documentation includes directors, program
98                        managers, web content managers, system administrators, system developers,
99                        and project managers.  This documentation does NOT include any end user
100                        documentation nor does it provide use cases or any of the Unified Process's
101                        documentation artifacts. 
102                        <br/><br/>
103
104                        The System Overview type sections provide high level general information
105                        that is applicable to all types of users like project managers, system
106                        administrators, software developers, and content managers.  The content
107                        management sections are geared toward the "super user" or "power user"
108                        who have specific knowledge about web content but does not have system
109                        developer or administration skills needed to deal with the core black
110                        box application code (Java, JSPs, Javascript, XSLTs, C, etc.).  These
111                        content manager type users do have to know about XML and the type of
112                        content contained within those elements and what those elements do.
113                        Another type of content manager user is the backend SAS data expert.
114                        These users need to know how to deal with SAS, SAS Datasets, and SAS
115                        programming in general.  They also will need to know how the IBISQ CGI
116                        application control files work and how to edit those files.
117                        <br/><br/>
118
119                        The balance of the documentation is geared toward seasoned Java web
120                        application system administrators, Java web developers, RDBMS DBAs,
121                        and to a certain degree web developers.  The intent is to provide just
122                        enough information so that this type of reader can semi understand,
123                        install, deploy, and extend the system.  If the reader does not have
124                        the perquisite Java application server, Java development, web (HTML,
125                        CSS, Javascript), XML, RDBMS/DBA skills experience/knowledge for that
126                        given topic then they will need to reference other sites/materials to
127                        learn about that technology before being able to understand the
128                        content presented on this site.
129                </div><br/>
130
131                <div class="Note">
132                        This documentation site uses the IBIS-PH View System's transformation
133                        engine, CSS, and XSLTs.  Most documentation pages are presented as HTML
134                        pages (which are simply HTML_CONTEXT XML files transformed via the
135                        appropriate HTMLContent.xslt to produce the html page).  As such most
136                        have the typical left hand menu navigation and the ability to be formatted
137                        as a printer friendly page etc.  Other pages, like the Java API docs
138                        are true stand alone HTML pages (created independently) which means
139                        that these pages do NOT have the IBIS-PH Documentation System's
140                        navigation or look and feel.  When viewing these pages, the reader
141                        will simply have to rely on their browser's back button etc.  Finally,
142                        other parts of the system documentation are delivered as MS-Word
143                        documents, Visio diagrams etc. and will need these applications for
144                        viewing and likewise will not have navigation etc.
145                        <br/><br/>
146
147                        If there are problems found with content meaning, spelling, grammar,
148                        or questions in general please contact <a href="mailto:ibis@utah.gov">Utah's
149                        IBIS-PH System Administrator</a>.
150                </div>
151
152        </CONTENT>
153</HTML_CONTENT>
154
Note: See TracBrowser for help on using the repository browser.