{"id":292,"date":"2022-11-29T21:39:10","date_gmt":"2022-11-29T21:39:10","guid":{"rendered":"http:\/\/learnlearn.uk\/ibcs\/?page_id=292"},"modified":"2023-02-08T08:33:55","modified_gmt":"2023-02-08T08:33:55","slug":"system-documentation","status":"publish","type":"page","link":"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/","title":{"rendered":"System Documentation"},"content":{"rendered":"<div class=\"responsive-tabs\">\n<h2 class=\"tabtitle\">User<\/h2>\n<div class=\"tabcontent\">\n\n<h3>User Documentation<\/h3>\n<p>In order for users to work with large, complex and and rapily evolving systems, it is important that the correct user documentation is put in place. This can include:<\/p>\n<p><strong>Printed Manuals<\/strong><\/p>\n<p>Traditional systems included huge user manuals with hundreds of pages. These have largely been replaced or slimmed down to &#8216;getting started&#8217; guides, due to the rapid pace of development of systems, as well as the recent shift to remote or hybrid working environments.<\/p>\n<p><strong>Online-wiki pages<\/strong><\/p>\n<p>Most systems now have electronic manuals, either openly available online or on a restricted intranet site.<\/p>\n<p><strong>Tutorial Videos<\/strong><\/p>\n<p>Tutorial videos are often an excellent form of user documentation that is especially useful in demonstrating system processes.<\/p>\n<p><strong>FAQs<\/strong><\/p>\n<p>Most systems have an FAQ system for users, answering the most common questions that come up.<\/p>\n<p><strong>Help tabs &amp; Tooltips<\/strong><\/p>\n<p>Help can be built directly into the system with help tabs, tooltips and popups.<\/p>\n<p><strong>Troubleshooting Guides<\/strong><\/p>\n<p>&nbsp;<\/p>\n\n<\/div><h2 class=\"tabtitle\">Technical<\/h2>\n<div class=\"tabcontent\">\n\n<h3>Technical Documentation<\/h3>\n<p>Technical documentation is a necessary component of any system, detailing:<\/p>\n<ul>\n<li>An overview of the data storage model<\/li>\n<li>An overview of the overall system and how each component works together.<\/li>\n<li>An overview of any external and internal APIs used and their parameters.<\/li>\n<\/ul>\n<div id=\"attachment_501\" style=\"width: 760px\" class=\"wp-caption alignnone\"><a href=\"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram.png\"><img aria-describedby=\"caption-attachment-501\" decoding=\"async\" loading=\"lazy\" class=\"wp-image-501 size-large\" src=\"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram-1024x264.png?_t=1675844435\" alt=\"\" width=\"750\" height=\"193\" srcset=\"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram-1024x264.png 1024w, https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram-300x77.png 300w, https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram-768x198.png 768w, https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram.png 1163w\" sizes=\"(max-width: 750px) 100vw, 750px\" \/><\/a><p id=\"caption-attachment-501\" class=\"wp-caption-text\">An entity relationship diagram is a common component of technical documentation<\/p><\/div>\n\n<\/div><h2 class=\"tabtitle\">Legal<\/h2>\n<div class=\"tabcontent\">\n\n<h3>Legal &amp; Copyright<\/h3>\n<p>Legal and copyright documentation may also be needed including:<\/p>\n<ul>\n<li>License details for any commercial software or APIs used.<\/li>\n<li>Copyright information for the code itself.<\/li>\n<li>Attribution details for any open-source software used.<\/li>\n<\/ul>\n\n<\/div><h2 class=\"tabtitle\">Resources<\/h2>\n<div class=\"tabcontent\">\n\n<h3>Resources<\/h3>\n<p><a href=\"https:\/\/lucid.app\/\">ERD Online software<\/a><\/p>\n<p><a href=\"https:\/\/docs.google.com\/presentation\/d\/1q786noLJCCoGyM85SOOxNFbOml5uaupW9KH7mfk9HME\/edit?usp=sharing\">Teacher Presentation<\/a><\/p>\n<\/div><\/div>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>User Documentation In order for users to work with large, complex and and rapily evolving systems, it is important that the correct user documentation is put in place. This can include: Printed Manuals Traditional systems included huge user manuals with hundreds of pages. These have largely been replaced or slimmed down to &#8216;getting started&#8217; guides,&hellip;&nbsp;<a href=\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/\" class=\"\" rel=\"bookmark\">Read More &raquo;<span class=\"screen-reader-text\">System Documentation<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"on","neve_meta_content_width":85,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":""},"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v20.6 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>System Documentation - IB Computer Science<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"System Documentation - IB Computer Science\" \/>\n<meta property=\"og:description\" content=\"User Documentation In order for users to work with large, complex and and rapily evolving systems, it is important that the correct user documentation is put in place. This can include: Printed Manuals Traditional systems included huge user manuals with hundreds of pages. These have largely been replaced or slimmed down to &#8216;getting started&#8217; guides,&hellip;&nbsp;Read More &raquo;System Documentation\" \/>\n<meta property=\"og:url\" content=\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/\" \/>\n<meta property=\"og:site_name\" content=\"IB Computer Science\" \/>\n<meta property=\"article:modified_time\" content=\"2023-02-08T08:33:55+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram-1024x264.png?_t=1675844435\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/\",\"url\":\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/\",\"name\":\"System Documentation - IB Computer Science\",\"isPartOf\":{\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/#website\"},\"datePublished\":\"2022-11-29T21:39:10+00:00\",\"dateModified\":\"2023-02-08T08:33:55+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"IB Computer Science\",\"item\":\"https:\/\/learnlearn.uk\/ibcs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"System Documentation\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/#website\",\"url\":\"https:\/\/learnlearn.uk\/ibcs\/\",\"name\":\"IB Computer Science\",\"description\":\"- learnlearn..uk\",\"publisher\":{\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/learnlearn.uk\/ibcs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/#organization\",\"name\":\"IB Computer Science\",\"url\":\"https:\/\/learnlearn.uk\/ibcs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/09\/LearnLearnLogowhite-300x41.png\",\"contentUrl\":\"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/09\/LearnLearnLogowhite-300x41.png\",\"width\":300,\"height\":41,\"caption\":\"IB Computer Science\"},\"image\":{\"@id\":\"https:\/\/learnlearn.uk\/ibcs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"System Documentation - IB Computer Science","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/","og_locale":"en_GB","og_type":"article","og_title":"System Documentation - IB Computer Science","og_description":"User Documentation In order for users to work with large, complex and and rapily evolving systems, it is important that the correct user documentation is put in place. This can include: Printed Manuals Traditional systems included huge user manuals with hundreds of pages. These have largely been replaced or slimmed down to &#8216;getting started&#8217; guides,&hellip;&nbsp;Read More &raquo;System Documentation","og_url":"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/","og_site_name":"IB Computer Science","article_modified_time":"2023-02-08T08:33:55+00:00","og_image":[{"url":"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/11\/Entity-Relationship-Digram-1024x264.png?_t=1675844435"}],"twitter_card":"summary_large_image","twitter_misc":{"Estimated reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/","url":"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/","name":"System Documentation - IB Computer Science","isPartOf":{"@id":"https:\/\/learnlearn.uk\/ibcs\/#website"},"datePublished":"2022-11-29T21:39:10+00:00","dateModified":"2023-02-08T08:33:55+00:00","breadcrumb":{"@id":"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/learnlearn.uk\/ibcs\/system-documentation\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/learnlearn.uk\/ibcs\/system-documentation\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"IB Computer Science","item":"https:\/\/learnlearn.uk\/ibcs\/"},{"@type":"ListItem","position":2,"name":"System Documentation"}]},{"@type":"WebSite","@id":"https:\/\/learnlearn.uk\/ibcs\/#website","url":"https:\/\/learnlearn.uk\/ibcs\/","name":"IB Computer Science","description":"- learnlearn..uk","publisher":{"@id":"https:\/\/learnlearn.uk\/ibcs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/learnlearn.uk\/ibcs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/learnlearn.uk\/ibcs\/#organization","name":"IB Computer Science","url":"https:\/\/learnlearn.uk\/ibcs\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/learnlearn.uk\/ibcs\/#\/schema\/logo\/image\/","url":"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/09\/LearnLearnLogowhite-300x41.png","contentUrl":"https:\/\/learnlearn.uk\/ibcs\/wp-content\/uploads\/sites\/25\/2022\/09\/LearnLearnLogowhite-300x41.png","width":300,"height":41,"caption":"IB Computer Science"},"image":{"@id":"https:\/\/learnlearn.uk\/ibcs\/#\/schema\/logo\/image\/"}}]}},"rttpg_featured_image_url":null,"rttpg_author":{"display_name":"learnlearnadmin","author_link":"https:\/\/learnlearn.uk\/ibcs\/author\/learnlearnadmin\/"},"rttpg_comment":0,"rttpg_category":null,"rttpg_excerpt":"User Documentation In order for users to work with large, complex and and rapily evolving systems, it is important that the correct user documentation is put in place. This can include: Printed Manuals Traditional systems included huge user manuals with hundreds of pages. These have largely been replaced or slimmed down to &#8216;getting started&#8217; guides,&hellip;&nbsp;Read&hellip;","_links":{"self":[{"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/pages\/292"}],"collection":[{"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/comments?post=292"}],"version-history":[{"count":8,"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/pages\/292\/revisions"}],"predecessor-version":[{"id":504,"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/pages\/292\/revisions\/504"}],"wp:attachment":[{"href":"https:\/\/learnlearn.uk\/ibcs\/wp-json\/wp\/v2\/media?parent=292"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}