Skip to content

docs: make homepage README visitor-first - #203

Open
seonghobae wants to merge 3 commits into
mainfrom
docs/deepwiki-badge
Open

docs: make homepage README visitor-first#203
seonghobae wants to merge 3 commits into
mainfrom
docs/deepwiki-badge

Conversation

@seonghobae

@seonghobae seonghobae commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Outcome

Turn the organization homepage repository README from a badge-only stub into a useful public entry point for visitors, maintainers, integrators, and prospective buyers while preserving the existing static-site runtime unchanged.

  • keep the exact-cased Ask DeepWiki badge for ContextualWisdomLab/ContextualWisdomLab.github.io;
  • explain the repository’s responsibility as the organization-level public narrative/navigation surface rather than a product runtime or system of record;
  • summarize the current Korean/English, Contextual Wisdom/DIKW, research/evidence, Naruon, project/fork and GitHub discovery surfaces already present in index.html;
  • document zero-build local preview, primary editing files, accessibility/security/performance boundaries, and content-authority rules;
  • make customer/release/certification/adoption claims explicitly evidence-bound to owning product repositories;
  • document the existing MIT source/documentation license while preserving independent third-party asset obligations;
  • record the README refresh in the repository changelog without changing the static site runtime.

Product / authority boundary

This repository may describe and navigate the organization, but it does not become authoritative for linked products’ APIs, databases, PRDs, releases, deployments, security posture, certifications, customer evidence, or product-specific licenses. Material product changes should land in their owning repositories first and then be reconciled here.

Licensing due diligence

The repository already carries a root MIT License with Copyright (c) 2026 ContextualWisdomLab. Repository search found no GPL/LGPL/AGPL or noncommercial license markers in the current source surface. The README keeps that MIT grant scoped to ContextualWisdomLab original source/documentation and states that independently licensed external assets/materials retain their own terms. No dependency or asset is relicensed by this documentation change.

Current exact authority — 2026-09-02

  • protected base recorded by GitHub: main@8103aad3582a024946b835d7eee858f65339a184;
  • exact current head: 8002e7641d60238e38cfa70ef40c48f8f9e88709;
  • GitHub reports open, non-Draft and mechanically mergeable;
  • current head changes README plus the matching changelog record only;
  • exact-head SAST Semgrep 33575531670 and Security Scan 33575531675 are queued and therefore non-passing;
  • the predecessor c7afa69a... runs were cancelled after the head moved and are historical, not failure evidence for this head.

Scope / merge boundary

README and matching changelog only. Existing index.html, i18n.js, styles.css, assets, browser CSP, workflows, credentials, deployment, and repository settings are unchanged. No publication, release, certification, customer, or deployment claim is created.

Merge only after the unchanged exact head satisfies all applicable checks, valid review/thread requirements, mergeability/base conditions and then-live governance. Do not reuse cancelled/predecessor evidence or bypass required protection.

@seonghobae seonghobae added the documentation Improvements or additions to documentation label Sep 1, 2026 — with ChatGPT Codex Connector
@coderabbitai

coderabbitai Bot commented Sep 1, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: e39c06a2-a725-4c2f-b5bf-3967ee010634

📥 Commits

Reviewing files that changed from the base of the PR and between c7afa69 and 8002e76.

📒 Files selected for processing (1)
  • CHANGELOG.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

README.md가 정적 조직 홈페이지의 목적과 범위, 저장소 경계, 로컬 미리보기, 편집 절차, 품질 규칙, 추가 탐색 경로와 라이선스를 설명하도록 확장되었습니다. CHANGELOG.md에는 이 문서 변경 사항이 기록되었습니다.

Changes

README 문서 업데이트

Layer / File(s) Summary
홈페이지 범위와 탐색 항목
README.md
README.md가 홈페이지의 목적과 방문자 탐색 항목을 설명합니다. DeepWiki 배지 링크를 유지합니다.
저장소 경계와 편집 절차
README.md
README.md가 홈페이지와 제품 저장소의 소유 범위를 구분합니다. 정적 사이트의 로컬 미리보기 명령과 공개 표면 편집 대상을 설명합니다.
품질 규칙과 추가 안내
README.md, CHANGELOG.md
README.md가 공개 주장, 외부 에셋, CSP, 후속 탐색 경로와 라이선스 규칙을 설명합니다. CHANGELOG.md가 이 문서 개선 사항을 기록합니다.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Merge Risk: ⚪ Minimal · up to 8002e

This is a localized documentation change that leaves the static-site runtime and deployment behavior unchanged; no actionable merge-blocking risk remains after normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed PR 제목은 README를 방문자 중심의 공개 진입점으로 개선한 주요 변경 사항을 정확하고 간결하게 설명합니다.
Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/deepwiki-badge

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note

