documentation in it? - itsdfi.com · communication and share knowledge for key players • ... for...

17
Documentation in IT? Lost of Time or Strategical Value? !!!!!WARNING!!!! This document has been obsolete in the moment of generation already. Actual information is in the model only. Model Driven approach to: - Knowledgebase - Documentation - Projects - Business [email protected] www.SystemThinking.xyz Unnecessary Costs due to misunderstandings

Upload: vuduong

Post on 29-Aug-2018

215 views

Category:

Documents


0 download

TRANSCRIPT

Documentation in IT?Lost of Time or Strategical Value?

!!!!!WARNING!!!!This document has been obsolete in the moment of generation already.Actual information is in the model only.

Model Driven approach to:- Knowledgebase- Documentation- Projects- Business

[email protected]

Unnecessary Costsdue to misunderstandings

Life Cycle of IT ServicesMain Goal - Keep green line uninterrupted

• Preventive action• Reactive Actions

To many roles/Individuals-To many sources of misunderstnading

Islands of Knowledgecustom PCG_00352_What are the problems of the current “documenting”?

Screen1-Current status - islands of knowledge

• Added values• 3R is “Right Information in Right Time for Right Role”• Actual Information is available/managed online• Managed quality of INFORMATION (documentation)• Knowledge as shared asset - not hidden only for individuals

• Strategy• Recognized Standards

- processes (TOGAF, ITIL,..)- methodology (PRINCE, 7D, APV,…)

• Tools- tools (Archimate, BPMN, UML,…)

• Implementation• Metadata based Repository for documentation• Artefact-based documentation is – one source of thruth• Model-driven approach• Web collaboration

• Technology- Enterprise Architect (SparxSystem)- RDBM

New Approach

Backup Slides

Repository based cooperationanalysis PCG_07123_01. Story Board

Service Manager

Quality Centrum - Repository

Existing Sharepoint Portal SitesConsumer of InformationKBMS Administration

Knowledge Providers

«Administrator»KBMS-

Administrator

Name: PCG_07123_01. Story BoardAuthor: Roman KazickaVersion: 1.0Created: 01-Jun-11 00:00:00Updated: 04-Apr-18 16:48:11

«Writer»author

«reader»Reader

ClientApplication

«SQL DB»KM Repository

ClientApplication-

Free

MS ExcellSQL

QUERY

WebServer

HTMLA

«FileServer»KM Repository

RTF

XMLInformationRecepients

API

RTF, XLS, ...

Documentsrepository

TestManagement

Repository

ServiseDesk/Manager

(SD/SM)

«Writer»author2

ClientApplication

«Writer»author3

AssetManagement/Manager

Asset Management

uCMDB

Configuration Management DB

Questions• How can a manager decide without credible

information?• How can we achieve our goals?• How to deal with a great number of details, risks,

intrigues on the journey to reaching the goal?• How to learn from mistakes from past ?• How to face constant change in the team?• How to build metadata-based knowledge systems?

Documentation/current status• - primary information carriers are documents in some form or on paper

• - multiple sources of information on the same assets

• - low level of integration, communication between primary sources of information

• - poor or no system for measuring and evaluating the reliability of data sources

• - practical impossibility of keeping up-to-date information on assets in documents

• - inappropriate structure of team members to create technical documentation

• - most creative people are burdened / punished with the least creative work

• - storage of documents in different repositories (Document Management System, CMS, etc.)

• - high fluctuation of key team members

• - low level of knowledge sharing in teams

• - missing ecosystem - infrastructure, methodology, processes, organizational support to simplifycommunication and share knowledge for key players

• - general IT awareness that the technical documentation is done when the work is done

• - general IT awareness that documentation is done for the customer, if not asked for (does not pay)then it is not prepared

APV-Assets-Perspectives-Views

7D-Seven Disciplines for Successful Solutionclass PCG_00339_What is the 7Ds methodology about?

