{"id":4483,"date":"2020-04-19T10:10:24","date_gmt":"2020-04-19T04:40:24","guid":{"rendered":"https:\/\/atuljha.com\/blog\/?p=4483"},"modified":"2020-04-19T10:10:24","modified_gmt":"2020-04-19T04:40:24","slug":"design-doc","status":"publish","type":"post","link":"https:\/\/atuljha.com\/blog\/2020\/04\/19\/design-doc\/","title":{"rendered":"design doc"},"content":{"rendered":"\n<p>I understand many would have given advice do not worry about design doc in the early days of the product journey, focus on shipping features.  I find this advice bullshit after a few years of product development.&nbsp;<\/p>\n\n\n\n<p>My experience suggests without the design doc from the very first day UI becomes a sandwich. Every new component gets crafted with the mood of the developer or team.  When a new member joins, he comes with his own learning and further additions.\u00a0<\/p>\n\n\n\n<p>Since there is no standard the same component inside the product starts giving a different way, approach to execution.&nbsp;<\/p>\n\n\n\n<p>Even if you are starting, you have a 2 member team, you have no clue how and what you are shipping in 1st version. Get a fucking design doc that has minimum information about it.<\/p>\n\n\n\n<ol><li>Fonts to be used<\/li><li>Sizes of fonts in different places<\/li><li>Actions on the buttons: close, open<\/li><li>How will components behave, ope when clicked<\/li><li>How will navigation bar, sidebar appear in various devices<\/li><li>Fixed limited colors to be used across product<\/li><\/ol>\n\n\n\n<p>Please note as the product upgrades with time so do the design document. Do not fall in the trap of redesigning UI every year because it is fucking painful.<\/p>\n\n\n\n<p>I am sharing this with my experience.  I am in the middle of it right now.  I might sound grumpy, but this is how it is.\u00a0<\/p>\n\n\n\n<figure class=\"wp-block-embed-twitter wp-block-embed is-type-rich is-provider-twitter\"><div class=\"wp-block-embed__wrapper\">\n<blockquote class=\"twitter-tweet\" data-width=\"550\" data-dnt=\"true\"><p lang=\"en\" dir=\"ltr\">Start with a design doc, keep changing it as new component gets added. Stick to a design doc like a holy grail, make front end devs stick to it. Without it, product UI will turn into a sandwich.   <a href=\"https:\/\/twitter.com\/hashtag\/note2self?src=hash&amp;ref_src=twsrc%5Etfw\">#note2self<\/a><\/p>&mdash; Atul Jha (@koolhead17) <a href=\"https:\/\/twitter.com\/koolhead17\/status\/1251728909080522756?ref_src=twsrc%5Etfw\">April 19, 2020<\/a><\/blockquote><script async src=\"https:\/\/platform.twitter.com\/widgets.js\" charset=\"utf-8\"><\/script>\n<\/div><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>I understand many would have given advice do not worry about design doc in the early days of the product journey, focus on shipping features. I find this advice bullshit after a few years of product development.&nbsp; My experience suggests without the design doc from the very first day UI becomes a sandwich. Every new &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/atuljha.com\/blog\/2020\/04\/19\/design-doc\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;design doc&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[873],"_links":{"self":[{"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/posts\/4483"}],"collection":[{"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/comments?post=4483"}],"version-history":[{"count":1,"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/posts\/4483\/revisions"}],"predecessor-version":[{"id":4484,"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/posts\/4483\/revisions\/4484"}],"wp:attachment":[{"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/media?parent=4483"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/categories?post=4483"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/atuljha.com\/blog\/wp-json\/wp\/v2\/tags?post=4483"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}