전체 글(145)
-
개발자의 글쓰기 4장 - 사용자와 소통하는 에러 메시지 쓰기
01 체인지 로그를 분류, 요약, 종합하는 법 체인지 로그의 양과 만족도의 관계 간단히 쓰면 한 일이 없어 보이고 자세히 쓰면 아무도 읽지 않아 쓸모가 없다. 애플리케이션의 새 버전을 릴리스할 때 변경사항에 다음과 같이 썼다면? ‘사소한 오류 수정’ 일을 열심히 하고도 체인지 로그를 제대로 작성하지 않으면 인정도 못 받고 보람도 없다. 그렇다면 일주일 동안 한 일을 모두 다 적으면? ‘고해상도 폰에서 아이콘이 찌그러지는 오류를 수정했습니다.’ ‘가로/세로 화면 전환 시 하단 메뉴가 사라지는 오류를 수정했습니다.’ ‘애니메이션 스티커가 갑자기 멈추는 오류를 수정했습니다.’ …. 잘못하다간 버그 많은 걸 자랑하는 꼴이 되어버린다. 체인지 로그를 잘 작성하려면 밑의 순서를 기억하자. 선정하기 분류하기 요약하기..
2023.01.15 -
개발자의 글쓰기 3장 - 사용자와 소통하는 에러 메시지 쓰기
01 에러 메시지를 쓰기 전에 에러부터 없애자 친절한 404, 불친절한 404 사용자가 404 에러 페이지를 만나게 되는 이유는 사용자가 URL을 잘못 입력한 경우 사용자가 링크를 클릭했으나 해당 페이지가 없는 경우 첫 번째 경우는 죄송할 이유가 없다. 문제는 두 번째 경우다. 클릭 시 해당 페이지가 없는 경우, 이를 깨진 링크 또는 죽은 링크라고 한다. 깨진 링크는 개발자의 책임이다 사이트 안에서 링크로 연결되다 깨진 것은 브로큰링크체크닷컴에 들어가서 확인이 가능하다. 또는, 다른 사이트에서 연결된 링크가 깨진 경우가 있다. 특히 검색 엔진이 페이지를 수집했는데, 이후에 페이지 URL이 바뀌거나 페이지를 삭제했는데도 검색 엔진에 원래 페이지를 그대로 갖고 있다가 링크로 연결하는 경우가 있다. 예를 들어..
2023.01.15 -
개발자의 글쓰기 2장 - 개발 시간을 줄여주는 이름 짓기와 주석 쓰기
01 네이밍 컨벤션, 이유를 알고 쓰자 개발자의 가장 큰 고민은 이름 짓기 모든 개발자는 자기 코드를 읽는 사람이 주석 없이도 금방 이해하게 코드를 작성하고 싶어 한다. 이름 하나 잘못 지었다간 일이 몇 배가 되기도 한다. 무슨 뜻인지, 무슨 기능을 하는지 알아낼 수 있는 이름을 작성해보자 이름 짓기는 창조가 아니라 조합 이름 짓기는 무에서 유를 창조하는 것이 아닌, 라이브러리를 사용하는 것처럼 기존 방식 및 이름을 차용해서 새로운 이름을 짓는 경우가 대부분이다. 창조가 아닌 정해진 원칙으로 적절한 단어를 선택해 조합하는 과정일 뿐이다. 인기 자바 소스를 분석한 '오픈소스의 네이밍 특징들' 자바 네이밍 컨벤션을 철저히 준수한다 클래스는 UpperCamelCase 함수와 변수는 lowerCamelCase ..
2023.01.15 -
개발자의 글쓰기 1장 - 개발자가 알아야 할 글쓰기 기본
[프롤로그] 개발자의 글쓰기는 달라야 한다. 개발자 글쓰기의 특징은 ‘정확성, 간결성, 가독성’이다. 문제는 이 세 가지 원칙이 서로 대치한다는 데 있다. 기업의 테크니컬 라이터가 존재하지 않는 우리도 글을 잘 쓸 수 있을까? . . . 01. 문장과 단락을 구조화하는 법 문장을 구조화하는 법 주어 서술어 보어를 이용하여 문장을 만들 수 있다 주어를 문장의 처음으로 뺀다. 인과관계가 있는 복문은 두 문장으로 나눈다 입력데이터는 색상 RGB값을 각각 사용하기 때문에 3차원 벡터다. → 입력 데이터는 색상 RGB값을 각각 사용한다. 그래서 입력 데이터는 3차원 벡터다. 본인이 잘 아는 내용을 바로 쓴다 ‘입력 데이터는 3차원 벡터다.’ 후에 이유를 어떻게 설명할 것인지 결정 부가 설명을 추가해준다 ‘입력 데..
2023.01.15 -
AWS EC2 : 액세스하려면 22 포트를 개방해야 할 수 있으므로 이 인스턴스에 연결하지 못할 수 있습니다. 해결하기
ssh -i "nolmeong.pem" ubuntu@ec2-3-35-210-62.ap-northeast-2.compute.amazonaws.com ssh: connect to host ec2-3-35-210-62.ap-northeast-2.compute.amazonaws.com port 22: Operation timed out EC2 연결과정 중, timed out이라며 위의 에러가 발생했다. EC2에서 인스턴스 연결하여 SHH 클라이언트 탭을 확인 후, 하단을 보면 액세스 하려면 22 포트를 개방해야 할 수 있으므로 이 인스턴스에 연결하지 못할 수 있습니다. 현재 연결된 보안 그룹에 포트 22가(가) 열려 있지 않습니다. 라는 경고 메시지를 확인할 수 있을 것이다. 22 포트가 허용되지 않은 상태라 ..
2022.05.25 -
AWS EC2 빌드시 메모리 부족 문제 해결
우분투 서버의 프론트 폴더를 빌드하던 중 Creating an optimized production build .. 까지만 진행 후 아무리 기다려도 멈춤 상태로 빌드가 진행되지 않았다. 찾아보니 빌드 멈춘 원인은 aws 메모리 부족 문제였고, 이 경우 본인의 로컬 서버에서 빌드를 진행 후 빌드 결과물인. next를 서버로 전송하여 서버를 실행하여야 한다. 1. (우분투 서버 아닌 본인의 로컬 서버에서 진행) 프로젝트에서 터미널 열고 모든 작업 처리 후, npm run build 2. brew install git-lfs 설치 여기서 git-lfs를 설치하는 이유는, git은 작은 소스코드 파일들을 위한 버전 컨트롤 시스템으로 100Mb부터는 push가 되지 않는다. 그럼에도 위에서처럼 부득이하게 대용..
2022.05.24