디시인사이드 갤러리

갤러리 이슈박스, 최근방문 갤러리

갤러리 본문 영역

문서 작성은 중요하다.

아놔콘다갤로그로 이동합니다. 2012.04.10 20:22:09
조회 59 추천 0 댓글 1



문서 작성의 본질은 "맥락을 짚어주는 것"이 아닐까 싶음.

남도 이미 알고 있을만한 내용을 중언부언 끄적이는 것도 병신 짓이고, 남이 모르는 내용을 짚지 않고 혼자 씨부리는 것 역시 개념 없는 거임.

예전에 어떤 사람이 코드에 주석을 하나도 안달아놓고, 코드를 보면 다 이해가 된다고 씨부리는데...

정작 자기 자신도 다른 회사 팀들이 짜놓은 코드를 보다가 더이상 이해하기가 힘들었던지 갈아엎고 새로 짜는걸 본 적이 있음..

그 코드 역시 주석이 없어서 처음 보는 사람들은 클래스와 메소드가 어떤 상황에서 쓰이는지 하나도 나와있지 않음.

그렇다고 사용 예제가 될만한 테스트 코드도 없었음...

api 문서를 만들지 않을거면 코드 안에 간략하게 주석이라도 달아놓아야 하는데, 심지어 제법 큰 회사에서도 그렇게 안하는 새끼들이 조올라 많다는거....

지가 그 회사에 평생 있을건가? 다른 사람 엿먹이는거임....

아주 그냥 다 개새끼들임.. 



문서는 클래스와 클래스, 메소드와 메소드간의 맥락만 짚어주면 됨.

자바 api 문서가 처음에 보기 힘든 이유는 맥락은 잘라낸채 앵무새처럼 이 클래스는 무슨 일을 하고~~ 저 메소드는 뭘 하고~~ 이렇게 단속적으로 끄적여놓았기 때문임... 아, 근데 그거 가지고 뭐 어떻게 하라고? 

Jaxp 같은거 한 번 보셈.

존나 끄적여 놓기만 했지, 그거 보고 파서 팩토리 인스턴스 얻어내고 핸들러 구현해서 정보 뽑아낼 새끼가 몇이나 되겠음? 뭔가를 하려고 할 때 jaxp api 는 별 도움이 안된다는걸 알 수 있음. 별도의 설명 문서를 보고나서 클래스들이 어떤 식으로 사용되는지 알고나서야 api가 의미있어짐..


질문할때도 아무 생각 없이 막 씨부리는 새끼들 의외로 많은데, 지가 해결하고 싶은 문제가 있으면 "남이 알아야할 정보"가 뭘까 고민부터 해야하는데, 대개의 질문글들을 보면 "나 급하다"는 것 밖에 없는 경우가 많음.

아~ 이새끼가 급하구나~ 딱 이거 하나만 알 수 있음.

저런 새끼들이 나중에 개발한다고 설치면 여러사람 피곤하게 하는 거임.



아무튼 정리하면 문서는 중요하다! 이거지!!

추천 비추천

0

고정닉 0

0

원본 첨부파일 1

댓글 영역

전체 댓글 0
본문 보기

하단 갤러리 리스트 영역

왼쪽 컨텐츠 영역

갤러리 리스트 영역

