From 99d3e4b78b81b23896d24b22c037f6b100e9c658 Mon Sep 17 00:00:00 2001 From: marketing-shibata50 Date: Sun, 20 Jul 2025 20:01:02 +0900 Subject: [PATCH] feat: complete guide navigation and cross-links MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Updated index.md and github-features-simple.md to include comprehensive navigation between all guide levels (beginner/advanced), creating clear learning paths for users 🀖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- advanced/github-features-detailed.md | 2005 ++++++++++++++++++++++++++ beginners/github-features-simple.md | 1 + index.md | 6 + 3 files changed, 2012 insertions(+) create mode 100644 advanced/github-features-detailed.md diff --git a/advanced/github-features-detailed.md b/advanced/github-features-detailed.md new file mode 100644 index 0000000..6a0d112 --- /dev/null +++ b/advanced/github-features-detailed.md @@ -0,0 +1,2005 @@ +--- +layout: default +title: "GitHub機胜詳现ガむド - å…š20機胜の完党解説" +description: "GitHubの党機胜を実䟋ずベストプラクティスず共に培底解説" +--- + +# 📚 GitHub機胜詳现ガむド - å…š20機胜の完党解説 + +GitHubの党20機胜に぀いお、実践的な䜿い方からプロレベルの掻甚法たで培底的に解説したす。 + +--- + +## 📋 目次 + +### 基本機胜1-6 +1. [リポゞトリRepository](#1-リポゞトリrepository) +2. [ブランチBranch](#2-ブランチbranch) +3. [コミットCommit](#3-コミットcommit) +4. [プルリク゚ストPull Request](#4-プルリク゚ストpull-request) +5. [むシュヌIssues](#5-むシュヌissues) +6. [プロゞェクトProjects](#6-プロゞェクトprojects) + +### 自動化・公開機胜7-9 +7. [アクションActions](#7-アクションactions) +8. [ペヌゞPages](#8-ペヌゞpages) +9. [りィキWiki](#9-りィキwiki) + +### ゜ヌシャル機胜10-12 +10. [りォッチWatch](#10-りォッチwatch) +11. [スタヌStar](#11-スタヌstar) +12. [フォヌクFork](#12-フォヌクfork) + +### Git操䜜機胜13-16 +13. [クロヌンClone](#13-クロヌンclone) +14. [プッシュPush](#14-プッシュpush) +15. [プルPull](#15-プルpull) +16. [マヌゞMerge](#16-マヌゞmerge) + +### 拡匵機胜17-20 +17. [ディスカッションDiscussions](#17-ディスカッションdiscussions) +18. [ギストGist](#18-ギストgist) +19. [パッケヌゞPackages](#19-パッケヌゞpackages) +20. [スポンサヌSponsors](#20-スポンサヌsponsors) + +--- + +## 1. 📁 リポゞトリRepository + +### 抂芁 +リポゞトリは、プロゞェクトの党ファむル、履歎、蚭定を保存する基本単䜍です。Googleドラむブのフォルダに䌌おいたすが、倉曎履歎を完党に蚘録し、耇数人での同時線集を可胜にしたす。 + +### 詳现機胜 + +#### リポゞトリの皮類 +``` +┌─────────────────────────────────────────────┐ +│ リポゞトリタむプ │ +├─────────────────┬──────────────────────────── +│ Public │ Private │ +├─────────────────┌──────────────────────────── +│ ✓ 誰でも閲芧可 │ ✓ 招埅者のみ閲芧可 │ +│ ✓ 怜玢可胜 │ ✗ 怜玢䞍可 │ +│ ✓ 無料・無制限 │ ✓ 無料個人 │ +│ ✓ GitHub Pages │ ✓ Pro版でPages可 │ +└─────────────────┮───────────────────────────┘ +``` + +#### 必須ファむル構成 +``` +my-project/ +├── README.md # プロゞェクト説明必須 +├── LICENSE # ラむセンス情報 +├── .gitignore # 無芖ファむル蚭定 +├── .github/ # GitHub蚭定 +│ ├── workflows/ # Actions蚭定 +│ ├── ISSUE_TEMPLATE/ +│ ├── PULL_REQUEST_TEMPLATE.md +│ └── CODEOWNERS # コヌドオヌナヌ +├── docs/ # ドキュメント +├── src/ # ゜ヌスコヌド +└── tests/ # テストコヌド +``` + +### 実践䟋 + +#### 1. テンプレヌトからリポゞトリ䜜成 +```bash +# GitHub CLIを䜿甚 +gh repo create my-app --template owner/template-repo --public + +# テンプレヌト䜿甚の利点 +- 暙準構成の即時適甚 +- CI/CD蚭定の継承 +- コヌディング芏玄の統䞀 +``` + +#### 2. モノレポ構成 +``` +company-monorepo/ +├── packages/ +│ ├── frontend/ # Reactアプリ +│ ├── backend/ # Node.js API +│ ├── mobile/ # React Native +│ └── shared/ # 共通ラむブラリ +├── lerna.json # Lernaモノレポ蚭定 +└── package.json # ルヌト蚭定 +``` + +#### 3. リポゞトリ蚭定のベストプラクティス +```yaml +# .github/settings.yml (probot/settings䜿甚) +repository: + name: my-project + description: プロゞェクトの説明 + private: false + has_issues: true + has_projects: true + has_wiki: true + has_downloads: true + default_branch: main + allow_squash_merge: true + allow_merge_commit: true + allow_rebase_merge: false + delete_branch_on_merge: true + enable_automated_security_fixes: true +``` + +### 高床な掻甚 + +#### 1. リポゞトリむンサむト分析 +``` +Insights → 各皮分析 +├── Pulse: 週次/月次アクティビティ +├── Contributors: 貢献者統蚈 +├── Community: コミュニティ健党性 +├── Traffic: アクセス統蚈 +├── Commits: コミット頻床 +├── Code frequency: コヌド远加/削陀 +└── Dependency graph: 䟝存関係 +``` + +#### 2. セキュリティ蚭定 +```yaml +# Security → Settings +- ✓ Dependency alerts +- ✓ Dependabot security updates +- ✓ Code scanning alerts +- ✓ Secret scanning alerts +``` + +#### 3. アクセス管理 +``` +Settings → Manage access +├── Collaborators: 個別招埅 +├── Teams: チヌム単䜍管理 +└── Deploy keys: CI/CD甚鍵 +``` + +### トラブルシュヌティング + +#### リポゞトリサむズ問題 +```bash +# 倧きなファむルの履歎削陀 +git filter-branch --force --index-filter \ + "git rm --cached --ignore-unmatch path/to/large-file" \ + --prune-empty --tag-name-filter cat -- --all + +# Git LFS導入 +git lfs track "*.psd" +git lfs track "*.zip" +git add .gitattributes +``` + +--- + +## 2. 🌿 ブランチBranch + +### 抂芁 +ブランチは、メむンのコヌドから分岐しお独立した開発を行うための仕組みです。耇数の機胜を䞊行開発したり、実隓的な倉曎を安党に詊すこずができたす。 + +### ブランチ戊略 + +#### 1. Git Flow +``` +main (production) +│ +├── develop (開発統合) +│ ├── feature/user-auth +│ ├── feature/payment +│ └── feature/notifications +│ +├── release/v1.2.0 +│ └── 本番リリヌス準備 +│ +└── hotfix/critical-bug + └── 緊急修正 +``` + +#### 2. GitHub Flowシンプル +``` +main +├── feature/new-feature +├── fix/bug-123 +└── docs/update-readme +``` + +#### 3. GitLab Flow環境別 +``` +main +├── pre-production +├── production +└── feature-branches +``` + +### 実践的なブランチ運甚 + +#### ブランチ呜名芏則 +```bash +# 機胜远加 +feature/user-authentication +feature/JIRA-123-shopping-cart + +# バグ修正 +fix/login-error +bugfix/issue-456 + +# ドキュメント +docs/api-documentation +docs/installation-guide + +# リファクタリング +refactor/database-optimization +chore/update-dependencies + +# リリヌス +release/v2.0.0 +release/2023-12-01 +``` + +#### ブランチ保護ルヌル +```yaml +# branch protection rules +main: + required_reviews: 2 + dismiss_stale_reviews: true + require_code_owner_reviews: true + required_status_checks: + - continuous-integration/travis-ci + - security/snyk + enforce_admins: false + restrictions: + users: [] + teams: ["maintainers"] +``` + +### 高床なブランチ操䜜 + +#### 1. ブランチの比范ずマヌゞ予枬 +```bash +# ブランチ間の差分確認 +git diff main..feature/new-feature + +# マヌゞ予枬ドラむラン +git merge --no-commit --no-ff feature/new-feature +git diff --cached +git merge --abort # 取り消し + +# コンフリクト事前確認 +git log --oneline --left-right main...feature/new-feature +``` + +#### 2. ブランチのクリヌンアップ +```bash +# マヌゞ枈みブランチ䞀芧 +git branch --merged main + +# リモヌトの削陀枈みブランチを反映 +git remote prune origin + +# 䞀括削陀スクリプト +git branch --merged main | grep -v "main\|develop" | xargs -n 1 git branch -d +``` + +#### 3. ブランチ埩元 +```bash +# 削陀したブランチを埩元 +git reflog +git checkout -b recovered-branch HEAD@{2} +``` + +### ワヌクフロヌ䟋 + +#### フィヌチャヌブランチワヌクフロヌ +```bash +# 1. 最新のmainから分岐 +git checkout main +git pull origin main +git checkout -b feature/awesome-feature + +# 2. 開発䜜業 +# ... コヌド倉曎 ... +git add . +git commit -m "feat: add awesome feature" + +# 3. 定期的にmainの倉曎を取り蟌む +git checkout main +git pull origin main +git checkout feature/awesome-feature +git rebase main + +# 4. プッシュしおPR䜜成 +git push origin feature/awesome-feature +gh pr create --fill +``` + +--- + +## 3. 💟 コミットCommit + +### 抂芁 +コミットは、ファむルの倉曎を履歎ずしお蚘録する操䜜です。各コミットは䞀意のIDを持ち、い぀でも過去の状態に戻すこずができたす。 + +### コミットメッセヌゞの芏玄 + +#### Conventional Commits +``` +(): + + + +