프로그래머의 뇌를 읽고, 오래간만에 제랄드 와인버그의 프로그래밍 심리학과 스티브 맥코넬의 Code Complete도 펼쳐본 김에 주석에 대해 생각도 정리할 겸 글을 작성해 봤습니다. 예전에 작성한 JavaDoc 가이드와 공통되는 내용도 있지만 그 글은 JavaDoc을 설명하는 것이 목표였죠. 이 글은 제가 생각하는 바람직한 주석의 스타일을 소개하고 몇 가지 책을 인용하는 내용을 갖습니다. 제가 작성하는 글들이 다 그렇듯 이 글도 시간이 지나며 조금씩 업데이트될 예정입니다.

Comment

Johngrib

Comment

더 많은 콘텐츠를 보고 싶다면?

또는

이미 회원이신가요?

2022년 1월 22일 오전 6:23

댓글 0

    함께 읽은 게시물

    행복은 모든 사람이 갈망하는 삶의 화두다. 행복해지기 위해 공부하고, 일하고, 운동하고, 절대자를 찾고, 복권을 긁는다. 하지만 행복에 도달한 사람이 그렇게 많아 보이지는 않는다. 접근 방법이 틀렸기 때문이다.

    ... 더 보기

    <인문학 이야기> 서은국 "삶 곳곳에 쾌감의 폭탄을 설치하라"

    n.news.naver.com

    <인문학 이야기> 서은국 "삶 곳곳에 쾌감의 폭탄을 설치하라"

    The first mover is not always the winner. It’s the last one standing.

    조회 1,409


    창업 후 성장이 필요하거나, 회사의 규모에 상관없이 성장이 정체되어 있는 회사들은 주먹구구식 경영에서 탈피하여 회사를 시스템화해야 합니다. 이는 회사의 생존은 물론이고, 한 단계 더 높은 도약과 지속적인 성장을 위해 반드시 필요한 과정입니다.

    ... 더 보기

    [주먹구구식 경영 탈피] 도대체 회사의 시스템(체계)이란 무엇일까요? - 모비인사이드 MOBIINSIDE

    모비인사이드 MOBIINSIDE

    [주먹구구식 경영 탈피] 도대체 회사의 시스템(체계)이란 무엇일까요? - 모비인사이드 MOBIINSIDE

    야근의 관성

    제가 한국에서 직장 생활을 시작하고 가장 먼저 배운 것은 아이러니하게도 야근이었습니다. 신입이었던 제게 야근은 선택의 문제가 아니었거든요. 선배들에게 야근은 너무나 당연한 루틴이었고, 저녁 5시가 되면 "퇴근 안 해?"가 아니라 "저녁 뭐 먹을까?"라는 질문을 던졌습니다. 누가 정해놓은 것처럼 부장님이 퇴근해야 과장님이, 과장님이 퇴근해야 대리님이, 대리님이 퇴근해야 비로서 저 같은 신입도 퇴근 생각을 할 수 있었습니다.

    ... 더 보기

     • 

    저장 14 • 조회 3,369


    취업 코칭 AI 프롬프트를 사용해보세요.

    ... 더 보기

     • 

    저장 16 • 조회 1,911


    회사는 친목단체가 아니다. 지속적인 성장을 위해서는 성과 창출은 필수 요건이다. 이런 성과를 위해서는 기획, R&D, 생산, 마케팅/영업, 경영관리에서 차별화된 경쟁력이 있어야 한다. 결국 임직원의 역량에 따라 회사의 성과가 결정되는 것이다.

    ... 더 보기

    [매경경영지원본부 칼럼] CEO라면, 인재육성팀이 해야 할 일이 무엇이라고 생각할까?

    다음 - 매일경제

    [매경경영지원본부 칼럼] CEO라면, 인재육성팀이 해야 할 일이 무엇이라고 생각할까?