24편을 쓴 뒤에도, 끝났다고 할 수 없었다

01 / WORK NOTES

비슷한 검색어여도, 할 일은 반대였습니다

Column Harbor의 영어 가이드는 기존 4편을 보강하고 20편을 추가해 24편으로 확장했습니다. CSV 오류, 숫자와 ID 보존, 날짜, 텍스트 정리, 파일 비교와 결합, 형식 변환의 여섯 주제로 묶었습니다.

분류에서 중요했던 것은 같은 단어가 들어간 글을 모으는 것만이 아니었습니다. ‘숫자를 텍스트로 보존해야 하는 상황’과 ‘숫자가 텍스트라서 합계가 계산되지 않는 상황’은 비슷해 보여도 독자가 해야 할 행동은 반대입니다. 전자는 식별자를 지키는 문제이고, 후자는 계산할 값을 다루는 문제입니다.

그래서 제목과 첫 설명에 증상뿐 아니라 어떤 상황을 해결하는 글인지 드러내도록 정리했습니다. 한 글에서 모든 경우를 해결하려 하기보다, 독자가 지금 겪는 문제 하나에 맞춰 예제와 절차를 연결했습니다.

02 / WORK NOTES

설명은 있었지만, 문제가 안 보이는 예제가 있었습니다

최종 검토 중 날짜 정렬 글에서 문제 상황이 눈에 드러나지 않는 예제를 발견해 수정했습니다. 문장으로 ‘정렬이 잘못된다’고 말하더라도 독자가 같은 샘플로 차이를 확인할 수 없다면, 예제는 설명의 근거가 되기 어렵습니다.

변환 글에서는 실행 코드가 내는 결과를 예상 결과와 대조했습니다. 특히 빈 값과 0을 같은 것으로 읽지 않도록 설명을 다듬었고, TSV 변환에서는 저장한 파일을 다시 읽어 원래 값이 보존되는지 확인하도록 절차를 보강했습니다.

여러 파일을 비교하거나 합치는 글은 파일별 샘플을 내려받게 했습니다. 독자가 예제를 다시 만드는 데 시간을 쓰기보다, 설명한 차이를 바로 확인하도록 하기 위해서입니다.

03 / WORK NOTES

이미지는 장식보다 확인 도구로

본문에는 원본과 처리 결과를 비교하는 도해 48개를 준비했습니다. 실제 Excel 화면인 것처럼 꾸미기보다, 무엇이 달라지는지를 설명하는 도해로 구성했습니다. 큰 화면에서는 좌우로, 좁은 화면에서는 위아래로 읽히도록 점검했습니다.

글마다 이미지, 샘플 다운로드, 관련 글 연결을 확인했습니다. 원고가 완성돼도 내려받을 파일이 없거나 다음 설명으로 가는 링크가 끊겨 있다면, 독자에게는 미완성된 안내이기 때문입니다. 공개한 영어 가이드 둘러보기 ↗ (새 탭)

04 / WORK NOTES

공개한 글 수를 검색 성과로 쓰지 않았습니다

후속 작업에서는 브랜드명 검색과 개별 문제 해결 검색어를 나눠 보았습니다. 조회한 작업 기록에서는 홈페이지의 색인을 확인했지만, 신규 대표 글은 발견된 뒤 아직 색인되지 않은 상태였습니다. 따라서 홈페이지가 검색에 들어갔다는 사실을 모든 글의 검색 노출로 확대하지 않았습니다.

사이트 이름을 설명하는 정보와 가이드 목록 제목을 보완하고, 갱신된 사이트맵을 제출하는 작업이 이어졌습니다. 다만 이 글은 그 작업으로 순위나 방문자가 늘었다고 주장하지 않습니다. 재수집 요청이나 색인 여부는 성과 확인의 일부일 뿐입니다.

Google도 수집, 색인, 검색 결과 제공을 서로 다른 단계로 설명하고, 사이트가 지침을 따르더라도 모든 단계의 처리를 보장하지 않는다고 안내합니다. Google 검색의 처리 단계 ↗ (새 탭)

05 / WORK NOTES

다음 원고에는 ‘예상 결과’부터 적기

이번 기록에서 가져갈 수 있는 방법은 간단합니다. 원고 분량을 늘리기 전에 ‘독자가 이 샘플을 사용하면 무엇을 확인하게 되는가’를 한 줄로 적는 것입니다. 그 다음에 입력 파일, 절차, 결과, 잘못 적용하면 안 되는 조건을 맞춥니다.

제작 기록에는 공개 여부를, 검색 기록에는 색인·노출·클릭을 따로 남깁니다. 아직 측정하지 않은 칸은 0으로 채우지 않고 ‘미확인’으로 둡니다. 그래야 다음에 더 쓸지, 기존 글을 고칠지 판단할 근거가 생깁니다.