This report is out of date. Scroll down for Devin Review's latest report on this PR.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Devin Review

@seonghobae
seonghobae enabled auto-merge (squash) September 1, 2026 14:15
@opencode-agent
opencode-agent Bot disabled auto-merge September 1, 2026 17:45

@cwl-noema-review cwl-noema-review Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Noema LLM review

The PR adds a single markdown badge line to README.md linking to DeepWiki. The change is purely documentation, introduces no code or behavioral changes, and the badge URL and target are consistent with the repository name. No security or maintainability concerns identified.

Reviewed changed lines

  • README.md:3 (RIGHT): Added line contains a standard markdown image link: Ask DeepWiki. The image source is an external SVG badge, and the link points to the DeepWiki page for this repository. The markdown syntax is correct, and the URL structure matches the repository path. No issues with formatting or content.

Adversarial validation

  • README.md:3 (RIGHT) falsified: The badge URL or link target is malformed or points to a non-existent resource, causing a broken image or link. — Source-traced: the repository is ContextualWisdomLab/ContextualWisdomLab.github.io, and the link uses the same owner/repo. The badge URL is a standard DeepWiki endpoint. The markdown syntax is valid per CommonMark.
  • Residual risk: The external badge image (deepwiki.com/badge.svg) may fail to load if the DeepWiki service is unavailable, but this is a transient external dependency and not a regression introduced by this PR. The link target is also external but is the intended destination.

Findings

  • No blocking findings.

  • Result: APPROVE

  • Head SHA: 65a989fe0981519a65f4b93de90744ed24e07b1b

  • Reviewer credential: noema-review-github-app

  • Actor: cwl-noema-review[bot]

@seonghobae seonghobae changed the title docs: add Ask DeepWiki badge docs: make homepage README visitor-first Sep 1, 2026
devin-ai-integration[bot]

This comment was marked as resolved.

@seonghobae seonghobae added priority: medium Normal-priority or P2 work status: needs-review Open pull request requiring current-head review or checks labels Sep 1, 2026 — with ChatGPT Codex Connector

@cwl-noema-review cwl-noema-review Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Noema LLM review

The PR expands the homepage README into a visitor-first public entry point and adds a matching [Unreleased] changelog entry. The documentation is accurate, consistent with the repository's stated boundaries, and does not introduce any behavioral or security regressions. The changelog entry correctly records the README overhaul, and the README's claims about the site (language switch, DIKW framing, Naruon introduction, project/fork sections, CSP, self-hosted assets) are consistent with the existing codebase as described in the diff context. No blocking issues found.

Reviewed changed lines

  • CHANGELOG.md:4 (RIGHT): The new changelog entry accurately summarizes the README expansion, covering the public entry point, repository responsibility boundaries, local preview, content authority, quality/trust rules, and MIT license documentation. It is placed under [Unreleased] as required by CLAUDE.md.
  • README.md:5 (RIGHT): The bold statement clearly defines the repository's purpose as the public home for ContextualWisdomLab, setting visitor expectations and separating research context from product authority. This aligns with the repository's actual role as a static homepage.
  • README.md:78 (RIGHT): The license section correctly states that original source and documentation are MIT-licensed while third-party assets retain their own licenses. This is consistent with the repository's LICENSE file and avoids overclaiming.

Adversarial validation

  • README.md:5 (RIGHT) falsified: The README's description of the site's features (language switch, DIKW framing, Naruon introduction, project/fork sections) matches the actual index.html and i18n.js content. — The diff context and prior review threads confirm the site includes a Korean/English switch, DIKW framing, research/evidence sections, a Naruon introduction, and project/fork discovery. The README's list is consistent with the repository's known structure.
  • CHANGELOG.md:4 (RIGHT) falsified: The changelog entry accurately reflects the README changes and does not omit any user-facing modifications. — The diff shows the README was expanded from a minimal static-homepage description to a comprehensive visitor-first document. The changelog entry explicitly mentions the public entry point, responsibility boundaries, local preview, content authority, quality/trust rules, and MIT license—all present in the new README. The prior review thread confirmed the entry was added on the exact head SHA.
  • Residual risk: low

Findings

  • No blocking findings.
  • Result: APPROVE
  • Head SHA: 8002e7641d60238e38cfa70ef40c48f8f9e88709
  • Reviewer credential: noema-review-github-app-refresh
  • Actor: cwl-noema-review[bot]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation priority: medium Normal-priority or P2 work status: needs-review Open pull request requiring current-head review or checks type: docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant