{"id":103,"date":"2018-06-30T06:58:27","date_gmt":"2018-06-30T06:58:27","guid":{"rendered":"https:\/\/www.skyalleys.com\/?p=103"},"modified":"2018-07-04T16:07:16","modified_gmt":"2018-07-04T16:07:16","slug":"all-code-fully-documented","status":"publish","type":"post","link":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/","title":{"rendered":"All Code fully documented"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">Problem: <\/span><\/p>\n<blockquote>\n<p style=\"text-align: center;\"><span style=\"font-weight: 400;\">All code should be fully documented! <\/span><\/p>\n<p style=\"text-align: center;\"><span style=\"font-weight: 400;\">W<\/span><span style=\"font-weight: 400;\">e shall never see an example of working code which is not being documented.<\/span><\/p>\n<\/blockquote>\n<p><span style=\"font-weight: 400;\">One of my all time best friend came with this problem to me. He\u2019s well above the level of senior developer and I have to admit, when it comes to me, I have never written a sequence of code bigger than 1 page. I\u2019ll simply be frank about it: my experience with coding is rather limited. Usually I can understand what a simple piece of code wants to accomplish and occasionally I can tweak it, but that&#8217;s about it! Developing code from scratch it\u2019s not a skill I have.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">With all that I accepted my friends dare and said I\u2019ll think about it for a couple of days. I did it across the weekend, not giving it much intense thought though and here is what I came up with.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">First axiom is:<\/span><\/p>\n<blockquote>\n<p style=\"text-align: center;\"><span style=\"font-weight: 400;\">All code should be re-utilizable<\/span><\/p>\n<\/blockquote>\n<p><span style=\"font-weight: 400;\">In the same spirit, a part of my idea is taken from another post that I\u2019ve made: <\/span><a href=\"https:\/\/34.79.102.44\/index.php\/intelligent-home\/iot\/internet-of-things-iot-for-all-of-them\/\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">https:\/\/34.79.102.44\/index.php\/intelligent-home\/iot\/internet-of-things-iot-for-all-of-them\/\u00a0<\/span><\/a><span style=\"font-weight: 400;\">Check the part where I describe \/ imagine The app that builds apps, or just another very big collection of buttons.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Extending the concept, imagine a cube made by tiny little other cubes of various volumes ( and some vacuum to fill the gaps between them, if any).<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Let&#8217;s think of each and every code sequence \/ programmed function as if it were a fully documented cube easy to integrate with others. For the effectiveness of the model we\u2019ll consider that the smallest coded functions has 1 input, 1 output and up to 4 conditions (totaling our little cube 6 faces). Even more, since the input\/output and conditions are standardized you could use any programming language to build them and they would still integrate very well with the others (kind of how API calls work).<\/span><\/p>\n<p>Second axiom is:<\/p>\n<blockquote>\n<p style=\"text-align: center;\">Anyone should understand every written code<\/p>\n<\/blockquote>\n<p>Visualize a complex function \/ portion of code made from multiple little cubes. Each and every cube is well documented, all it&#8217;s outputs are known. So should be the bigger cube. In addition should be fully tested and proven to work as expected.<\/p>\n<p><span style=\"font-weight: 400;\">Imagine a virtual room where you can go and build any bigger cube by utilizing the ones that already exist. What could you build based on the already existing predefined cubes? Even further, imagine that you already built it and you can zoom in and see all the tiny pieces and their specs but you can also zoom out and see millions of rows of code as a single cube, fully documented and fully integrated with others.<\/span><\/p>\n<p>Now think of how Artificial Intelligence can write code. Do you believe humans have any chance in understanding it? I don&#8217;t believe so. However, if the above proposed model would be implemented we could understand it, we could change it, control it or even learn from it. (You see, <a href=\"https:\/\/34.79.102.44\/index.php\/artificial-intelicence\/99\/\">this thought<\/a> is still hunting me.)<\/p>\n<p><span style=\"font-weight: 400;\">Some might already say that I\u2019ve literally \u2018smoked some shit\u2019 \u00a0Try to think a bit deeper than that.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Think of what would be the advantages of this model:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Each and every piece of code no matter how small or big would be reusable;<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Anyone (literally anyone) could code something;<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">You would not need to go into the deeps of complicated algorithms, you\u2019ll have a cube for using them.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">The automation of testing would be easier as the number of output sates would always be known.<\/span><\/li>\n<li style=\"font-weight: 400;\">Codding would become a visual \/ geometry experience, so even when an AI would do it a human would still be able to understand it into some extent.<\/li>\n<li>Being able to use any programming language inside a small cube, would make optimization easier.<\/li>\n<li>Standardizing you might lose some flexibility but you&#8217;ll gain so much on the long run..<\/li>\n<\/ul>\n<p>What would be the down sides?<\/p>\n<ul>\n<li><span style=\"font-weight: 400;\">Big initial effort to document and normalize everything that already is. Perhaps a multiple increments approach over the years would be feasible;<\/span><\/li>\n<li>All code would need to be open source for this to work. I know many cases where many companies will not like to renounce at their proprietary code (I&#8217;ll treat this subject in a different post);<\/li>\n<li>Optimization of bigger code projects would be more difficult. At least in the beginning, until more very well optimized cubes are already published.<\/li>\n<li>Many programmers will no longer need to use the codding languages they used to work with.<\/li>\n<li>(I hope my friend will come back with more setbacks after reading this).<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">In other words, oversimplifying the idea, codding would pretty much become similar with building Lego toys. It might require parts that need to move and the cube would not be the only smallest geometrical figure but I&#8217;m sure all could be figured out.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Really need to think further on this theoretical model.\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Problem: All code should be fully documented! We shall never see an example of working code which is not being documented. One [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[25,29,30,31,32],"tags":[43,46,44,45],"class_list":["post-103","post","type-post","status-publish","format-standard","hentry","category-artificial-intelicence","category-automation","category-coding","category-testing","category-understanding-ais","tag-artificial-intelligence","tag-automation","tag-coding","tag-testing"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>All Code fully documented - Sky Alleys<\/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:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"All Code fully documented - Sky Alleys\" \/>\n<meta property=\"og:description\" content=\"Problem: All code should be fully documented! We shall never see an example of working code which is not being documented. One [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/\" \/>\n<meta property=\"og:site_name\" content=\"Sky Alleys\" \/>\n<meta property=\"article:published_time\" content=\"2018-06-30T06:58:27+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2018-07-04T16:07:16+00:00\" \/>\n<meta name=\"author\" content=\"Alex\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Alex\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/\"},\"author\":{\"name\":\"Alex\",\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/#\\\/schema\\\/person\\\/af17d91196c915ffb289c194827c4616\"},\"headline\":\"All Code fully documented\",\"datePublished\":\"2018-06-30T06:58:27+00:00\",\"dateModified\":\"2018-07-04T16:07:16+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/\"},\"wordCount\":822,\"commentCount\":3,\"keywords\":[\"Artificial Intelligence\",\"Automation\",\"Coding\",\"Testing\"],\"articleSection\":[\"Artificial Intelicence\",\"Automation\",\"Coding\",\"Testing\",\"Understanding AIs\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/\",\"url\":\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/\",\"name\":\"All Code fully documented - Sky Alleys\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/#website\"},\"datePublished\":\"2018-06-30T06:58:27+00:00\",\"dateModified\":\"2018-07-04T16:07:16+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/#\\\/schema\\\/person\\\/af17d91196c915ffb289c194827c4616\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/index.php\\\/artificial-intelicence\\\/all-code-fully-documented\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.skyalleys.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"All Code fully documented\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/#website\",\"url\":\"https:\\\/\\\/www.skyalleys.com\\\/\",\"name\":\"Sky Alleys\",\"description\":\"Business Development as a Service and Expert Led Delivery\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.skyalleys.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.skyalleys.com\\\/#\\\/schema\\\/person\\\/af17d91196c915ffb289c194827c4616\",\"name\":\"Alex\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/c191643bf88ff2825b0a73c636b3db69adc1e24bfbb2c72a22aab9917f4eb94e?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/c191643bf88ff2825b0a73c636b3db69adc1e24bfbb2c72a22aab9917f4eb94e?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/c191643bf88ff2825b0a73c636b3db69adc1e24bfbb2c72a22aab9917f4eb94e?s=96&d=mm&r=g\",\"caption\":\"Alex\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"All Code fully documented - Sky Alleys","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:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/","og_locale":"en_US","og_type":"article","og_title":"All Code fully documented - Sky Alleys","og_description":"Problem: All code should be fully documented! We shall never see an example of working code which is not being documented. One [&hellip;]","og_url":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/","og_site_name":"Sky Alleys","article_published_time":"2018-06-30T06:58:27+00:00","article_modified_time":"2018-07-04T16:07:16+00:00","author":"Alex","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Alex","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/#article","isPartOf":{"@id":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/"},"author":{"name":"Alex","@id":"https:\/\/www.skyalleys.com\/#\/schema\/person\/af17d91196c915ffb289c194827c4616"},"headline":"All Code fully documented","datePublished":"2018-06-30T06:58:27+00:00","dateModified":"2018-07-04T16:07:16+00:00","mainEntityOfPage":{"@id":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/"},"wordCount":822,"commentCount":3,"keywords":["Artificial Intelligence","Automation","Coding","Testing"],"articleSection":["Artificial Intelicence","Automation","Coding","Testing","Understanding AIs"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/","url":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/","name":"All Code fully documented - Sky Alleys","isPartOf":{"@id":"https:\/\/www.skyalleys.com\/#website"},"datePublished":"2018-06-30T06:58:27+00:00","dateModified":"2018-07-04T16:07:16+00:00","author":{"@id":"https:\/\/www.skyalleys.com\/#\/schema\/person\/af17d91196c915ffb289c194827c4616"},"breadcrumb":{"@id":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.skyalleys.com\/index.php\/artificial-intelicence\/all-code-fully-documented\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.skyalleys.com\/"},{"@type":"ListItem","position":2,"name":"All Code fully documented"}]},{"@type":"WebSite","@id":"https:\/\/www.skyalleys.com\/#website","url":"https:\/\/www.skyalleys.com\/","name":"Sky Alleys","description":"Business Development as a Service and Expert Led Delivery","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.skyalleys.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.skyalleys.com\/#\/schema\/person\/af17d91196c915ffb289c194827c4616","name":"Alex","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/c191643bf88ff2825b0a73c636b3db69adc1e24bfbb2c72a22aab9917f4eb94e?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/c191643bf88ff2825b0a73c636b3db69adc1e24bfbb2c72a22aab9917f4eb94e?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/c191643bf88ff2825b0a73c636b3db69adc1e24bfbb2c72a22aab9917f4eb94e?s=96&d=mm&r=g","caption":"Alex"}}]}},"jetpack_publicize_connections":[],"wps_subtitle":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pasegJ-1F","jetpack_featured_media_url":"","post_mailing_queue_ids":[],"_links":{"self":[{"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/posts\/103","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/comments?post=103"}],"version-history":[{"count":3,"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/posts\/103\/revisions"}],"predecessor-version":[{"id":106,"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/posts\/103\/revisions\/106"}],"wp:attachment":[{"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/media?parent=103"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/categories?post=103"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.skyalleys.com\/index.php\/wp-json\/wp\/v2\/tags?post=103"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}