没规范的下场 - 工作交接困难 ¶

作者：KK
发表日期：2016.3.10

其实这个是基于前面提到的阅读困难总结出来的

由于阅读困难,造成上一任员工写下来的代码,下一任员工接手后阅读理解不容易,要花更多时间,在交接效率上大打折扣

这里大家会马上想到离职的交接,那是的,如果一家公司比较重视交接,那你的交接工作可能会进行得不太顺利

其实不只是离职的交接,包括在公司里的项目组人员调动都是,你可能要离开A项目组参加B项目,于是又要了解B项目的代码和业务文档,在代码层面上,没有规范的情况下你必须耗费非常大量的时间成本,于是你第一时间就觉得B项目不是你希望参加的项目...其实不是这个项目性质的问题,而是这些代码的问题

这一点经常能在网上看到别人赞许Google公司的代码规范多么多么好,一个员工只要有权限阅读另一个公司项目的代码,那么他会读得好顺利,可以说不需要多少文档,只需要看着代码的写法,排版,基本就知道它要干什么了,很快就上手了一个项目.这是促成高效开发的其中一个成因

var shiftWindow = function () { scrollBy(0, -50) }; if (location.hash) setTimeout(shiftWindow, 1); window.addEventListener("hashchange", shiftWindow); var element = document.createElement("script"); element.src = "./jssearch.index.js"; document.body.appendChild(element); var searchBox = $('#searchbox'); // search when typing in search field searchBox.on("keyup", function(event) { var query = $(this).val(); if (query == '' || event.which == 27) { $('#search-resultbox').hide(); return; } else if (event.which == 13) { var selectedLink = $('#search-resultbox a.selected'); if (selectedLink.length != 0) { document.location = selectedLink.attr('href'); return; } } else if (event.which == 38 || event.which == 40) { $('#search-resultbox').show(); var selected = $('#search-resultbox a.selected'); if (selected.length == 0) { $('#search-results').find('a').first().addClass('selected'); } else { var next; if (event.which == 40) { next = selected.parent().next().find('a').first(); } else { next = selected.parent().prev().find('a').first(); } if (next.length != 0) { var resultbox = $('#search-results'); var position = next.position(); // TODO scrolling is buggy and jumps around // resultbox.scrollTop(Math.floor(position.top)); // console.log(position.top); selected.removeClass('selected'); next.addClass('selected'); } } return; } $('#search-resultbox').show(); $('#search-results').html('

No results

'); var result = jssearch.search(query); if (result.length > 0) { var i = 0; var resHtml = ''; for (var key in result) { if (i++ > 20) { break; } resHtml = resHtml + '

' + result[key].file.t + '' + '' + result[key].file.d + '

'; } $('#search-results').html(resHtml); } }); // hide the search results on ESC $(document).on("keyup", function(event) { if (event.which == 27) { $('#search-resultbox').hide(); } }); // hide search results on click to document $(document).bind('click', function (e) { $('#search-resultbox').hide(); }); // except the following: searchBox.bind('click', function(e) { e.stopPropagation(); }); $('#search-resultbox').bind('click', function(e) { e.stopPropagation(); }); });