6 Matching Annotations
  1. Last 7 days
    1. COBOL

      FORTRAN에서 COBOL·LUNAR·SHRDLU·NaturalJava로 넘어가는 대목 에서 도구가 많이 나오지만, 각 사례가 무엇을 더 쉽게 했는지 독자가 머릿속으로 계속 비교해야 합니다. 사례마다 “사람이 하던 일 / 도구가 맡은 일 / 사람이 여전히 정한 일”을 한 문장으로 정리하거나, 중간에 짧은 요약을 넣으면 흐름을 따라가기 쉬울 것 같습니다.

    2. 문장 구조를 읽는 데 성공하더라도 ’당신의’가 누구의 소유를 뜻하는지 처리할 규칙이 없었고, 자료에는 표본의 무게도 없었다.

      실패 원인이 문장 구조 처리와 데이터 부재, 두 가지로 제시됩니다. 하지만 무게 자료가 없었다면 질문에 답할 수 없었던 가장 직접적인 이유는 데이터 부재로 보입니다. 시스템이 어디까지 문장을 분석했고 어느 단계에서 실패했는지 구분해 설명하면 사례가 더 명확히 읽힐 것 같습니다.

    3. 프로그램과 이를 사용하는 데 필요한 자료 등을 통틀어 소프트웨어라고 부른다.

      앞에서는 프로그램과 코드의 차이를 설명하고, 여기서는 자료도 소프트웨어에 포함한다고 합니다. 독자는 “신청자 명단 같은 데이터도 소프트웨어인가?”라고 헷갈릴 수 있을 것 같습니다. 소프트웨어와 데이터의 관계를 구분하거나, 이 문장을 더 단순하게 다듬으면 좋겠습니다.

    1. 신청 화면, CSV를 읽는 코드

      “신청 화면”, “CSV를 읽는 코드”, “공통 함수”, “이미 저장된 신청 명단”이 짧은 구간에 함께 등장합니다. 개발자가 아닌 독자는 무엇이 각각의 파일이고, 왜 같은 규칙을 두 곳에 적용해야 하는지 놓칠 수 있을 것 같습니다. “웹으로 신청한 사람과 파일에서 가져온 사람을 한 명단에 합친다”는 그림이나 짧은 단계 설명을 먼저 두면 이해하기 더 쉬울 것 같습니다.

    2. 두 경우의 차이는 최종적으로 몇 개의 파일을 고쳤는지보다, 어디를 어떻게 고칠지 알아내는 과정까지 맡겼는지에 있다

      앞서 Composer와 에이전트의 설명이 길게 이어져 독자가 차이를 놓칠 수도 있을 것 같습니다. 개발자가 수정 방법을 지정하는 경우와 도구가 원인을 찾아 수정 방법까지 정하는 경우를 짧게 설명해주면 요점이 잘 드러날 것 같습니다.

    1. 4.4. 화면 표시와 데이터 접근 권한을 구분해야 한다

      권한 설정과 데이터가 사용자 기기로 전달되는 설명은 중요하지만, 앞의 화면 구성 이야기에서 갑자기 기술적인 보안 세부로 넘어가는 느낌이 듭니다. “명단을 화면에서 감추는 것만으로는 접근을 막을 수 없다”는 쉬운 사례를 먼저 들고, 왜 데이터 접근 권한 설정이 필요한지 연결하면 비개발자도 따라가기 조금 더 쉬울 것 같습니다.