Repository navigation
docs: 개발자용 GitHub Pages 포털과 자동 게시 구축 - #59
Merged
Merged
Conversation
문서 유형별 수명주기, 검색, Pages 배포 및 기존 콘텐츠 마이그레이션 기준을 확정한다.
사례, 가이드, 실습, 리서치 page bundle로 기존 콘텐츠를 이관한다. 메뉴와 서비스·태그 색인을 메타데이터에서 생성하고 Microsoft Learn 검증, 공개 안전성, Pages 배포 검사를 자동화한다.
Keep the existing Oryx build workflow aligned with the sample's new location and cover the path with a regression test.
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
Public-safety gaps, broken relocated tests, and several sample runtime failures must be corrected before publication.
Get a fresh assessment by requesting another Copilot review.
Pull request overview
공개 Azure 기술 문서를 검색 가능한 MkDocs 기반 GitHub Pages로 전환하고, 문서 분류·검증·배포 체계와 실행 샘플을 정비합니다.
Changes:
- 62개 문서를 page bundle 구조와 taxonomy 기반 색인으로 마이그레이션
- 문서 검증 도구, Microsoft Learn 검증 skill, CI 및 Pages 배포 추가
- 실행 코드·인프라·증거 자료를
samples/로 분리하고 식별자 일부 비식별화
File summaries
| File | Description |
|---|---|
tests/docs/test_microsoft_learn_skill.py |
Learn skill 설정 테스트 |
tests/docs/test_authoring_guidance.py |
작성 지침 계약 테스트 |
tests/docs/fixtures/valid-guide.md |
유효 메타데이터 fixture |
tests/docs/fixtures/invalid-guide.md |
잘못된 문서 fixture |
scripts/docs/validate_sources.py |
공식 출처 검증 CLI |
scripts/docs/validate_public_safety.py |
공개 안전성 검사 |
scripts/docs/validate_metadata.py |
문서 메타데이터 검사 |
scripts/docs/hooks.py |
검증 상태 렌더링 hook |
samples/infrastructure/bicep/modules/monitoring.bicep |
모니터링 리소스 모듈 |
samples/infrastructure/bicep/main.bicepparam |
모니터링 배포 매개변수 |
samples/infrastructure/bicep/main.bicep |
모니터링 배포 진입점 |
samples/azure-storage/source-material/spring-resumable-upload/src/main/resources/application.yml |
업로드 앱 설정 |
samples/azure-storage/source-material/spring-resumable-upload/src/main/java/com/example/upload/UploadApplication.java |
Spring Boot 진입점 |
samples/azure-storage/source-material/spring-resumable-upload/src/main/java/com/example/upload/tus/TusFilter.java |
tus 헤더 필터 |
samples/azure-storage/source-material/spring-resumable-upload/src/main/java/com/example/upload/config/BlobConfig.java |
Blob 클라이언트 구성 |
samples/azure-storage/source-material/spring-resumable-upload/scripts/verify-blob.sh |
업로드 검증 스크립트 |
samples/azure-storage/source-material/spring-resumable-upload/scripts/make-test-file.sh |
테스트 파일 생성기 |
samples/azure-storage/source-material/spring-resumable-upload/pom.xml |
Java 의존성 구성 |
samples/azure-storage/source-material/spring-resumable-upload/.gitignore |
샘플 제외 규칙 |
samples/azure-openai/ptu-load-balancing/runbooks/requirements.txt |
PTU 런북 의존성 |
samples/azure-openai/ptu-load-balancing/runbooks/optional_adaptive_tpm_quota_controller.ps1 |
구독 ID 비식별화 |
samples/azure-openai/ptu-load-balancing/runbooks/adaptive_tpm_quota_controller.py |
구독 ID 비식별화 |
samples/azure-openai/ptu-load-balancing/README.md |
PTU 샘플 안내 |
samples/azure-mysql/source-material/nodejs/simulation/scripts/06-rollback-or-cleanup.ps1 |
롤백·정리 스크립트 |
samples/azure-mysql/source-material/nodejs/simulation/scripts/04-watch-logs.ps1 |
실시간 로그 관찰 |
samples/azure-mysql/source-material/nodejs/simulation/scripts/03-build-push.ps1 |
ACR 빌드·배포 |
samples/azure-mysql/source-material/nodejs/simulation/scripts/01-deploy-infra.ps1 |
시뮬레이션 인프라 배포 |
samples/azure-mysql/source-material/nodejs/simulation/k8s/deployment.yaml |
CRUD 워커 배포 |
samples/azure-mysql/source-material/nodejs/simulation/infra/main.bicepparam |
MySQL 배포 매개변수 |
samples/azure-mysql/source-material/nodejs/simulation/app/package.json |
Node.js 앱 의존성 |
samples/azure-mysql/source-material/nodejs/simulation/app/Dockerfile |
Node.js 앱 이미지 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/tests/test_render_capture.py |
캡처 렌더링 테스트 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/tests/test_loadgen.py |
부하 생성기 테스트 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/tests/test_dynamic_threshold_brief.py |
Dynamic Threshold 자료 테스트 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/tests/test_capture_model.py |
캡처 비식별화 테스트 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/render_briefing_assets.py |
브리핑 자산 비식별화 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/generate_notifications.py |
알림 자료 비식별화 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/azd-postprovision-local.sh |
azd 사후 구성 |
samples/azure-monitor/source-material/sre-agent-event-lab/scripts/azd-configure.sh |
azd 사전 구성 |
samples/azure-monitor/source-material/sre-agent-event-lab/infra/tests/test_workload_networking.py |
네트워크 인프라 테스트 |
samples/azure-monitor/source-material/sre-agent-event-lab/infra/observability.bicep |
관측 리소스 배포 |
samples/azure-monitor/source-material/sre-agent-event-lab/infra/main.parameters.json |
azd 배포 매개변수 |
samples/azure-monitor/source-material/sre-agent-event-lab/infra/lab.bicep |
실습 모듈 조합 |
samples/azure-monitor/source-material/sre-agent-event-lab/azure.yaml |
azd 프로젝트 구성 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/official/custom-skill-flow.svg |
Custom Skill 다이어그램 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/notifications/s1-incident-summary.html |
비식별화된 사고 요약 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/notifications/s1-github-issue.md |
비식별화된 이슈 초안 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/notifications/github-issue.json |
이슈 증거 자료 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/captures/s3/timeline.mmd |
S3 타임라인 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/captures/s2/timeline.mmd |
S2 Mermaid 타임라인 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/captures/s2/timeline.md |
S2 Markdown 타임라인 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/captures/s1/timeline.mmd |
S1 Mermaid 타임라인 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/captures/s1/timeline.md |
S1 Markdown 타임라인 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/captures/s1-before-bridge/timeline.mmd |
Bridge 이전 타임라인 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/captures/s1-before-bridge/timeline.md |
Bridge 이전 기록 |
samples/azure-monitor/source-material/sre-agent-event-lab/assets/briefing/s1-three-panel.svg |
사고 브리핑 SVG |
samples/azure-monitor/source-material/sre-agent-event-lab/app/tests/test_telemetry.py |
Telemetry 구성 테스트 |
samples/azure-monitor/source-material/sre-agent-event-lab/app/tests/conftest.py |
앱 테스트 경로 구성 |
samples/azure-monitor/source-material/sre-agent-event-lab/app/telemetry.py |
Azure Monitor 계측 |
samples/azure-monitor/source-material/sre-agent-event-lab/app/requirements.txt |
앱 런타임 의존성 |
samples/azure-monitor/source-material/sre-agent-event-lab/app/requirements-dev.txt |
앱 테스트 의존성 |
samples/azure-monitor/source-material/sre-agent-event-lab/app/Dockerfile |
FastAPI 앱 이미지 |
samples/azure-monitor/source-material/sre-agent-event-lab/app/.dockerignore |
이미지 빌드 제외 규칙 |
samples/azure-monitor/source-material/sre-agent-event-lab/.gitignore |
azd 로컬 상태 제외 |
samples/azure-monitor/source-material/sre-agent-event-lab/.env.example |
실습 환경 예시 |
samples/azure-monitor/source-material/assets/prometheus-grafana/prometheus.yml |
Kafka scrape 구성 |
samples/azure-monitor/source-material/assets/prometheus-grafana/grafana/provisioning/datasources/prometheus.yml |
Grafana 데이터 소스 |
samples/azure-monitor/source-material/assets/prometheus-grafana/grafana/provisioning/dashboards/provider.yml |
대시보드 provider |
samples/azure-monitor/source-material/assets/prometheus-grafana/docker-compose.yml |
모니터링 스택 |
samples/azure-managed-redis/source-material/nodejs/cluster_example/server.js |
Redis 진단 서버 |
samples/azure-managed-redis/source-material/nodejs/cluster_example/package.json |
Redis 샘플 의존성 |
samples/azure-ai-search/source-material/custom_vectorization/vllm-adapter/requirements.txt |
vLLM adapter 의존성 |
samples/azure-ai-search/source-material/custom_vectorization/vllm-adapter/Dockerfile |
vLLM adapter 이미지 |
samples/azure-ai-search/source-material/custom_vectorization/vllm-adapter/app.py |
vLLM 계약 adapter |
samples/azure-ai-search/source-material/custom_vectorization/tei-adapter/requirements.txt |
TEI adapter 의존성 |
samples/azure-ai-search/source-material/custom_vectorization/tei-adapter/k8s/deployment.yaml |
TEI와 adapter 배포 |
samples/azure-ai-search/source-material/custom_vectorization/tei-adapter/Dockerfile |
TEI adapter 이미지 |
samples/azure-ai-search/source-material/custom_vectorization/tei-adapter/app.py |
TEI 계약 adapter |
samples/azure-ai-search/source-material/custom_vectorization/reranker-adapter/requirements.txt |
Reranker 의존성 |
samples/azure-ai-search/source-material/custom_vectorization/reranker-adapter/Dockerfile |
Reranker 이미지 |
samples/azure-ai-search/source-material/custom_vectorization/reranker-adapter/app.py |
Reranking adapter |
samples/azure-ai-search/source-material/custom_vectorization/k8s/ingress.yaml |
임베딩 ingress |
samples/azure-ai-search/source-material/custom_vectorization/k8s/deployment.yaml |
임베딩 API 배포 |
samples/azure-ai-search/source-material/custom_vectorization/k8s/cluster-issuer.yaml |
ACME issuer |
samples/azure-ai-search/source-material/custom_vectorization/embedding-api/requirements.txt |
임베딩 API 의존성 |
samples/azure-ai-search/source-material/custom_vectorization/embedding-api/Dockerfile |
임베딩 API 이미지 |
samples/azure-ai-search/source-material/custom_vectorization/bench/requirements.txt |
벤치마크 의존성 |
samples/azure-ai-search/source-material/custom_vectorization/bench/k8s/job-bench-push.yaml |
Push 벤치마크 Job |
samples/azure-ai-search/source-material/custom_vectorization/bench/k8s/job-bench-indexer.yaml |
Indexer 벤치마크 Job |
samples/azure-ai-search/source-material/custom_vectorization/bench/k8s/job-bench-concurrency.yaml |
동시성 벤치마크 Job |
samples/azure-ai-search/source-material/custom_vectorization/bench/k8s/configmap.yaml |
벤치마크 환경 구성 |
samples/azure-ai-search/source-material/custom_vectorization/bench/Dockerfile |
벤치마크 이미지 |
samples/azure-ai-search/source-material/custom_vectorization/bench/bench_runner.py |
벤치마크 실행기 |
samples/azure-ai-search/analyzer-comparison/sample_data.json |
분석기 비교 데이터 |
samples/azure-ai-search/analyzer-comparison/requirements.txt |
분석기 샘플 의존성 |
samples/azure-ai-search/analyzer-comparison/images/.gitkeep |
이미지 디렉터리 유지 |
samples/azure-ai-search/analyzer-comparison/.gitignore |
로컬 설정 제외 |
samples/azure-ai-search/analyzer-comparison/.env.example |
Search 환경 예시 |
samples/app-service/oryx-test/requirements.txt |
Oryx 테스트 의존성 |
samples/app-service/oryx-test/app.py |
Oryx Flask 앱 |
samples/aks/source-material/pyroscope-chat-profiling/requirements.txt |
Pyroscope 샘플 의존성 |
samples/aks/source-material/pyroscope-chat-profiling/Dockerfile |
Pyroscope 앱 이미지 |
samples/aks/source-material/memray-leak-profiling/requirements.txt |
Memray 앱 의존성 |
samples/aks/source-material/memray-leak-profiling/loadgen.py |
메모리 누수 부하 생성기 |
samples/aks/source-material/memray-leak-profiling/k8s/loadgen.yaml |
부하 생성기 배포 |
samples/aks/source-material/memray-leak-profiling/k8s/leaky-agent.yaml |
누수 앱 배포 |
samples/aks/source-material/memray-leak-profiling/Dockerfile |
누수 앱 이미지 |
samples/aks/source-material/memray-leak-profiling/debug/Dockerfile |
Memray 디버그 이미지 |
samples/aks/source-material/local_dev_loop/local/mirrord.json |
mirrord 구성 |
samples/aks/source-material/local_dev_loop/local/local-server.py |
로컬 개발 서버 |
samples/aks/source-material/local_dev_loop/k8s/echo-service.yaml |
원격 echo 서비스 |
requirements-docs.txt |
문서 빌드 의존성 |
mkdocs.yml |
MkDocs 사이트 구성 |
docs/tags.md |
태그 색인 페이지 |
docs/research/hdinsight/kafka-catchup-sku-fetch-benchmark/index.md |
Kafka 성능 리서치 |
docs/research/azure-monitor/hdinsight-kafka-monitoring-options/index.md |
Kafka 모니터링 비교 |
docs/research/azure-monitor/dynamic-thresholds-brief/index.md |
Dynamic Threshold 리서치 |
docs/research/azure-ai-search/rag-chunking-strategies/index.md |
RAG 청킹 리서치 |
docs/research/azure-ai-search/bge-m3-vs-qwen3-embedding/index.md |
임베딩 품질 비교 |
docs/research/azure-ai-foundry/agent-memory-taxonomy/index.md |
Agent memory 분류 |
docs/research/azure-ai-foundry/agent-memory-production-evaluation/index.md |
운영·평가 리서치 |
docs/research/azure-ai-foundry/agent-memory-pipeline-retrieval/index.md |
메모리 검색 파이프라인 |
docs/research/azure-ai-foundry/agent-memory-frameworks/index.md |
메모리 프레임워크 비교 |
docs/research/azure-ai-foundry/agent-memory-commerce/index.md |
커머스 메모리 설계 |
docs/research/azure-ai-foundry/agent-memory-architecture-patterns/index.md |
메모리 아키텍처 패턴 |
docs/research/azure-ai-foundry/agent-framework-2026/index.md |
Agent Framework 분석 |
docs/labs/azure-monitor/sre-agent-scenario-latency/index.md |
지연 장애 실습 |
docs/labs/azure-monitor/sre-agent-scenario-http-500/index.md |
HTTP 500 실습 |
docs/labs/azure-monitor/sre-agent-scenario-blob-permission/index.md |
Blob 권한 실습 |
docs/labs/azure-monitor/sre-agent-results/index.md |
실습 결과·채점 |
docs/index.md |
문서 사이트 홈 |
docs/guides/development/nodejs-file-io-cpu/index.md |
Node.js I/O 가이드 |
docs/guides/cosmos-db/point-read-optimization/index.md |
Point Read 가이드 |
docs/guides/cosmos-db/nodejs-dns-lookup-bottleneck/index.md |
DNS 병목 가이드 |
docs/guides/cosmos-db/nodejs-client-optimization/index.md |
Cosmos client 가이드 |
docs/guides/azure-storage/mobile-resumable-upload-tus/index.md |
재개 업로드 가이드 |
docs/guides/azure-openai/adaptive-ptu-load-balancing/index.md |
PTU 조정 가이드 |
docs/guides/azure-mysql/nodejs-read-write-routing/index.md |
읽기·쓰기 라우팅 |
docs/guides/azure-mysql/blue-green-upgrade/index.md |
MySQL Blue/Green 가이드 |
docs/guides/azure-monitor/sre-agent-incident-runbook/index.md |
SRE incident runbook |
docs/guides/azure-monitor/sre-agent-dynamic-thresholds/index.md |
Dynamic Threshold 연계 |
docs/guides/azure-load-testing/locust-appgw-aks-private/index.md |
Private 부하 테스트 |
docs/guides/azure-automation/portal-cli-limitations/index.md |
Automation 제약 가이드 |
docs/guides/azure-architecture/response-time-optimization/index.md |
응답 시간 최적화 |
docs/guides/azure-ai-search/korean-analyzer-comparison/index.md |
한국어 분석기 비교 |
docs/guides/azure-ai-search/custom-embedding-ingestion/index.md |
Custom 임베딩 적재 |
docs/guides/azure-ai-foundry/gpt-memory-layer/index.md |
GPT 메모리 설계 |
docs/guides/azure-ai-foundry/foundry-local-air-gapped/index.md |
Foundry Local 에어갭 |
docs/guides/azure-ai-foundry/codex-closed-network/index.md |
Codex 폐쇄망 연동 |
docs/guides/application-gateway/waf-path-ip-allowlist/index.md |
WAF IP 허용 가이드 |
docs/guides/application-gateway/sse-response-buffering/index.md |
SSE 버퍼링 가이드 |
docs/guides/aks/workload-identity-databricks/index.md |
Databricks 키리스 호출 |
docs/guides/aks/spot-h100-kaito/index.md |
Spot H100·KAITO |
docs/guides/aks/remote-cluster-local-development/index.md |
AKS 로컬 개발 루프 |
docs/guides/aks/pod-scheduling-agent-pools/index.md |
Agent pool 스케줄링 |
docs/guides/aks/pod-affinity-distribution/index.md |
Pod 분산 가이드 |
docs/guides/aks/kaito-open-source-model/index.md |
KAITO 모델 서빙 |
docs/guides/aks/cni-overlay-nsg/index.md |
CNI Overlay·NSG |
docs/guides/aks/authorization-troubleshooting/index.md |
권한 오류 진단 |
docs/guides/aks/argocd-image-updater-acr/index.md |
Argo CD·ACR 연동 |
docs/contributing/research-template.md |
리서치 템플릿 |
docs/contributing/lab-template.md |
실습 템플릿 |
docs/contributing/guide-template.md |
가이드 템플릿 |
docs/contributing/case-template.md |
사례 템플릿 |
docs/cases/azure-managed-redis/cluster-failover-recovery/index.md |
Redis failover 사례 |
docs/cases/azure-ai-search/eventual-consistency-reindex/index.md |
재색인 일관성 사례 |
docs/cases/aks/pod-database-query-latency/index.md |
DB 지연 사례 |
docs/cases/aks/netapp-files-cpu-io-wait/index.md |
NetApp I/O 사례 |
docs/cases/aks/file-io-throttling/index.md |
File I/O throttling 사례 |
docs/assets/stylesheets/extra.css |
검증 정보 스타일 |
docs/.nav.yml |
자동 탐색 구조 |
docs-taxonomy.yml |
문서 taxonomy |
CONTRIBUTING.md |
기여 절차 |
AGENTS.md |
저장소 작성 규칙 |
.vscode/mcp.json |
Microsoft Learn MCP |
.gitignore |
생성물·skill 제외 규칙 |
.github/workflows/pages.yml |
Pages 배포 workflow |
.github/workflows/oryx-python-build-test.yml |
Oryx 경로 갱신 |
.github/workflows/docs-ci.yml |
문서 CI |
.github/skills/verify-with-microsoft-learn/SKILL.md |
공식 출처 검증 skill |
.github/skills/verify-with-microsoft-learn/agents/openai.yaml |
Skill UI 메타데이터 |
.github/pull_request_template.md |
문서 PR 체크리스트 |
Review details
Suppressed comments (2)
samples/azure-ai-search/source-material/custom_vectorization/bench/k8s/configmap.yaml:15
- Although the subscription segment was redacted, the resource ID still publishes the original resource group and storage-account identifiers. Replace every environment-specific segment consistently.
samples/azure-ai-search/source-material/custom_vectorization/bench/bench_runner.py:30 - These defaults retain concrete Storage and resource-group identifiers and are used whenever configuration is omitted. Replace them with consistent placeholders or make the variables mandatory.
- Files reviewed: 89/462 changed files
- Comments generated: 7
- Review effort level: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Move Azure and Microsoft content to canonical product slugs, keep project plans outside the published site, and update every affected reference and sample path. Strengthen public-safety validation for compound and extensionless files plus non-example Azure service hostnames.
Move the rendered chart into its page bundle and keep the SRE lab shell hooks executable after the sample-tree migration.
Fail closed on unsafe public text, enforce page bundles, sanitize sample targets, and run the relocated SRE suite in documentation CI. Update migrated lab paths and regression coverage so the published layout remains executable.
Provide the existing fake azd in the login-failure harness so the test reaches its Azure CLI assertion on clean Ubuntu runners.
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
Credential handling, generated-evidence exclusions, metadata validation gaps, and sample correctness issues remain unresolved.
Get a fresh assessment by requesting another Copilot review.
Review details
- Files reviewed: 99/465 changed files
- Comments generated: 4
- Review effort level: Balanced
Reject null verification and lifecycle dates, keep redacted HTML placeholders visible, and align needs-review prose with its provenance status.
Contributor
There was a problem hiding this comment.
🔵 Needs a closer look
Runnable samples contain credential-handling, health-check, deployment-failure, concurrency, portability, and unauthenticated-ingress defects.
Review details
- Files reviewed: 99/465 changed files
- Comments generated: 0 new
- Review effort level: Balanced
![my-reviewer-agent[bot]](https://avatars.githubusercontent.com/in/4343504?s=60&v=4){kind=small}
Address the outstanding content, safety, indexing, Pages, and MCP review findings. Remove one-time migration tooling and brittle prose/configuration tests while retaining the essential documentation contracts.
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
Broken relocated Bicep asset paths, unsafe sample credentials, incomplete CI coverage, and several runtime health and recovery defects must be addressed.
Get a fresh assessment by requesting another Copilot review.
Review details
- Files reviewed: 100/459 changed files
- Comments generated: 1
- Review effort level: Balanced
Generate landing pages and collapsible navigation from document metadata, with compact typography and developer-focused Korean copy. Preserve verification metadata and source references without reader-facing workflow notices. Harden metadata, search and anchor checks, and verify Markdown-only publication end to end. Document the authoring contract and keep executable sample suites outside documentation CI. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
hellices
changed the title
Contributor
There was a problem hiding this comment.
🔵 Needs a closer look
Unignored sensitive artifacts, fixed credentials, undetected deployment failures, and protocol/readiness defects must be resolved before approval.
Review details
- Files reviewed: 100/459 changed files
- Comments generated: 0 new
- Review effort level: Balanced
Validate rendered links using the site's Markdown configuration so reference targets and image alt text are checked without treating code examples as links. Include bare dotenv filenames in the public-safety scan and cover reference syntax, code boundaries, invalid front matter, and safe and unsafe dotenv values with regressions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
8 tasks done
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
변경 내용
cases,guides,labs,researchpage bundle로 정리하고, 실행 코드와 증거 자료를samples/로 분리했습니다.featured메타데이터로 선택하며, 문서 목록을 수동으로 관리하지 않습니다..env인 파일도 공개 안전성 검사에 포함했습니다.작성·유지보수 계약
docs/<collection>/<service>/<topic>/index.md와 유효한 front matter만 추가하면 다음 빌드에 반영됩니다.mkdocs.yml,docs/.nav.yml, README의 문서 목록을 수정하지 않습니다.docs-taxonomy.yml에 공통 분류를 등록합니다.AGENTS.md및 기여 안내에 기록했습니다.samples/의 애플리케이션·인프라 테스트와 의존성은 문서 CI에 묶지 않습니다.verification_status: needs-review는 유지했습니다. 자동 검사는 출처 필드와 구조를 검사하며 제품 설명의 의미 검증을 대신하지 않습니다.검증
python -m pytest tests/docs -q— 75 passed.env/.ENV검사에 대한 회귀 테스트mkdocs build --strict— 깨진 내부 앵커 없음pip check,git diff --check운영 참고
site/, 검색 인덱스, 로컬 가상환경과 별도 작업 폴더는 커밋하지 않습니다.