Screen1-Story of Solutions, Goals and Journeys

The goal we want to achieve.

⦁ The journey to the goal. In 7Dmethodology This is our real goal.

⦁ The journey provide us the huge experienceto be better in the bext projects.

⦁ The first way is full of unforeseencircumstances, our inexperience. If weunderstand what we can do better, eachsubsequent path will be faster andeasier to manage.

Initial status. We have a intention, we have a goal,maybe we lack experience.

7D-Logical Structuremmd PCG_00186_7D - Seven Disciplines - Overview

7D - Seven Disciplinesfor sucessfull Solutions

D1-management

D2-Motivation

D3-Analysis

D4-Design

D5-Implementation

D6-Verification/Testing

D7-LessonLearned

01.Goals/Expectations

02.Strategy

03.Plans/Roadmaps

04.Decisions

05.Work Activities Evidence

06.Reporting

07.Publishing

01.Deliverables

01.Deliverables

02.Plans/Roadmaps

00.Decisions

01.Principles

02.Rules

03.SWOT Analysis

04.Risks

05.Measures

01.Stakeholder Analysis

01.Resources

01.Project Management Reporting

02. Model Quality Reporting01. Overview of Authors of Model

01. Effort Reports

01.Best Practice

02.Bad Practice

03.Opened Questions

04.Proposals 01. New Principles

02. New Rules

08.Resources

03.Project Management

09.Intelectual Properties

01.Human Resources

02. Time Resources

03.Finanace

APV-Assets-Perspectives-Viewscustom PCG_00344_What is the APV methodology about?

Screen1-Story of Solutions, Goals and Journeys

In the APV methodology, we focus on how to describethe outcome.

APV describes the baseline. From it, we want to reach thegoal with the 7D methodology.

APV describes static properties of the solution not thepath to it.

Relationship between 7D and APV

class PCG_0182_Relationship 7Ds and APV

AS-ISstatus

TO-BEstatus

one source oftruth

Methodology 7Ds

Methodology APV

NEXTstatus

Methodology APV

Methodology 7DsMethodology 7Ds

Time T1 Time T2Time T3

I F

Common Repository-Synergydoc PCG_00429_Synergic effects in a team - Self-learning organization

Screen1-Synergic effects in a self-organizing organization

[email protected]

• Roman is a IT Solution/Enterprise Architect in own company

• current focus is consultancy, education, book writing, evangelist of system approach in IT. He has written eBook –Documentation in IT? - Lost of time or Strategical Asset? He is author of several original methodologies - ‘7Ds-SevenDisciplines for successful solutions’, ‘APV-Assets-Perspectives-Views’, ‘Q12-12 quadrants for successful business’.

• All these methodologies are based on personal experiences from many roles in small and big companies, from shopfloor toCTO in Automotive in Cars Production. He has experiences with Computer Based Measurement and Automation, Testing fromautomation components up to business processes. Last 8 years was active in big Automotive company in several ITIL roles (ITSCM, Capacity, Availability manager), and technical roles (SA, CTO)

• He is currently lecturing an Object of ‘System Thinking and Digital Fabrication’ on Faculty of Informatics and Informationtechnology in Bratislava.

• He participates on projects related to GDPR, IT SM

• He provides trainings, consultancy in building systems which provide ‘Right Information For Right Role at Right Time.

• Roman close cooperates with makerspace FABLAB SCSTI (Slovak Center of Scientific and Technical Information) where heorganizes the workshops for young people of age 14. The workshops are oriented on systematic approach in IoT and seekingsolution for people with handicaps (Intelligent glover, making use of EEG, EMG, EMG sensors for helping people with any kindof handicap. He is trying to lead Young people to perceive the surroundings world of minor groups

“We do not have to be perfect, we can be useful”.

• He has started to develop the solutions based on BIOFEEDBACK – EEG, EMG, ECG

Roman Kazicka, PhD