Skip to content

docs: 배경 글을 README·랜딩에서 링크 - #36

Merged
jlc488 merged 1 commit into
mainfrom
docs/link-article
Aug 8, 2026
Merged

docs: 배경 글을 README·랜딩에서 링크#36
jlc488 merged 1 commit into
mainfrom
docs/link-article

Conversation

@jlc488

@jlc488 jlc488 commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

"왜 이 공백이 생겼는지, 페이지 모델이 없는 HTML에서 줄자란 무엇일 수 있는지"를 설명한 글이 미디엄에만 있고 우리 자산 어디에서도 닿을 수 없었습니다. 방문자가 API를 읽기 전에 갖는 질문에 답하는 글이라 상단에 두는 게 맞습니다.

  • 랜딩: 히어로 CTA 아래 muted 한 줄. i18n 처리해서 영문 페이지는 "Why this exists", 한국어 페이지는 글이 영문임을 표시
  • 루트 README 양어: 공백을 설명하는 문단 바로 뒤

dev.to 교차 게시본이 아니라 미디엄 원문을 링크했습니다 — 교차 게시본의 canonical이 가리키는 대상이 원문이라서요.

검증

  • 브라우저에서 양 언어 렌더 확인, href 동일, CTA 버튼과 시각적으로 경쟁하지 않음
  • 99 테스트 그린

The write-up explaining why the gap exists — and what a ruler can mean
when HTML has no page model — lived only on Medium, unreachable from
anything we own. It answers the question a visitor has before they read
the API, so it belongs above the fold.

Landing gets a muted line under the hero CTAs (translated, so the
English page says 'Why this exists' and the Korean one flags that the
article is in English). Both root READMEs get it right after the
paragraph that states the gap.

Linked the Medium original rather than the dev.to cross-post, since
that is the canonical the cross-post points at.

Verified in a browser: renders in both languages, same href, no
competition with the CTA buttons; 99 tests green.
@jlc488
jlc488 merged commit 7a484d0 into main Aug 8, 2026
1 check passed
@jlc488
jlc488 deleted the docs/link-article branch August 8, 2026 16:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant