개발 중에는 작은 문제가 계속 생기지만 모든 문제가 블로그 글감이 되지는 않습니다. 코드 한 줄을 고친 사실만 적으면 작업 일지가 되고, 키워드만 따라 제목을 잡으면 직접 확인하지 않은 효과까지 쓰기 쉽습니다. 글감을 고를 때는 독자가 같은 상황에서 내릴 결정이 무엇인지 먼저 정하는 편이 유용합니다.
VidDish의 긴 영상 제한을 예로 들어, 문제 기록을 독자가 사용할 수 있는 글의 질문으로 좁히는 순서를 정리했습니다. 이 순서는 검색량을 무시하자는 규칙이 아니라, 검색어를 고르기 전에 설명할 내용이 있는지 확인하는 방법입니다.
1. 불편을 ‘언제 무엇을 결정할까’로 바꾼다
‘AI 비용이 걱정됐다’는 경험만으로는 독자가 자신의 앱에 적용할 기준을 얻기 어렵습니다. 질문을 ‘영상 길이가 제한을 넘는지 언제 검사할까’로 바꾸면 확인할 흐름이 생깁니다. 링크 입력, 길이 조회, 광고·사용권 안내, 분석 요청 순서에서 거절 위치를 고를 수 있기 때문입니다.
이때 독자가 마주할 선택을 한 문장으로 적습니다. 예를 들면 ‘지원하지 않는 입력은 비용이 드는 단계 전에 거절할 것인가’입니다. 선택이 보이지 않으면 문제를 더 좁히거나, 다른 사람에게 어떤 도움이 되는 글인지 다시 생각해 봅니다.
2. 현재 구현과 확인 자료를 함께 적는다
VidDish의 가져오기 화면은 확인한 영상 길이가 30분 이상이면 AI 사용권·광고 안내로 넘어가기 전에 요청을 멈춥니다. 서버 입력 검사에도 전달받은 길이를 거절하는 방어 로직이 있습니다. 여기까지는 화면의 함수와 서버 코드를 대조해 설명할 수 있습니다.
동시에 서버가 영상 길이를 독립적으로 다시 조회한다고 쓰면 현재 구현 범위를 벗어납니다. 길이를 확인하지 못한 입력의 동작도 별도로 봐야 합니다. 글감 메모에는 ‘확인한 파일·화면’, ‘확인되지 않은 경우’, ‘독자가 직접 점검할 항목’을 나란히 적어 두면 본문에서 한계를 놓치기 어렵습니다.
사용량이나 비용 효과는 코드만으로 입증되지 않습니다. ‘제한을 앞에 둬 비용을 절약했다’고 쓰려면 이전·이후 요청량과 청구액이 필요합니다. 그런 자료가 없다면 설계 이유와 현재 동작까지만 설명합니다.
3. 독자가 따라 할 점검 순서를 만든다
위 질문은 다음 네 가지 점검 항목으로 이어집니다.
- 제한할 입력의 조건과 경계값을 정한다.
- 그 조건을 어느 화면과 서버 단계에서 확인하는지 찾는다.
- 거절 전에 광고, 결제, 사용권 차감, 유료 API 호출이 일어나는지 확인한다.
- 길이를 알 수 없거나 값이 잘못 전달될 때의 처리 방식을 확인한다.
이 목록은 VidDish의 값을 그대로 다른 서비스에 적용하라는 뜻이 아닙니다. 독자는 자신의 입력과 비용 구조에 맞게 경계값을 정할 수 있습니다. 글은 특정 제품의 경험을 보여주되, 다른 제품에서도 확인할 수 있는 질문을 남겨야 합니다.
4. 발행 조건이 모자라면 제목을 보류한다
현재 첫 원고 20개 외에 후속 주제 후보 37개를 따로 기록해 두었습니다. 후보마다 확인할 파일과 발행 전에 필요한 자료를 붙였습니다. 추천 규칙을 설명하려면 실제 화면과 신호 결과가 필요하고, 오류 회고라면 재현 가능한 로그나 테스트가 필요합니다.
파일 이름이 목록에 있다는 이유만으로 글이 준비된 것은 아닙니다. 현재 코드와 화면을 다시 확인해야 하고, 과거 구현을 다룰 때는 해당 시점의 커밋을 구분해야 합니다. 해결 후 결과가 없다면 ‘해결했다’고 쓰지 않고 검증할 항목으로 남깁니다. 근거가 모이지 않은 주제는 검색량이 높더라도 초안으로 보류할 수 있습니다.
5. 마지막에 독자의 검색어로 제목을 고친다
질문과 범위를 정한 다음 독자가 어떤 말로 문제를 찾을지 살핍니다. ‘긴 영상을 AI 분석 전에 막아야 했던 이유’처럼 입력과 결정 시점을 드러내는 제목은 ‘AI 비용 최적화 총정리’보다 본문의 실제 범위를 잘 알려 줍니다. 제목이 약속한 효과를 본문이 입증하지 못한다면 제목을 좁혀야 합니다.
글감을 고를 때는 질문, 독자의 결정, 확인 자료, 구현의 한계, 발행 조건을 한 줄씩 적어 보세요. 다섯 줄이 채워지면 작업 기록이 독자를 위한 설명으로 바뀔 가능성이 높습니다. 빈칸이 남으면 더 조사하거나 주제를 작게 나누는 편이 낫습니다.