Blog

Documentation

A coworker of mine went on vacation for two weeks. Right before he left, he pushed some changes for a web application we support from our test environment to our production one, and then left it in the hands of our intern. Several days later, we started getting complaints. Since our intern has been doing mostly cosmetic changes and isn't familiar with coding, she asked me for help. Together, we spent several hours digging into code that was extremely complex and that neither of us had familiarity with. After calling the coworker on vacation, he remoted in and fixed the problem (apparently server related). A few days later, we get more complaints. We dig in for several more hours, with just as little progress as before. Again, it turns out to be a simple server issue (one that was actually caused by the last fix). Now, several days later, there are MORE problems. What lessons can potentially be learned from this mess of a situation?
  • Don't push code right before you go out of town or are otherwise unavailable
  • If you are the only person who supports an application, and you're going to be unavailable, try to leave a little documentation (even if it's something very basic) on how it works to save people time when it breaks
Note: I'm not trying to pick on my coworker who went out of town... he was very willing to help us even though we called on his vacation, and he had no reason to believe that this application would break. I do think, however, there are some ways to prevent things like this from happening... ways that I fully intend to take advantage of when I go out of town for my own vacation in August.

Posted by on Thu, 3 Jul 2008
tags:


Comments

196 comments

  1. AllenLip Thu, 21 Oct 2021

  2. LisaLOB Thu, 21 Oct 2021

  3. Lyktuc Wed, 20 Oct 2021

  4. PaulLOB Wed, 20 Oct 2021

  5. RichardTer Wed, 20 Oct 2021

  6. ivermectin 6 mg Tue, 19 Oct 2021

  7. Evzwxo Tue, 19 Oct 2021

  8. SueLOB Mon, 18 Oct 2021

  9. KiaLOB Mon, 18 Oct 2021

  10. Rwgmcx Mon, 18 Oct 2021

  11. JaneLOB Mon, 18 Oct 2021

  12. YonLOB Mon, 18 Oct 2021

  13. JimLOB Mon, 18 Oct 2021

  14. JoeLOB Mon, 18 Oct 2021

  15. Hiramzom Sun, 17 Oct 2021

  16. KimLOB Sun, 17 Oct 2021

  17. SamLOB Sun, 17 Oct 2021

  18. PaulLOB Sun, 17 Oct 2021

  19. MaryLOB Sun, 17 Oct 2021

  20. MiaLOB Sun, 17 Oct 2021

  21. JaneLOB Sun, 17 Oct 2021

  22. MarkLOB Sun, 17 Oct 2021

  23. EvaLOB Sun, 17 Oct 2021

  24. MaryLOB Sun, 17 Oct 2021

  25. KiaLOB Sun, 17 Oct 2021

  26. IvyLOB Sun, 17 Oct 2021

  27. Bhyukw Sun, 17 Oct 2021

  28. TeoLOB Sun, 17 Oct 2021

  29. AnnaLOB Sat, 16 Oct 2021

  30. DenLOB Sat, 16 Oct 2021

  31. YonLOB Sat, 16 Oct 2021

  32. MaryLOB Sat, 16 Oct 2021

  33. JaneLOB Sat, 16 Oct 2021

  34. Pakfrc Sat, 16 Oct 2021

  35. AnnaLOB Sat, 16 Oct 2021

  36. NickLOB Sat, 16 Oct 2021

  37. EvaLOB Fri, 15 Oct 2021

  38. KimLOB Fri, 15 Oct 2021

  39. KiaLOB Fri, 15 Oct 2021

  40. SueLOB Fri, 15 Oct 2021

  41. LisaLOB Fri, 15 Oct 2021

  42. TedLOB Fri, 15 Oct 2021

  43. PaulLOB Thu, 14 Oct 2021

  44. Dlczyb Thu, 14 Oct 2021

  45. YonLOB Thu, 14 Oct 2021

  46. SueLOB Thu, 14 Oct 2021

  47. JoeLOB Thu, 14 Oct 2021

  48. TedLOB Thu, 14 Oct 2021

  49. AmyLOB Thu, 14 Oct 2021

  50. JoeLOB Thu, 14 Oct 2021

  51. IvyLOB Wed, 13 Oct 2021

  52. EvaLOB Wed, 13 Oct 2021

  53. MarkLOB Wed, 13 Oct 2021

  54. MaryLOB Wed, 13 Oct 2021

  55. LisaLOB Wed, 13 Oct 2021

  56. JackLOB Wed, 13 Oct 2021

  57. SamLOB Wed, 13 Oct 2021

  58. Vpsxlr Wed, 13 Oct 2021

  59. NickLOB Wed, 13 Oct 2021

  60. AnnaLOB Tue, 12 Oct 2021

  61. SueLOB Tue, 12 Oct 2021

  62. DenLOB Tue, 12 Oct 2021

  63. SamLOB Tue, 12 Oct 2021

  64. PaulLOB Tue, 12 Oct 2021

  65. JackLOB Tue, 12 Oct 2021

  66. TeoLOB Tue, 12 Oct 2021

  67. JaneLOB Tue, 12 Oct 2021

  68. CarlLOB Mon, 11 Oct 2021

  69. MiaLOB Mon, 11 Oct 2021

  70. KimLOB Mon, 11 Oct 2021

  71. JoeLOB Mon, 11 Oct 2021

  72. KiaLOB Mon, 11 Oct 2021

  73. YonLOB Mon, 11 Oct 2021

  74. EyeLOB Mon, 11 Oct 2021

  75. MiaLOB Mon, 11 Oct 2021

  76. JimLOB Sun, 10 Oct 2021

  77. Ydtwod Sun, 10 Oct 2021

  78. JudyLOB Sun, 10 Oct 2021

  79. ZakLOB Sun, 10 Oct 2021

  80. AnnaLOB Sun, 10 Oct 2021

  81. TeoLOB Sun, 10 Oct 2021

  82. DenLOB Sun, 10 Oct 2021

  83. JasonLOB Sun, 10 Oct 2021

  84. EvaLOB Sun, 10 Oct 2021

  85. JoeLOB Sun, 10 Oct 2021

  86. JaneLOB Sun, 10 Oct 2021

  87. AmyLOB Sun, 10 Oct 2021

  88. JackLOB Sat, 9 Oct 2021

  89. TeoLOB Sat, 9 Oct 2021

  90. WimLOB Sat, 9 Oct 2021

  91. AshLOB Sat, 9 Oct 2021

  92. JudyLOB Sat, 9 Oct 2021

  93. EvaLOB Sat, 9 Oct 2021

  94. SamLOB Sat, 9 Oct 2021

  95. IvyLOB Sat, 9 Oct 2021

  96. JoeLOB Sat, 9 Oct 2021

  97. WimLOB Sat, 9 Oct 2021

  98. Azkpbu Sat, 9 Oct 2021

  99. UgoLOB Sat, 9 Oct 2021

  100. JasonLOB Fri, 8 Oct 2021

  101. JudyLOB Fri, 8 Oct 2021

  102. DenLOB Fri, 8 Oct 2021

  103. KimLOB Fri, 8 Oct 2021

  104. JimLOB Fri, 8 Oct 2021

  105. AmyLOB Fri, 8 Oct 2021

  106. MarkLOB Fri, 8 Oct 2021

  107. NickLOB Fri, 8 Oct 2021

  108. ivermectin 12 mg Fri, 8 Oct 2021

  109. JudyLOB Fri, 8 Oct 2021

  110. YonLOB Fri, 8 Oct 2021

  111. LisaLOB Fri, 8 Oct 2021

  112. EyeLOB Fri, 8 Oct 2021

  113. EvaLOB Fri, 8 Oct 2021

  114. ZakLOB Fri, 8 Oct 2021

  115. AnnaLOB Thu, 7 Oct 2021

  116. ZakLOB Thu, 7 Oct 2021

  117. Nmpsvk Thu, 7 Oct 2021

  118. JaneLOB Thu, 7 Oct 2021

  119. BooLOB Thu, 7 Oct 2021

  120. TedLOB Thu, 7 Oct 2021

  121. WimLOB Thu, 7 Oct 2021

  122. MaryLOB Thu, 7 Oct 2021

  123. NickLOB Wed, 6 Oct 2021

  124. MiaLOB Wed, 6 Oct 2021

  125. JaneLOB Wed, 6 Oct 2021

  126. KiaLOB Wed, 6 Oct 2021

  127. MarkLOB Wed, 6 Oct 2021

  128. JackLOB Wed, 6 Oct 2021

  129. SueLOB Wed, 6 Oct 2021

  130. Fnbake Wed, 6 Oct 2021

  131. BooLOB Wed, 6 Oct 2021

  132. JimLOB Wed, 6 Oct 2021

  133. KiaLOB Wed, 6 Oct 2021

  134. UgoLOB Wed, 6 Oct 2021

  135. PaulLOB Wed, 6 Oct 2021

  136. EvaLOB Wed, 6 Oct 2021

  137. ZakLOB Wed, 6 Oct 2021

  138. CarlLOB Wed, 6 Oct 2021

  139. BooLOB Wed, 6 Oct 2021

  140. AmyLOB Tue, 5 Oct 2021

  141. TeoLOB Tue, 5 Oct 2021

  142. JoeLOB Tue, 5 Oct 2021

  143. Vzgmmy Tue, 5 Oct 2021

  144. KimLOB Tue, 5 Oct 2021

  145. YonLOB Tue, 5 Oct 2021

  146. IvyLOB Tue, 5 Oct 2021

  147. TedLOB Tue, 5 Oct 2021

  148. YonLOB Tue, 5 Oct 2021

  149. CarlLOB Tue, 5 Oct 2021

  150. AnnaLOB Tue, 5 Oct 2021

  151. JudyLOB Tue, 5 Oct 2021

  152. AshLOB Mon, 4 Oct 2021

  153. que es la ivermectina Sun, 3 Oct 2021

  154. Zmuxng Sun, 3 Oct 2021

  155. Cbornf Fri, 1 Oct 2021

  156. online drugstore Fri, 1 Oct 2021

  157. Kxsijw Thu, 30 Sep 2021

  158. Wkiact Tue, 28 Sep 2021

  159. JimLOB Mon, 27 Sep 2021

  160. ZakLOB Mon, 27 Sep 2021

  161. Gkzhqe Sun, 26 Sep 2021

  162. TedLOB Sun, 26 Sep 2021

  163. Yzzldr Sat, 25 Sep 2021

  164. Fjhzol Fri, 24 Sep 2021

  165. ivermectin 12 mg Thu, 23 Sep 2021

  166. Xreelg Thu, 23 Sep 2021

  167. JasonLOB Wed, 22 Sep 2021

  168. Dezact Tue, 21 Sep 2021

  169. Gsmkmz Mon, 20 Sep 2021

  170. KimLOB Mon, 20 Sep 2021

  171. Dtoxoo Sun, 19 Sep 2021

  172. YonLOB Sat, 18 Sep 2021

  173. LisaLOB Sat, 18 Sep 2021

  174. Cjdmeg Sat, 18 Sep 2021

  175. ivermectin for humans pills 12 mg Fri, 17 Sep 2021

  176. Yzbeif Thu, 16 Sep 2021

  177. Fiyspy Wed, 15 Sep 2021

  178. Epbccc Tue, 14 Sep 2021

  179. Ktoxzj Mon, 13 Sep 2021

  180. Vmzeup Sun, 12 Sep 2021

  181. Qsaxkc Thu, 9 Sep 2021

  182. Xnpxxa Tue, 7 Sep 2021

  183. Mgaxyy Sun, 5 Sep 2021

  184. Yishnh Fri, 3 Sep 2021

  185. Oohokx Wed, 1 Sep 2021

  186. Xnvebx Tue, 31 Aug 2021

  187. Fuwgkp Mon, 30 Aug 2021

  188. Ypjjsk Sun, 29 Aug 2021

  189. Qbylrr Fri, 27 Aug 2021

  190. Gssuva Thu, 26 Aug 2021

  191. Szelwk Tue, 24 Aug 2021

  192. Lekhrj Mon, 23 Aug 2021

  193. Cudokj Sat, 21 Aug 2021

  194. Rrgesf Fri, 20 Aug 2021

  195. Kremnf Thu, 6 May 2021

  196. areola papillaris HEMPAS aponeurosis musculi bicipitis brachii dpwmr Kay cervical pleura hypomania

    — ByronGAG Tue, 30 May 2017


Submit a Comment

Please insert the result of the arithmetical operation from the following image:

Please insert the result of the arithmetical operation from this image. =