home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / pdl / gadcdr.min < prev    next >
Encoding:
Text File  |  1988-05-03  |  8.8 KB  |  207 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                 PROCEEDINGS FROM THE GRAPHIC ADA DESIGNER
  7.                          CRITICAL DESIGN REVIEW
  8.  
  9.     The Critical Design Review (CDR) for the Graphic Ada Designer
  10.     (GAD) was conducted 22-23 August 1985 at SYSCON Corporation, San
  11.     Diego Division.  Attendees to the CDR were as follows:
  12.  
  13.         Maj.  T.Courtwright    - WIS/JMPO
  14.         Maj.  J.Maxwell        - WIS/JMPO
  15.         Capt. J.Choiniere    - WIS/JMPO
  16.         Mr.   G.Hawkins        - FBI
  17.         Mr.   A. Brintzenhoff    - Mgr. Ada Technology Group,
  18.                   SYSCON Corporation, SD
  19.         Mr.   S.Christensen    - GAD Project Manager
  20.         Mr.   J.Reddan        - GAD Technical Manager
  21.         Mr.   B.Marek        - GAD Technical Staff
  22.         Mr.   J.Baker        - GAD Technical Staff
  23.         Mr.   J.Long        - GAD Technical Staff
  24.     
  25.     The agenda for the CDR and chronology of the presentation is
  26.     given below as follows:
  27.  
  28.         Introduction                A Brintzenhoff
  29.         Project Overview            S Christensen
  30.         Design Objectives and Requirements    S Christensen
  31.         Macroscopic Design Updates        S Christensen
  32.         Microscopic Design Overview        J Reddan
  33.         Comments On Documentation        J Reddan
  34.         Hands On Demonstration
  35.         Project Issues                J Reddan
  36.         Informal Discussion
  37.  
  38.     The questions, issues and discussion that arose during the
  39.     presentation are presented in the sections below which 
  40.     are Critical Design Review Comments, Documentation Review Comments,
  41.     WIS JPMO Action items.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.     CRITICAL DESIGN REVIEW COMMENTS
  48.  
  49.     The following topics were discussed during the formal
  50.     presentation and hands-on demonstration.
  51.  
  52.     1.  Virtual Package Concept - This conceptual entity provides a
  53.     method of expressing high-level architectural constructs in the
  54.     design.  The software engineering principals of deferring
  55.     architectural details, and promoting abstraction and information
  56.     hiding are provided by the concept.  The virtual package entity
  57.     is consistent with emerging concepts in the literature such as
  58.     SUBSYSTEMS and ENCLOSING_ENTITIES.  (Reference MIL-STD 2167
  59.     concerning the implications for Virtual Packages.)
  60.  
  61.     2.  Project Statistics - The WIS/JMPO representatives all
  62.     indicated it would be extremely useful to gather project related
  63.     statistics (time/effort in the various phases).
  64.  
  65.     3.  Limitations of the DEC Ada Compiler - It was pointed out by
  66.     Maj. Courtwright that the DEC Compiler does not allow single
  67.     character input from the terminal without a concluding <CR>.
  68.     Also, there are significant differences between Versions 4.1 &
  69.     4.2 of the DEC Ada Compiler in multiple areas.  Any problenms or 
  70.     issues will be addressed during the rehosting to the DEC Ada 
  71.     compiler.
  72.  
  73.     4.  Imported Entities - The question was raised if imported
  74.     entities should be retained on a design diagram if there are no
  75.     data or call connections to them.
  76.  
  77.     5.  Generic Instantiations - The question was raised on how to
  78.     handle generic instantiations (eg. [1] split (on same line with
  79.     instantiation name) or [2] show place holder and access PDL via
  80.     editor).
  81.  
  82.     6.  Seperate Compilation (Subunits) - The question of support for
  83.     seperate compilation (subunits) was raised.  The current design
  84.     does not support a separate compilation attribute.  However, an
  85.     "is seperate" statement is used to provide compilable PDL for
  86.     exports which are not connected to actual entities.
  87.  
  88.     7.  MMI Flow Problem - There is a general problem with forcing
  89.     the user to return to the Main Menu when errors occur (there
  90.     should be an alternate way of exiting, to present a menu or
  91.     giving choices via mouse buttons).
  92.     
  93.     8.  Items 3, 4, 5, 6 and 7 above will be assessed during SYSCONs 
  94.     internal evaluation of the GAD; changes, where appropriate, 
  95.     will be made prior to the evaluation in which WIS JPMO personnel 
  96.     will participate.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.     DOCUMENTATION REVIEW COMMENTS
  103.  
  104.     The following comments were received concerning the GAD User's
  105.     Manual, Design Document and Microscopic Design listings.
  106.  
  107.     1.  User's Manual
  108.          a.  Maj Courtwright - Needs to include/expand glossary of
  109.              very specific terminology that is utilized concerning
  110.              the tool.
  111.          b.  Maj Maxwell - The document failed to communicate to the
  112.              user how to navigate the MMI Menu Network.  A step-by-
  113.              step (CAI) scenario is required to provide the necessary
  114.              sequencing and interaction information.  Additionally, 
  115.          the entire menu structure needs to be included in the 
  116.          USER's Manual.
  117.          c.  Capt Choinere - The organization of the document was
  118.              satisfactory, however, it needs to include more detail and
  119.              an example and subsequent scenario to illustrate the use
  120.          of the tool.
  121.     2.  Design Document
  122.          a.  All references to the earlier Harris GKS implementations
  123.              will be omitted.
  124.          b.  Adhere more to the GKS terminology (ie COLOUR vs COLOR).
  125.          c.  The organization and content was generally satisfactory.
  126.     3.  Microscopic Design
  127.          a.  Areas of the listings where TeleSoft Compiler
  128.              Version 1.5 idiosynchroncies occur should be annotated 
  129.          for quick and easy identification for possible future 
  130.          modification to more appropriate Ada syntactical forms.
  131.          b.  Although their occurances were not numerous, some
  132.              instances of criptic names did appear (ie CONN_PTR vs
  133.              CONNECTION_POINTER).  These occurances should be
  134.              renamed.
  135.          c.  The occasional use of renames caused some confusion.
  136.              This should be avoided whenever possible.
  137.          d.  The menu package should be more "generic" in nature to
  138.              allow the use of a wide range of general icon
  139.              conventions for the Menu Window.
  140.          e.  When the design support package dependency is removed,
  141.              all occurances of TBD types in the resulting PDL
  142.              generated from a design diagram should cause an error
  143.              when compiled.  At present, this is not the case (ref.
  144.              enumeration type TBD).
  145.  
  146.  
  147.  
  148.  
  149.  
  150.     4.  Tool Design Action Items - As per Maj. Courtwrights request,
  151.     the following summarizes the action items taken on the
  152.     functionality and design of the GAD tool.
  153.  
  154.          a.  GKS_Prime vs GKS - Use a GKS Interface as near to the
  155.              ANSI standard as possible.  The ability to accomplish
  156.              this is dependent upon the availability of a DEC Ada
  157.              compiler prior to delivery of the tool.  The existing
  158.              terminal driver interface and specific driver software
  159.              will be utilized. (SYSCON received its Ada compiler on 3 
  160.          September and will have it operating by 6 September.  The 
  161.          exact sequence for transition to the compiler will be 
  162.          determined after reviewing other GAD factors during the 
  163.          week of 9 September.)
  164.          b.  Provide a Comment Insertion Capability - A feature 
  165.          should be added which will permit the user to insert
  166.            approximately 1-3 lines of text, which will be treated as
  167.          Ada comments, into each package (specification and body) and
  168.          subprogram and task bodies when the PDL is generated.  The
  169.          text will be editable via the same editing capabilities
  170.          which are used for editing identifiers.  The text will not
  171.          be dislplayed on the object oriented design diagrams;
  172.          however, it will be displayable in the prompt/status/error
  173.           area of the CRT for observation or editing. 
  174.          c.  Complete the implementation of major functionality.
  175.              This includes the FILE, PRINT and MOVE (in scope move
  176.              only) functions.  For the movement of entities outside
  177.              the scope of an enclosing entity, at a minimum the
  178.              project is to identify the problems and issues with
  179.              achieving this capability.
  180.          d.  New functionality - It is extremely important that a
  181.              RESIZE or RESCALE function be added to assist tool users
  182.              with improving the asthetics of a design diagram without
  183.              having to delete and redraw incorrectly sized entities.
  184.              A REPLICATE function was deemed not critical to the
  185.          success of the GAD tool.
  186.  
  187.     WIS JPMO ACTION ITEMS
  188.  
  189.     1.  Mjr. T. Courtwright will a copy of the ANSI GKS Standard 
  190.     to SYSCON.
  191.  
  192.     2.  Mjr. T. Courtwright will be responsible for locating a 
  193.     suitable "alpha" test organization for early use of the GAD
  194.     during the development process.  In selecting an organization, it
  195.     was mutually agreed by both SYSCON and Mjr. Courtwright that the
  196.     organization selected must be acceptable to both the WIS JPMO and
  197.     to SYSCON.  In addition, it was agreed that proper controls would
  198.     need to be placed on the organizational personnel involved and be
  199.     properly enforced to ensure that the evaluation was meaningful
  200.     and that due account would be taken of the fact the the tool was
  201.     still undergoing development and subject to both refinement,
  202.     enhancements and changes. 
  203.  
  204.     3.  Mjr. Courtwright agreed to authorize expansion of SYSCON's 
  205.     directory on the TECR machine at NOSC to approximately 
  206.     10000-15000 blocks.
  207.