쌓인 기록에서 찾기
무엇을 찾으세요?
날짜를 몰라도 됩니다. 제목·Key Point·요약·태그를 한꺼번에 뒤집니다.
검색 범위부터 2026년 9월 25일 (금)까지1027건
9건 · "문서화"조건 지우기 ×
001▲ 135 · 댓글 76GitHub 위키는 안티패턴이다GitHub 위키의 유일한 장점은 저장소에서 한 클릭으로 접근할 수 있다는 것이다.웹 · 프론트엔드 · The GitHub wiki is an anti-pattern (2022)
GitHub 위키는 안티패턴이다
Key PointGitHub 저장소의 문서 관리 방식을 선택할 때, 위키보다 /docs 폴더가 버전 관리, 코드 리뷰, 로컬 접근성에서 월등히 우수한 이유를 알 수 있다.
핵심 요약
- GitHub 위키의 유일한 장점은 저장소에서 한 클릭으로 접근할 수 있다는 것이다.
- 반면 /docs 폴더를 사용하면 문서가 코드와 함께 버전 관리되고, 로컬 클론 시 자동으로 포함되며, 풀 리퀘스트를 통해 피어 리뷰를 받을 수 있다.
- 위키는 이미지 업로드를 지원하지 않고, 커스터마이징 옵션이 제한적이며, 문서 편집에 깃허브의 PR 프로세스를 적용할 수 없다.
- /docs 폴더에 문서를 두고 GitHub Pages를 통해 배포하면서, 위키에는 호스팅된 문서로 연결하는 페이지 하나만 남기는 것을 권장한다.
- 문서가 증가하면 나중에 별도 저장소로 분리할 수 있으며, 기여자들은 이미 저장소 기반 작업에 익숙해진다.
AI · 머신러닝 · Markdown in /src
마크다운은 문서가 아닌 소스 코드가 되어야 한다
Key PointAI 에이전트로 코드를 생성하는 워크플로우에서 원본 설계 의도가 사라지는 문제를 구조적으로 해결하는 접근법을 제시한다.
핵심 요약
- AI 기반 코딩이 확산되면서 마크다운이 문서가 아닌 실제 소스 코드의 역할을 하고 있다.
- 현재 LLM 코드 생성은 대화형 프롬프트에서 나오므로 원본 의도를 추적할 수 없는 문제가 있다.
- 마크다운을 /src/md 디렉토리에 버전 관리하면서 소스 코드와 함께 둬야 개발자와 에이전트 모두 의도를 파악할 수 있다.
- 마크다운은 일반 텍스트라 diff와 검색이 가능하고, LLM도 자연스럽게 읽고 쓸 수 있으며, 휴먼리더블하다는 장점이 있다.
- 마크다운은 아키텍처·데이터 설계 같은 중간 수준의 결정을 담고, 테스트는 그 마크다운에 기반해 파생되어야 한다.
- 위키나 선형 같은 별도 도구는 고수준 설계나 프로세스 문서로 남고, 현재의 의도와 행동은 소스 디렉토리 안 마크다운에 집중시켜야 한다.
오픈소스 · 도구 · CarterPerez-dev/Cybersecurity-Projects · Go
사이버보안 입문부터 고급까지 70개 프로젝트 모음
Key Point코딩 경험이 없는 사람부터 전문가까지 단계별로 실무 기반 사이버보안 프로젝트를 구축할 수 있는 체계가 마련돼 있기 때문이다.
핵심 요약
- 사이버보안 학습을 위한 70개 프로젝트와 자격증 로드맵, 학습 자료를 제공하는 GitHub 저장소다.
- 프로젝트는 기초(초보자 미만)·초급·중급·고급 4단계로 나뉘며, 해시 식별자, HTTP 헤더 스캐너, 비밀번호 매니저, 포트 스캐너, 취약점 스캐너 등을 포함한다.
- 기초 과정의 모든 프로젝트는 Python 단일 파일로 구성되고 개념 설명과 함수 문서화로 처음 프로그래밍하는 사람도 이해할 수 있도록 작성됐다.
- 각 프로젝트마다 소스코드, 상세 학습 자료, 해시 알고리즘·암호화·네트워크·패킷 분석 등 구체적 기술을 배울 수 있다.
- SOC 분석가, 침투 테스트, 보안 엔지니어 등 10가지 직무별 자격증 취득 경로도 별도로 제시한다.
AI · 머신러닝 · MCP was always a bad idea?
MCP는 이미 시대에 뒤떨어진 기술이 되었다
Key PointLLM 능력의 획기적 향상으로 기존 에이전트 통합 방식의 근본적 재평가가 시작되었고, 개발팀이 아키텍처를 재검토해야 할 시점이다.
핵심 요약
- MCP는 2024년 11월 Anthropic이 LLM을 외부 서비스에 연결하기 위해 출시한 프로토콜이었다.
- 초기에는 유용했으나, LLM의 성능이 급격히 향상되면서 MCP의 장점이 퇴색했다.
- 현재의 고급 LLM은 터미널 접근으로 CLI를 직접 호출하고 스크립트를 실행할 수 있어, MCP 서버 대부분을 대체할 수 있다.
- LLM이 --help 명령으로 API를 자동 발견하고, 문서화된 HTTP API를 직접 호출하는 능력이 생겼다.
- 대신 HTTP API에 Accept: text/markdown 헤더나 Accept-Language 헤더 같은 표준 프로토콜을 강화하는 방향이 효율적이다.
- MCP는 과시대 프로토콜이므로, HTTP API와 CLI 직접 사용으로의 전환을 추진해야 한다.
하드웨어 · 시스템 · A graphical desktop for the ZX Spectrum
1982년 스펙트럼에 윈도우 데스크톱 구현했다
Key Point40년 전 8비트 컴퓨터의 극한 성능을 끌어내는 저수준 최적화 기법과 메모리 절약 설계가 임베디드나 리소스 제약 환경의 개발자에게 참고할 만한 가치가 있다.
핵심 요약
- 1980년대 꿈꾸던 GEM 데스크톱을 ZX Spectrum 48K 위에서 Z80 어셈블리로 구현했다.
- 중첩 윈도우, 풀다운 메뉴, Kempston 마우스/조이스틱 지원, 힙 메모리 관리, 이벤트 큐, 파일 매니저 등 현대적 기능을 3.5MHz, 48K RAM 환경에 모두 담았다.
- 한 프레임(69,888 T사이클) 안에 윈도우 드래그를 완료하고, 실제 기계에서 실행되며, 설정과 상태 정보를 저장·복구한다.
- 메모리 레이아웃, 비임 스케줄링, 입력 처리 등 매우 제약된 하드웨어에서의 최적화 기법을 상세히 문서화했다.
기타 · Lucasart's Afterlife
27년 된 '신의 도시' 게임, 여전히 공략 문제가 남아있다
Key Point1996년 게임인데도 전략 설명이 거의 존재하지 않아, 27년 만에 게임 메커니즘을 체계적으로 문서화한 글로서 해당 게임 커뮤니티의 공백을 채운다.
핵심 요약
- 1996년 루카스아츠의 '애프터라이프'는 천국과 지옥을 배경으로 한 도시 시뮬레이션 게임으로, 속편이나 이를 능가하는 작품이 없다.
- 게임은 초기 음수 수입 문제, 도로 효율성 배치의 차이(천국은 효율적 격자형, 지옥은 비효율적 뱀 모양), 영역 유형의 '진동' 시스템 등 복잡한 메커니즘을 가졌다.
- 천국은 다양성 보너스를 원하므로 다양한 구역 인접이 좋고, 지옥은 단일 구역(녹색) 집중이 최적이며, 3×3 빌딩 개발이 주요 목표다.
- 일부 건물은 업그레이드 사이클에서 크기가 변하는데, 세 번째 게이트는 4×4로 커져서 공간 부족 시 건설 불가 상황이 생긴다.
- 게임 진행 중 구역 인구는 시간이 지남에 따라 증가하고, 3×3 건물 발전는 작은 2×2 구역이 생기지 않도록 격리된 영역에서만 가능할 수 있다.
- 락(Lock) 기능은 각 구역 타입마다 최고 인구 2×2 건물에만 필요하며, 3×3 건물은 락할 필요가 없다.
오픈소스 · 도구 · One Year of Sponsored Servo Development
후원금으로 운영된 1년, Servo 프로젝트 성과 공개
Key Point오픈소스 프로젝트가 소규모 후원으로 풀타임 개발자를 지원했을 때 실제로 이루는 구체적인 성과를 보여주는 사례로, 오픈소스 지속가능성 모델에 관심 있는 개발자와 프로젝트 관리자에게 참고가 된다.
핵심 요약
- Servo 프로젝트는 장기 유지보수자 Josh Bowman-Matthews를 OpenCollective와 GitHub 월정액 후원으로 고용해 기여자 경험 개선에 집중했다.
- 1년간 8명의 신규 유지보수자 영입, 1150개 풀 리퀘스트 검토, 114개의 신규 기여자 대상 이슈 작성(92% 해결)을 진행했다.
- JavaScript 엔진 통합 대규모 재작성을 통해 가비지 컬렉션 관련 간헐적 패닉 문제를 해결하고 불안정한 테스트를 개선했다.
- 새로운 문서화 작업으로 보로우 해저드, 실험적 기능, AI 정책, 테스트 실패 해결법 등을 정리했다.
- 이 역할을 통해 가족과의 시간을 유지하면서도 프로젝트 접근성을 높이는 의미 있는 기여가 가능했다고 평가했다.
오픈소스 · 도구 · HakanSeven12/OpenCADStudio · Rust
Rust로 만든 오픈소스 CAD, 데스크톱과 웹에서 DWG/DXF 지원
Key PointAutoCAD 같은 고가 CAD 소프트웨어의 오픈소스 대안으로, 기술 드로잉이 필요한 개발자와 엔지니어에게 무료로 DWG/DXF 호환성을 제공한다.
핵심 요약
- Rust 기반 크로스플랫폼 CAD 애플리케이션으로 2D 드래프팅과 3D 모델링을 모두 지원한다.
- DWG와 DXF 파일을 변환 없이 직접 읽고 쓸 수 있으며, 데스크톱과 브라우저 버전이 동일한 편집 핵심을 공유한다.
- GPU 가속 렌더링, 정밀한 2D 작도 도구(스플라인, 해치, 레이어), 3D 모델링(불린 연산, 로프트 등), 문서화 도구를 갖춘다.
- 웹 앱은 설치 없이 즉시 사용 가능하며, 데스크톱 앱은 Windows/Linux/macOS(Apple Silicon)를 지원하고 PDF 출력, 플러그인, 명령어 스크립트를 제공한다.
- STL/STEP 포맷 내보내기, OBJ/LandXML 임포트, CSV 추출 등 다양한 파일 포맷을 지원하고 21개 인터페이스 언어를 포함한다.
- 헤드리스 변환, 자동화 서버, AI 애플리케이션용 MCP 엔드포인트로 자동화 워크플로우를 제공한다.
인프라 · 데브옵스 · Research carried out using NetBSD
NetBSD로 진행된 주요 네트워크 연구 사례들
Key Point네트워크 및 시스템 연구자들이 NetBSD를 선택하는 이유와 실제 연구 성과를 구체적으로 알 수 있으며, 오픈소스 OS의 실용적 가치를 보여주는 사례들입니다.
핵심 요약
- NASA는 위성 통신 환경에서 TCP 프로토콜 개선을 테스트하기 위해 NetBSD를 사용 중이며, 선택적 응답 확인(FACK TCP) 등 새로운 메커니즘을 검증하고 있다.
- KAME 프로젝트는 NetBSD 커널에 IPv6와 IPsec 같은 최신 TCP/IP 기술을 구현했으며, 1999년 6월 NetBSD-current 트리에 병합되었다.
- IMK는 NetBSD 위에서 네트워크 접근 제어, 보안 터널링, 스팸 방지, Sendmail 대체 도구 등을 개발 중이다.
- 스웨덴 대학 네트워크(SUNET)는 NetBSD 2.0이 탑재된 Dell 2650 2대로 Internet2 Land Speed Record를 달성해 69.073 Petabit-meters/초의 속도로 840GB를 30분 내 전송했다.
- NEC 유럽 연구소와 다른 기관들은 NetBSD의 오픈소스, 문서화, 다양한 플랫폼 지원, 확장 가능한 TCP 코드를 이유로 네트워크 연구 플랫폼으로 선택했다.