{"id":380,"date":"2016-03-24T08:00:22","date_gmt":"2016-03-24T07:00:22","guid":{"rendered":"https:\/\/se-trends.de\/?p=380"},"modified":"2016-03-21T21:35:05","modified_gmt":"2016-03-21T20:35:05","slug":"modeling-reading-and-writing","status":"publish","type":"post","link":"https:\/\/www.se-trends.de\/en\/modellieren-lesen-und-schreiben\/","title":{"rendered":"Why we need to distinguish between reading and writing when modeling"},"content":{"rendered":"<p>Systems engineering often <a href=\"https:\/\/www.se-trends.de\/en\/day\/modeling\/\" target=\"_blank\">modeled<\/a>. And that means that the stakeholders have to learn the modeling language. This often involves training. But it can be a big mistake to give all stakeholders the same training. Why? Because reading and writing models are drastically different.<\/p>\n<div style=\"background: #7eb13d; padding: 20px; border-radius: 10px; color: white; font-size: 120%; margin-bottom: 20px;\">Modeling is hard...<\/div>\n<p>Modeling is difficult. First of all, the modelling language really needs to be internalized. The language is not enough, because modeling always involves a methodology that describes how the language should be used. And last but not least, the modeling tool must also be mastered in order to be able to work efficiently. In practice, however, there are not that many stakeholders involved in modeling, typically 10% - 20%.<\/p>\n<div style=\"background: #7eb13d; padding: 20px; border-radius: 10px; color: white; font-size: 120%; margin-bottom: 20px;\">...but reading models is easy<\/div>\n<p>Most stakeholders, 80% - 90%, only need to be able to read models. This means that they need to know the language, but not necessarily in the same depth as the modelers. The methodology is also of secondary importance for the readers. All that remains is the question of tools. But here it is not unusual for readers not to use them at all, but to read generated documents.<\/p>\n<h2>Don't frustrate readers<\/h2>\n<p>Now it may become clear why it is important to treat readers and modelers differently, especially when it comes to training. Readers can easily be put off by a training course that attempts to teach modeling. Apart from that, reader training is much shorter and therefore cheaper.<\/p>\n<p>You can even differentiate between modelers: Because language, method and tool cannot actually be taught in a crash course. Therefore, modeling training should not attempt to do so. Instead, successful teams bring an experienced expert into the team to accompany the modeling. It is quite sensible and common for this expert to also conduct the modeling training.<\/p>\n<h2>Document generation<\/h2>\n<p>To further improve the result, it is advisable to invest in good document generation at an early stage. This is because most readers feel more comfortable with a linear document than with a tool. If the document generation is in place early on, it can also be used for reader training, which further increases acceptance.<br \/>\nFor example, when working with internal block diagrams (IBDs), the IBDs would be generated as part of the document. In the training, readers would then learn about both the document structure and the model elements that are used for generation.PragmaticsIn the end, it is important to take a pragmatic approach. I have succeeded in doing this in several projects in the past, which I will also report on in future issues. If you need pragmatic support with the introduction of modeling, <a href=\"https:\/\/www.se-trends.de\/en\/michael-jastram\/\" target=\"_blank\">please feel free to contact me<\/a>.<\/p>\n<p style=\"text-align: right;\"><span style=\"color: #999999;\">Image courtesy of Ambro at FreeDigitalPhotos.net<\/span><\/p>","protected":false},"excerpt":{"rendered":"<p>Systems engineering often involves modeling. And that means that the stakeholders have to learn the modeling language. This often involves training. But it can be a big mistake to give all stakeholders the same training. Why? Because reading and writing models are drastically different. Modeling is hard... Modeling is hard. First of all, the...<\/p>","protected":false},"author":1,"featured_media":381,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"categories":[47,45],"tags":[52,92,63,93,94],"class_list":["post-380","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ausbildung","category-standards-methoden","tag-lehre","tag-lesen","tag-modellierung","tag-schreiben","tag-schulung"],"_links":{"self":[{"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/posts\/380","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/comments?post=380"}],"version-history":[{"count":0,"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/posts\/380\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/media\/381"}],"wp:attachment":[{"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/media?parent=380"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/categories?post=380"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.se-trends.de\/en\/wp-json\/wp\/v2\/tags?post=380"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}