Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

(warning)  Team pages for roles and responsibilities with Development Process Model are being updated and reformatted.

Section
Column
width50%
Panel
borderColor#A40000
bgColor#F8F8F8
titleBGColor#E8E8E8
titleContents
borderStyledashed
Table of Contents
minLevel1
outlinefalse
Column

SME Teams

Leads

Acquisitions/Financial: Select & Acquire

B Persing

ERMS: Under Select & Acquire

E Lynema

Cataloging: Describe-Manage

M Suranofsky - with SME lead D Herrold

Circulation: Deliver

C Case - with SME lead S Miller

Implementations/Technical: Systems Integration

C Case

Subscriptions project: GoKB

J Little

...

Note: "SA" or "SME Team Systems Analyst" is the name given to general analysts on the SME Teams to distinguish them from the BAs or Business Analysts on the Project Team. In some cases, these are still functional subject matter experts only, while in other cases, the SA does bring specific technical knowledge of coding or the Kuali technology framework (Rice et al).

HTML Comment

https://docs.google.com/a/kuali.org/document/d/1ybw-WwuGdFhvUDlbha1BVNnaTFObWEbLNYzHqui4MIQ/edit?hl=en_US

Task Assignments

Section

with the SME Team for the new spec or research team?

  • Setup email team list, KIS page, Google Docs folder for team.
    1. Request OLE Distribution list from Project Team or Help@kuali.org.
    2. Add team names to new email list & KIS page.
    3. Create team folder in your Google Docs Process (Describe, Deliver, etc) folder (model file directory after existing).
    4. "Share" team folder with distribution list and add to KIS page.
    5. Alternatively to above, SA may request BA/Project Team to process above (provide Team Name & list of members for us to set up).
  • Prepare user requirement templates and related OLE documents for spec team
    1. Reference:

  • Column
    width75%

    In the tasks below (except review steps), we provide the templates for the required documentation for completion of technical and functional specs. Project team Business Analysts will help to guide and train SME Team System Analysts throughout the following task completions, and work closely with you in the completion of Final Specifications.

    Link:DOCUMENTATION & SPECIFICATION TEMPLATES

    (6) User Requirements - Spec team & SA

    (see Spec Team - Roles in Spec Writing)

    1. Did you create a

    HTML Comment

    SOW template: https://docs.google.com/a/kuali.org/document/d/1LOUcNlnOd7ZXohnM5PYVxm3pN1VWiK0a1--kD9CICV4/edit?hl=en_US;

    HTML Comment

    https://docs.google.com/a/kuali.org/open?id=0B2bXKznsS-3GNzAyYzU4MDEtMmU3Mi00NDk3LWIzNDItN2I0OTM4YTI5YmM3

    - original Data-Entity modeling

    1. Work with OLE Data Architect to identify/pre-populate data requirements worksheet with past Data Modeling Team entities
  • Previous specifications (see Google Docs) or Specification & Documentation Templates(linked samples)
  • Reference:

    HTML Comment

    https://docs.google.com/a/kuali.org/open?id=0B2bXKznsS-3GMzVlYzM2OTgtOThmYS00YmVlLWFiMDYtMjE2NTAwMzA1NjFl

    - original workflow modeling if able to reuse

  • Pre-populate

    HTML Comment

    https://docs.google.com/a/kuali.org/document/d/1D8y8UXddgG02hvd-Zi9GYokt2e53QP3LKxInUfNsMUM/edit?hl=en_US

    and
    HTML Comment

    https://docs.google.com/a/kuali.org/spreadsheet/ccc?key=0AlzG4eNDtxYpdFVZekVWUzdhT0U5M0JrcEwxNllTZUE&hl=en_US#gid=1

    as able

  • Link other helpful collections or documents via Google Collections into Spec Team folder
  • Train the spec teams - utilize this wiki!
    1. Google Docs
    2. Webex
    3. Spec Writing
    4. HTML Comment

      https://docs.google.com/a/kuali.org/open?id=0B1zG4eNDtxYpZGM1ZGY2ZjYtNzJlOS00OTNlLTlmNDMtY2RhODdhZDgwZmIx

  • Organize and oversee spec writing by spec teams
  • Complete with Spec Team "User Requirements" template
  • Complete with Spec team "Data Requirements" template
    1. including default values/fields
    2. notes on any progressive disclosure or rules
    3. including noted required fields
  • Assist spec team in annotation and understanding of "Acceptance criteria" in user requirements
  • Table for roles/permissions
    1. from user requirements, assist spec team in annotating "mock" user roles with permissions
    2. refer to complete list of ongoing user roles, and resources for completion
  • Model for workflow
    1. has spec team included an illustration of required workflow process, or sequential model ("step one, step two")?
    2. does narrative adequately communicate the workflow, or should an illustration be inserted (Google Drawing or other illustration tool)
  • Document routing: Model for approval steps if any
  • Business rules
  • (-) UI Mockups- SA with designated BA or limited SMEs
    (8) Review - SME Team

    (see SME Teams - Roles in Spec Writing & Analysis)

    1. Review and approve specs
    2. Finalize or add Acceptance Criteria - what and how?
    3. Note anything out of scope
    4. Meet with PM to help determine prioritization
    5. Sample data needs identified - given to SA and TC
    6. Sample technical integration points culled by TC (ie for APIs, other tech specs needed)
    (9) Spec Inventory (See: Specification & Documentation Templates)
    1. Report completed specs to Project Team and Project Management (specs now available for assessment of complexity, prioritization, and scheduling)
    2. Update with drafted specs (admin process now being determined for attaching specs; updating workflows; and, combining or deleting or adding user stories as needed)
    (11) Codeable Specs

    See: Final Functional Specifications (template, instructions)

    Once SME Team has completed its spec review, and handed off the specs to Project Management in the spec inventory, user stories and tasks will be formally assigned to the project schedule. From that re-prioritization, the SA and BA (with spec team or SME Team where needed) complete Functional Specs/Requirements docs for coding

    1. Complete UI templates or translations (if applicable)
    2. Annotate sample roles/permissions table
    3. Annotate testable document workflows/routing, approvals (if applicable)
    4. Are Acceptance Criteria reviewed and completed?
    5. Insert any additional Business Rules, KRMS (see BA & template)
    6. Completion of full Functional and non-Functional specs
    (12), (17) Handoffs and Reviews - SA, Spec Team, SME Team
    1. Lead handoffs with Project Team to HTC.
    2. Participate in Q&A with developers to "translate" and manage functional requirements, as liaison to Spec Team.
    3. Coordinate developer questions with Spec Teams.
    4. Work with Project Team in any additional spec translations or technical specs.
    5. Report and manage Variations and iterative Gap Analysis as coding varies from specs due to time or technology.
    (16) Test Scripts

    Once development is begun, then SA and Spec Team work with QA Manager/team to develop Test Scripts for each set of coded specs based on Acceptance Criteria (note: some user stories in initial spec writing may have been adapted to Kuali technology OR been combined to code core functions).

    (23), (25)-(26) Testing: Spec Team, SA, SME Team

    For above, see: Acceptance Criteria, Test Scripts & Testing

    (iterative) Gap Analysis: SA, SME Team
    1. Participate in Gap Analysis with - SME Team - Gap Analysis
    2. Maintain Jira and organize gap reporting.
    3. General oversight
    (iterative) Jira Maintenance
    1. <coming soon>
    2. administration process being modified to reflect new OLE Development Process. Responsibilities of SME Team, SA's and Project Team being determined.
    3. Jira is the definitive project administration tool for OLE, and all User Stories.
    4. Draft and final specifications are to be attached to User Stories in Jira.
    Column
    HTML Table
    border0
    Table Row (tr)
    Table Cell (td)
    alignright
    Phases:
    (info) For the complete model, see
    OLE Development Cycle

    Spec Writing
    Table Cell (td)
    alignright
    Table Row (tr)
    Table Cell (td)
    alignright


    Coding

    Table Cell (td)
    alignright
    Table Row (tr)
    Table Cell (td)
    alignright


    Testing

    Table Cell (td)
    alignright
    Table Row (tr)
     

    Role Overview

    (T. McGeary, former Functional Council Chair)

    ...

    BABOK: Business Analyst Body of Knowledge
    For SA & BA only, in managing requirements analysis and brainstorming with spec teams

    Anchor
    rules
    rules
    Summary: Business Rules
    HTML Comment

    https://docs.google.com/a/kuali.org/document/d/1yFmLo1dwZ4rZgwcs8QeoBxyvfO2vdd7uAS5gB9AFgww/edit?hl=en_US

    ...