갤러리 리스트
번호 제목 글쓴이 작성일 조회 추천
설문 뛰어난 운동 신경으로 남자와 싸워도 이길 것 같은 여자 스타는? 운영자 25/11/24 - -
AD 따뜻한 겨울나기! 방한용품 SALE 운영자 25/11/27 - -
309942 CPU-burst time 시간 계산법좀 알려줭 [4] kikiki(211.187) 12.04.10 322 0
309941 c언어좀 돠주세 초보라 [2] 난바빠(121.148) 12.04.10 104 0
309940 달팽형 미안해 Adelposs갤로그로 이동합니다. 12.04.10 24 0
309939 아델포스! 나랑 롤 하자! [2] 외계달팽갤로그로 이동합니다. 12.04.10 45 0
309938 형들 나 롤하러 갈께 ㅎㅎㅎ [1] Adelposs갤로그로 이동합니다. 12.04.10 30 0
309937 jsp 추천해줄만한 도서 없나여? 해피너스갤로그로 이동합니다. 12.04.10 52 0
309935 DirectX vs WinAPI / 스왑 체인 vs HDC [9] 호석갤로그로 이동합니다. 12.04.10 71 0
309934 어째 프갤은 예나 지금이나 달라진게 없음 Adelposs갤로그로 이동합니다. 12.04.10 45 0
309930 객체화시키면 얼마나 무거워지냐? [9] 호석갤로그로 이동합니다. 12.04.10 84 0
309929 이제 프갤 서울시 동작구 지부는 제껍니다. 생물학(211.234) 12.04.10 27 0
309927 아델 개씨발년아 ㅡㅡ [1] SODMaster갤로그로 이동합니다. 12.04.10 53 0
309926 try catch 왜 무한루프돌지 ? zz(211.117) 12.04.10 183 0
309925 처음 공부방향을 게임 개발로 잡으면... 에에(211.112) 12.04.10 67 0
309923 프통령이 캐꼬꼬닭 님이였네 ㅇㅇ(210.113) 12.04.10 34 0
309922 첫월급은 다 쓰는거라는 말이 있던데 ㅇㅇ(210.113) 12.04.10 78 0
309919 다통령도 바뀌는데...... Adelposs갤로그로 이동합니다. 12.04.10 25 0
309918 전자공학 복수전공이면 Adelposs갤로그로 이동합니다. 12.04.10 59 0
309917 쿄스케형 부끄부끄 Adelposs갤로그로 이동합니다. 12.04.10 29 0
309915 여기 리그오브 레전드 하는놈 없음? [6] Adelposs갤로그로 이동합니다. 12.04.10 41 0
309914 서울역왜이럼 Adelposs갤로그로 이동합니다. 12.04.10 21 0
309913 여기 프갤 대장은 누구임? [5] ㅇㅇ(210.113) 12.04.10 56 0
309912 어시발 좆됏다 클래스 설계 잘못함 ㅋㅋㅋㅋㅋㅋㅋ [13] zz(211.117) 12.04.10 115 0
309911 쿄스케형은봅니다 [11] Adelposs갤로그로 이동합니다. 12.04.10 52 0
309908 구글 프로토콜 버퍼 써본횽?? [2] 쿄스케갤로그로 이동합니다. 12.04.10 98 0
문서 작성은 중요하다. [1] 아놔콘다갤로그로 이동합니다. 12.04.10 59 0
309906 c언어 질문점 할게여 [3] 난바빠(121.148) 12.04.10 55 0
309905 코딩후 테스트는 겁쟁이들만 하는거다 [4] 자바초보(122.36) 12.04.10 125 0
309904 아 요즘 삼춘소개로 일하는데 Adelposs갤로그로 이동합니다. 12.04.10 29 0
309903 가장 빨리 다양한 프로그래밍 언어를 배우는 노하우 [3] 두정갑(121.167) 12.04.10 112 0
309902 플밍공부하면서 제일 후회됬던게 [2] Adelposs갤로그로 이동합니다. 12.04.10 64 0
309901 아 전설의 노예게이 쿄스케짜으미당 [3] Adelposs갤로그로 이동합니다. 12.04.10 38 0
309900 프갤러중에서 롤하는사람 없음? Adelposs갤로그로 이동합니다. 12.04.10 21 0
309899 오랜만에 갤들어오니 내가 화석이 된건가 Adelposs갤로그로 이동합니다. 12.04.10 21 0
309897 ㅅㅂ 하마터면 낚일 뻔 했다 ㅋㅋㅋㅋㅋㅋㅋ [1] 아놔콘다갤로그로 이동합니다. 12.04.10 63 0
309895 야.. 비쥬얼 스튜디오 97 ..... 윈도우7에서 안되냐? [4] (116.125) 12.04.10 63 0
309894 안녕하세요. 여기가 프겔인가요. 새로 왔습니다. [2] 개바쁨(121.140) 12.04.10 43 1
309893 나에게 힘을줘 프겔러들이여~ [11] 개심심(121.140) 12.04.10 86 0
309892 황수관 박사는 왜 정치를... 이모군(58.228) 12.04.10 43 0
309890 한마디만 하자 [4] 개심심(121.140) 12.04.10 55 0
309889 컵이 없다 개심심(121.140) 12.04.10 29 0
309887 형 20살때부터 듣던 음악이다 [1] 개심심(121.140) 12.04.10 57 0
309886 니취팔러마~~ [4] 개심심(121.140) 12.04.10 63 0
309885 벌써부터 내일이 두근거린다. 내 한표의 위력을 직접 목격했었기 때문일까 [3] 바보플머(218.155) 12.04.10 77 0
309884 아 님들아. 답답해요. 이거좀 도와줘요ㅠㅠㅠㅠㅠ 빌어먹을야옹갤로그로 이동합니다. 12.04.10 47 0
309883 이 패배자 녀석들!! 프갤했(115.90) 12.04.10 34 0
309878 아!내가 유권자다! 나리링갤로그로 이동합니다. 12.04.10 36 0
309875 기사딸까 [15] 갤로그로 이동합니다. 12.04.10 130 0
309874 [한빛교육센터] 자바 웹앱 6개월 전액 무료교육 안내 [1] hanbit(112.222) 12.04.10 100 0
309873 윈도우api 함수 중에서 현재 창이 로딩중인지 판단하는 함수 있음? [1] ㅇㄹ(121.143) 12.04.10 47 0
309872 DC는 광고수익 얼마나 벌까? [1] 빌어먹을야옹갤로그로 이동합니다. 12.04.10 79 0
갤러리 내부 검색
제목+내용게시물 정렬 옵션

오른쪽 컨텐츠 영역

실시간 베스트

1/8

디시미디어

디시이슈

1/2