New translation batch for ja (#29410)
* Add crowdin translations * Run script/i18n/homogenize-frontmatter.js * Run script/i18n/lint-translation-files.js --check rendering * run script/i18n/reset-files-with-broken-liquid-tags.js --language=ja * run script/i18n/reset-known-broken-translation-files.js * Check in ja CSV report Co-authored-by: Robert Sese <734194+rsese@users.noreply.github.com>
This commit is contained in:
docubot
@@ -51,6 +51,8 @@ To get started quickly, you can choose the preconfigured Gradle starter workflow
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Java CI
|
||||
|
||||
on: [push]
|
||||
|
||||
@@ -380,6 +380,8 @@ For this example, you will need to create two [PyPI API tokens](https://pypi.org
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Upload Python Package
|
||||
|
||||
on:
|
||||
|
||||
@@ -38,6 +38,8 @@ To get started quickly, add the starter workflow to the `.github/workflows` dire
|
||||
```yaml
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Ruby
|
||||
|
||||
on:
|
||||
@@ -85,7 +87,7 @@ steps:
|
||||
|
||||
## 複数のバージョンの Ruby でのテスト
|
||||
|
||||
複数バージョンのRubyでワークフローを実行するように、マトリクス戦略を追加できます。 For example, you can test your code against the latest patch releases of versions 3.1, 3.0, and 2.7.
|
||||
複数バージョンのRubyでワークフローを実行するように、マトリクス戦略を追加できます。 たとえば、バージョン3.1、3.0、2.7の最新のパッチリリースでコードをテストできます。
|
||||
|
||||
{% raw %}
|
||||
```yaml
|
||||
@@ -102,6 +104,8 @@ strategy:
|
||||
```yaml
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Ruby CI
|
||||
|
||||
on:
|
||||
@@ -206,6 +210,8 @@ steps:
|
||||
```yaml
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Matrix Testing
|
||||
|
||||
on:
|
||||
@@ -239,6 +245,8 @@ jobs:
|
||||
```yaml
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Linting
|
||||
|
||||
on: [push]
|
||||
@@ -265,6 +273,8 @@ CIテストにパスしたなら、Rubyパッケージを任意のパッケー
|
||||
```yaml
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Ruby Gem
|
||||
|
||||
on:
|
||||
|
||||
@@ -68,8 +68,12 @@ jobs:
|
||||
You can configure your job to use multiple versions of Swift in a matrix.
|
||||
|
||||
```yaml{:copy}
|
||||
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
|
||||
name: Swift
|
||||
|
||||
on: [push]
|
||||
|
||||
@@ -92,6 +92,8 @@ Once you've completed the prerequisites, you can proceed with creating the workf
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Deploy to Amazon ECS
|
||||
|
||||
on:
|
||||
|
||||
@@ -81,6 +81,8 @@ The following example workflow demonstrates how to build and deploy a Docker con
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Build and deploy a container to an Azure Web App
|
||||
|
||||
env:
|
||||
|
||||
@@ -67,6 +67,8 @@ The following example workflow demonstrates how to build and deploy a Java proje
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Build and deploy JAR app to Azure Web App
|
||||
|
||||
env:
|
||||
|
||||
@@ -66,6 +66,8 @@ The following example workflow demonstrates how to build and deploy a .NET proje
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Build and deploy ASP.Net Core app to an Azure Web App
|
||||
|
||||
env:
|
||||
|
||||
@@ -72,6 +72,8 @@ The following example workflow demonstrates how to build, test, and deploy the N
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
|
||||
@@ -66,6 +66,8 @@ The following example workflow demonstrates how to build and deploy a PHP projec
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Build and deploy PHP app to Azure Web App
|
||||
|
||||
env:
|
||||
|
||||
@@ -69,6 +69,8 @@ The following example workflow demonstrates how to build and deploy a Python pro
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Build and deploy Python app to Azure Web App
|
||||
|
||||
env:
|
||||
|
||||
@@ -55,6 +55,8 @@ This workflow uses the `helm` render engine for the [`azure/k8s-bake` action](ht
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Build and deploy to Azure Kubernetes Service
|
||||
|
||||
env:
|
||||
|
||||
@@ -54,6 +54,8 @@ For more information about these values, see "[Build configuration for Azure Sta
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Deploy web app to Azure Static Web Apps
|
||||
|
||||
env:
|
||||
|
||||
@@ -137,6 +137,8 @@ Under the `env` key, change the value of `GKE_CLUSTER` to the name of your clust
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Build and Deploy to GKE
|
||||
|
||||
on:
|
||||
|
||||
@@ -172,25 +172,27 @@ jobs:
|
||||
{% data reusables.actions.github-context-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
| プロパティ名 | 種類 | 説明 |
|
||||
| -------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `github` | `オブジェクト` | ワークフローのあらゆるジョブやステップにおいて使用できる最上位のコンテキスト。 This object contains all the properties listed below. |
|
||||
| `github.action` | `string` | The name of the action currently running, or the [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) of a step. {% data variables.product.prodname_dotcom %} removes special characters, and uses the name `__run` when the current step runs a script without an `id`. If you use the same action more than once in the same job, the name will include a suffix with the sequence number with underscore before it. For example, the first script you run will have the name `__run`, and the second script will be named `__run_2`. 同様に、`actions/checkout`の2回目の呼び出しは`actionscheckout2`となります。 |
|
||||
| `github.action_path` | `string` | The path where an action is located. This property is only supported in composite actions. You can use this path to access files located in the same repository as the action. |
|
||||
| `github.action_ref` | `string` | For a step executing an action, this is the ref of the action being executed. For example, `v2`. |
|
||||
| `github.action_repository` | `string` | For a step executing an action, this is the owner and repository name of the action. For example, `actions/checkout`. |
|
||||
| `github.action_status` | `string` | For a composite action, the current result of the composite action. |
|
||||
| `github.actor` | `string` | The username of the user that initiated the workflow run. |
|
||||
| `github.api_url` | `string` | The URL of the {% data variables.product.prodname_dotcom %} REST API. |
|
||||
| `github.base_ref` | `string` | ワークフローの実行における `base_ref` またはPull Requestのターゲットブランチ。 このプロパティは、ワークフローの実行をトリガーするイベントが `pull_request` または `pull_request_target` のいずれかである場合にのみ使用できます。 |
|
||||
| `github.env` | `string` | Path on the runner to the file that sets environment variables from workflow commands. This file is unique to the current step and is a different file for each step in a job. 詳しい情報については「[{% data variables.product.prodname_actions %}のワークフローコマンド](/actions/learn-github-actions/workflow-commands-for-github-actions#setting-an-environment-variable)」を参照してください。 |
|
||||
| `github.event` | `オブジェクト` | webhook ペイロードの完全なイベント。 このコンテキストを使用して、イベントの個々のプロパティにアクセスできます。 This object is identical to the webhook payload of the event that triggered the workflow run, and is different for each event. The webhooks for each {% data variables.product.prodname_actions %} event is linked in "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." For example, for a workflow run triggered by the [`push` event](/actions/using-workflows/events-that-trigger-workflows#push), this object contains the contents of the [push webhook payload](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push). |
|
||||
| `github.event_name` | `string` | ワークフローの実行をトリガーしたイベントの名前。 |
|
||||
| `github.event_path` | `string` | The path to the file on the runner that contains the full event webhook payload. |
|
||||
| `github.graphql_url` | `string` | The URL of the {% data variables.product.prodname_dotcom %} GraphQL API. |
|
||||
| `github.head_ref` | `string` | ワークフローの実行における `head_ref` またはPull Requestのソースブランチ。 このプロパティは、ワークフローの実行をトリガーするイベントが `pull_request` または `pull_request_target` のいずれかである場合にのみ使用できます。 |
|
||||
| `github.job` | `string` | 現在のジョブの[`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id)。 <br /> Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |
|
||||
| `github.ref` | `string` | {% data reusables.actions.ref-description %}
|
||||
| プロパティ名 | 種類 | 説明 |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `github` | `オブジェクト` | ワークフローのあらゆるジョブやステップにおいて使用できる最上位のコンテキスト。 This object contains all the properties listed below. |
|
||||
| `github.action` | `string` | The name of the action currently running, or the [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) of a step. {% data variables.product.prodname_dotcom %} removes special characters, and uses the name `__run` when the current step runs a script without an `id`. If you use the same action more than once in the same job, the name will include a suffix with the sequence number with underscore before it. For example, the first script you run will have the name `__run`, and the second script will be named `__run_2`. 同様に、`actions/checkout`の2回目の呼び出しは`actionscheckout2`となります。 |
|
||||
| `github.action_path` | `string` | The path where an action is located. This property is only supported in composite actions. You can use this path to access files located in the same repository as the action. |
|
||||
| `github.action_ref` | `string` | For a step executing an action, this is the ref of the action being executed. For example, `v2`. |
|
||||
| `github.action_repository` | `string` | For a step executing an action, this is the owner and repository name of the action. For example, `actions/checkout`. |
|
||||
| `github.action_status` | `string` | For a composite action, the current result of the composite action. |
|
||||
| `github.actor` | `string` | |
|
||||
| {% ifversion actions-stable-actor-ids %}The username of the user that triggered the initial workflow run. If the workflow run is a re-run, this value may differ from `github.triggering_actor`. Any workflow re-runs will use the privileges of `github.actor`, even if the actor initiating the re-run (`github.triggering_actor`) has different privileges.{% else %}The username of the user that initiated the workflow run.{% endif %} | | |
|
||||
| | | |
|
||||
| `github.api_url` | `string` | The URL of the {% data variables.product.prodname_dotcom %} REST API. |
|
||||
| `github.base_ref` | `string` | ワークフローの実行における `base_ref` またはプルリクエストのターゲットブランチ。 このプロパティは、ワークフローの実行をトリガーするイベントが `pull_request` または `pull_request_target` のいずれかである場合にのみ使用できます。 |
|
||||
| `github.env` | `string` | Path on the runner to the file that sets environment variables from workflow commands. This file is unique to the current step and is a different file for each step in a job. For more information, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#setting-an-environment-variable)." |
|
||||
| `github.event` | `オブジェクト` | webhook ペイロードの完全なイベント。 このコンテキストを使用して、イベントの個々のプロパティにアクセスできます。 This object is identical to the webhook payload of the event that triggered the workflow run, and is different for each event. The webhooks for each {% data variables.product.prodname_actions %} event is linked in "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." For example, for a workflow run triggered by the [`push` event](/actions/using-workflows/events-that-trigger-workflows#push), this object contains the contents of the [push webhook payload](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push). |
|
||||
| `github.event_name` | `string` | ワークフローの実行をトリガーしたイベントの名前。 |
|
||||
| `github.event_path` | `string` | The path to the file on the runner that contains the full event webhook payload. |
|
||||
| `github.graphql_url` | `string` | The URL of the {% data variables.product.prodname_dotcom %} GraphQL API. |
|
||||
| `github.head_ref` | `string` | ワークフローの実行における `head_ref` またはPull Requestのソースブランチ。 このプロパティは、ワークフローの実行をトリガーするイベントが `pull_request` または `pull_request_target` のいずれかである場合にのみ使用できます。 |
|
||||
| `github.job` | `string` | 現在のジョブの[`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id)。 <br /> Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |
|
||||
| `github.ref` | `string` | {% data reusables.actions.ref-description %}
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5338 %}
|
||||
| `github.ref_name` | `string` | {% data reusables.actions.ref_name-description %} | | `github.ref_protected` | `string` | {% data reusables.actions.ref_protected-description %} | | `github.ref_type` | `string` | {% data reusables.actions.ref_type-description %}
|
||||
{%- endif %}
|
||||
@@ -198,7 +200,7 @@ jobs:
|
||||
{%- ifversion fpt or ghec or ghes > 3.5 or ghae-issue-4722 %}
|
||||
| `github.run_attempt` | `string` | A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run. |
|
||||
{%- endif %}
|
||||
| `github.server_url` | `string` | The URL of the GitHub server. たとえば、`https://github.com` などです。 | | `github.sha` | `string` | The commit SHA that triggered the workflow run. | | `github.token` | `string` | A token to authenticate on behalf of the GitHub App installed on your repository. これは機能的に`GITHUB_TOKEN`シークレットに等価です。 詳しい情報については「[自動トークン認証](/actions/security-guides/automatic-token-authentication)」を参照してください。 <br /> Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. | | `github.workflow` | `string` | The name of the workflow. ワークフローファイルで `name` を指定していない場合、このプロパティの値は、リポジトリ内にあるワークフローファイルのフルパスになります。 | | `github.workspace` | `string` | The default working directory on the runner for steps, and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. |
|
||||
| `github.server_url` | `string` | The URL of the GitHub server. たとえば、`https://github.com` などです。 | | `github.sha` | `string` | The commit SHA that triggered the workflow run. | | `github.token` | `string` | A token to authenticate on behalf of the GitHub App installed on your repository. これは機能的に`GITHUB_TOKEN`シークレットに等価です。 詳しい情報については「[自動トークン認証](/actions/security-guides/automatic-token-authentication)」を参照してください。 <br /> Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |{% ifversion actions-stable-actor-ids %} | `github.triggering_actor` | `string` | The username of the user that initiated the workflow run. If the workflow run is a re-run, this value may differ from `github.actor`. Any workflow re-runs will use the privileges of `github.actor`, even if the actor initiating the re-run (`github.triggering_actor`) has different privileges. |{% endif %} | `github.workflow` | `string` | The name of the workflow. ワークフローファイルで `name` を指定していない場合、このプロパティの値は、リポジトリ内にあるワークフローファイルのフルパスになります。 | | `github.workspace` | `string` | The default working directory on the runner for steps, and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. |
|
||||
|
||||
### Example contents of the `github` context
|
||||
|
||||
|
||||
@@ -32,6 +32,8 @@ topics:
|
||||
```yaml{:copy}
|
||||
{% indented_data_reference reusables.actions.actions-not-certified-by-github-comment spaces=4 %}
|
||||
|
||||
{% indented_data_reference reusables.actions.actions-use-sha-pinning-comment spaces=4 %}
|
||||
|
||||
name: Label issues
|
||||
on:
|
||||
issues:
|
||||
|
||||
@@ -33,6 +33,8 @@ shortTitle: Add label to comment on issue
|
||||
```yaml{:copy}
|
||||
{% indented_data_reference reusables.actions.actions-not-certified-by-github-comment spaces=4 %}
|
||||
|
||||
{% indented_data_reference reusables.actions.actions-use-sha-pinning-comment spaces=4 %}
|
||||
|
||||
name: Add comment
|
||||
on:
|
||||
issues:
|
||||
|
||||
@@ -34,6 +34,8 @@ shortTitle: Move assigned issues
|
||||
```yaml{:copy}
|
||||
{% indented_data_reference reusables.actions.actions-not-certified-by-github-comment spaces=4 %}
|
||||
|
||||
{% indented_data_reference reusables.actions.actions-use-sha-pinning-comment spaces=4 %}
|
||||
|
||||
name: Move assigned card
|
||||
on:
|
||||
issues:
|
||||
|
||||
@@ -30,10 +30,11 @@ shortTitle: Remove label when adding card
|
||||
2. リポジトリに属するプロジェクトを選択します。 このワークフローは、ユーザまたは Organization に属するプロジェクトでは使用できません。 既存のプロジェクトを使用することも、新しいプロジェクトを作成することもできます。 プロジェクトの作成の詳細については、「[プロジェクトボードを作成する](/github/managing-your-work-on-github/creating-a-project-board)」を参照してください。
|
||||
3. {% data reusables.actions.make-workflow-file %}
|
||||
4. 次の YAML コンテンツをワークフローファイルにコピーします。
|
||||
|
||||
```yaml{:copy}
|
||||
{% indented_data_reference reusables.actions.actions-not-certified-by-github-comment spaces=4 %}
|
||||
|
||||
{% indented_data_reference reusables.actions.actions-use-sha-pinning-comment spaces=4 %}
|
||||
|
||||
name: Remove labels
|
||||
on:
|
||||
project_card:
|
||||
|
||||
@@ -32,6 +32,8 @@ topics:
|
||||
```yaml{:copy}
|
||||
{% indented_data_reference reusables.actions.actions-not-certified-by-github-comment spaces=4 %}
|
||||
|
||||
{% indented_data_reference reusables.actions.actions-use-sha-pinning-comment spaces=4 %}
|
||||
|
||||
name: Weekly Team Sync
|
||||
on:
|
||||
schedule:
|
||||
|
||||
@@ -17,7 +17,7 @@ versions:
|
||||
|
||||
## About re-running workflows and jobs
|
||||
|
||||
Re-running a workflow{% ifversion re-run-jobs %} or jobs in a workflow{% endif %} uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. You can re-run a workflow{% ifversion re-run-jobs %} or jobs in a workflow{% endif %} for up to 30 days after the initial run.{% ifversion re-run-jobs %} You cannot re-run jobs in a workflow once its logs have passed their retention limits. For more information, see "[Usage limits, billing, and administration](/actions/learn-github-actions/usage-limits-billing-and-administration#artifact-and-log-retention-policy)."{% endif %}{% ifversion debug-reruns %} When you re-run a workflow or jobs in a workflow, you can enable debug logging for the re-run. This will enable runner diagnostic logging and step debug logging for the re-run. For more information about debug logging, see "[Enabling debug logging](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging)."{% endif %}
|
||||
Re-running a workflow{% ifversion re-run-jobs %} or jobs in a workflow{% endif %} uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. {% ifversion actions-stable-actor-ids %}The workflow will use the privileges of the actor who initially triggered the workflow, not the privileges of the actor who initiated the re-run. {% endif %}You can re-run a workflow{% ifversion re-run-jobs %} or jobs in a workflow{% endif %} for up to 30 days after the initial run.{% ifversion re-run-jobs %} You cannot re-run jobs in a workflow once its logs have passed their retention limits. For more information, see "[Usage limits, billing, and administration](/actions/learn-github-actions/usage-limits-billing-and-administration#artifact-and-log-retention-policy)."{% endif %}{% ifversion debug-reruns %} When you re-run a workflow or jobs in a workflow, you can enable debug logging for the re-run. This will enable runner diagnostic logging and step debug logging for the re-run. For more information about debug logging, see "[Enabling debug logging](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging)."{% endif %}
|
||||
|
||||
## Re-running all the jobs in a workflow
|
||||
|
||||
|
||||
@@ -410,6 +410,8 @@ workflows:
|
||||
```yaml
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Containers
|
||||
|
||||
on: [push]
|
||||
|
||||
@@ -69,6 +69,8 @@ Docker Hubに必要な`build-push-action`のオプションは以下のとおり
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Publish Docker image
|
||||
|
||||
on:
|
||||
@@ -142,9 +144,12 @@ The `build-push-action` options required for {% data variables.product.prodname_
|
||||
The above workflow is triggered by a push to the "release" branch. It checks out the GitHub repository, and uses the `login-action` to log in to the {% data variables.product.prodname_container_registry %}. It then extracts labels and tags for the Docker image. Finally, it uses the `build-push-action` action to build the image and publish it on the {% data variables.product.prodname_container_registry %}.
|
||||
|
||||
{% else %}
|
||||
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Publish Docker image
|
||||
|
||||
on:
|
||||
@@ -194,6 +199,8 @@ The above workflow checks out the {% data variables.product.product_name %} repo
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Publish Docker image
|
||||
|
||||
on:
|
||||
|
||||
@@ -77,8 +77,11 @@ publishing {
|
||||
この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryに公開するワークフローを作成できます。 デプロイのステップでは、ユーザ名とパスワードのための環境変数か、Mavenリポジトリの認証に使うトークンを環境変数に設定する必要があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
|
||||
|
||||
```yaml{:copy}
|
||||
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Publish package to the Maven Central Repository
|
||||
on:
|
||||
release:
|
||||
@@ -146,8 +149,11 @@ publishing {
|
||||
With this configuration, you can create a workflow that publishes your package to {% data variables.product.prodname_registry %} by running the `gradle publish` command.
|
||||
|
||||
```yaml{:copy}
|
||||
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Publish package to GitHub Packages
|
||||
on:
|
||||
release:
|
||||
@@ -224,8 +230,11 @@ publishing {
|
||||
この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryと{% data variables.product.prodname_registry %}の両方に公開するワークフローを作成できます。
|
||||
|
||||
```yaml{:copy}
|
||||
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Publish package to the Maven Central Repository and GitHub Packages
|
||||
on:
|
||||
release:
|
||||
|
||||
@@ -447,7 +447,7 @@ on:
|
||||
{% ifversion fpt or ghec %}
|
||||
{% note %}
|
||||
|
||||
**Note**: This event does not occur for projects (beta). 詳しい情報については「[プロジェクト（ベータ）](/issues/trying-out-the-new-projects-experience/about-projects)について」を参照してください。
|
||||
**Note**: This event only occurs for {% data variables.product.prodname_projects_v1 %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
@@ -485,7 +485,7 @@ on:
|
||||
{% ifversion fpt or ghec %}
|
||||
{% note %}
|
||||
|
||||
**Note**: This event does not occur for projects (beta). 詳しい情報については「[プロジェクト（ベータ）](/issues/trying-out-the-new-projects-experience/about-projects)について」を参照してください。
|
||||
**Note**: This event only occurs for {% data variables.product.prodname_projects_v1 %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
@@ -523,7 +523,7 @@ on:
|
||||
{% ifversion fpt or ghec %}
|
||||
{% note %}
|
||||
|
||||
**Note**: This event does not occur for projects (beta). 詳しい情報については「[プロジェクト（ベータ）](/issues/trying-out-the-new-projects-experience/about-projects)について」を参照してください。
|
||||
**Note**: This event only occurs for {% data variables.product.prodname_projects_v1 %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
@@ -31,16 +31,12 @@ shortTitle: Configure DNS servers
|
||||
|
||||
{% data reusables.enterprise_installation.ssh-into-instance %}
|
||||
|
||||
2. ネームサーバーを編集するには、次を入力します:
|
||||
2. To edit your nameservers, use the `ghe-setup-network` command in visual mode. 詳しい情報については、「[コマンドラインユーティリティ](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-setup-network)」を参照してください。
|
||||
|
||||
```shell
|
||||
sudo vim /etc/resolvconf/resolv.conf.d/head
|
||||
ghe-setup-network -v
|
||||
```
|
||||
|
||||
{% data reusables.enterprise_installation.preventing-nameservers-change %}
|
||||
|
||||
3. `nameserver` エントリを追加し、続いてファイルを保存します。
|
||||
4. 変更を確認したら、ファイルを保存します。
|
||||
5. To add your new nameserver entries to {% data variables.product.product_location %}, run the following:
|
||||
|
||||
```shell
|
||||
|
||||
@@ -344,6 +344,18 @@ With `ghe-set-password`, you can set a new password to authenticate into the [{%
|
||||
ghe-set-password <新しいパスワード>
|
||||
```
|
||||
|
||||
### ghe-setup-network
|
||||
|
||||
This utility allows you to configure the primary network interface.
|
||||
|
||||
To enter visual mode, which will guide you through configuration of network settings:
|
||||
|
||||
```shell
|
||||
$ ghe-setup-network -v
|
||||
```
|
||||
|
||||
追加オプションを確認するには -h フラグを使用してください。
|
||||
|
||||
### ghe-ssh-check-host-keys
|
||||
|
||||
このユーティリティは、既存の SSH のホストキーを漏洩した SSH ホストキーと比べます。
|
||||
@@ -654,9 +666,9 @@ ghe-repo <em>ユーザ名</em>/<em>reponame</em>
|
||||
|
||||
### ghe-repo-gc
|
||||
|
||||
このユーティリティは、パックの容量を最適化するために、手動的にリポジトリのネットワークをリパックします。 大きなリポジトリの場合、このコマンドを実行するとリポジトリの全体的なサイズを減らすことができます。 リポジトリのネットワークとの対話を通じて、{% data variables.product.prodname_enterprise %} がこのコマンドを自動的に実行します。
|
||||
このユーティリティは、パックの容量を最適化するために、手動的にリポジトリのネットワークをリパックします。 大きなリポジトリの場合、このコマンドではリポジトリの全体的なサイズを減らすことができます。 リポジトリのネットワークとの対話を通じて、{% data variables.product.prodname_enterprise %} がこのコマンドを自動的に実行します。
|
||||
|
||||
任意の`--prune` の引数を付けて、ブランチやタグ、refに参照されていない、届かないGitオブジェクトを除くことができます。 これは、[以前抹消した機密情報](/enterprise/user/articles/remove-sensitive-data/) を直ちに削除するために役立ちます。
|
||||
任意の`--prune` の引数を付けて、ブランチやタグ、refに参照されていない、届かないGitオブジェクトを除くことができます。 これは、[以前抹消した機密情報](/enterprise/user/articles/remove-sensitive-data/) を直ちに削除するのに役立ちます。
|
||||
|
||||
{% warning %}
|
||||
|
||||
|
||||
@@ -119,6 +119,7 @@ includeGuides:
|
||||
- /admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/about-the-audit-log-for-your-enterprise
|
||||
- /admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise
|
||||
- /admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise
|
||||
- /admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/configuring-the-audit-log-for-your-enterprise
|
||||
- /admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/exporting-audit-log-activity-for-your-enterprise
|
||||
- /admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise
|
||||
- /admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise
|
||||
|
||||
@@ -35,7 +35,8 @@ In addition to viewing your audit log, you can monitor activity in your enterpri
|
||||
|
||||
As an enterprise owner{% ifversion ghes %} or site administrator{% endif %}, you can interact with the audit log data for your enterprise in several ways:
|
||||
- You can view the audit log for your enterprise. For more information, see "[Accessing the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise)."
|
||||
- You can search the audit log for specific events{% ifversion ghec %} and export audit log data{% endif %}. For more information, see "[Searching the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise)"{% ifversion ghec %} and "[Exporting the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/exporting-audit-log-activity-for-your-enterprise)"{% endif %}.
|
||||
- You can search the audit log for specific events{% ifversion ghec %} and export audit log data{% endif %}. For more information, see "[Searching the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise)"{% ifversion ghec %} and "[Exporting the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/exporting-audit-log-activity-for-your-enterprise)"{% endif %}.{% ifversion audit-data-retention-tab %}
|
||||
- You can configure settings, such as the retention period for audit log events{% ifversion enable-git-events %} and whether Git events are included{% endif %}. For more information, see "[Configuring the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/configuring-the-audit-log-for-your-enterprise)."{% endif %}
|
||||
{%- ifversion enterprise-audit-log-ip-addresses %}
|
||||
- You can display the IP address associated with events in the audit log. For more information, see "[Displaying IP addresses in the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/displaying-ip-addresses-in-the-audit-log-for-your-enterprise)."
|
||||
{%- endif %}
|
||||
|
||||
@@ -377,9 +377,15 @@ The scope of the events that appear in your enterprise's audit log depend on whe
|
||||
| `gist.destroy` | A gist is deleted. |
|
||||
| `gist.visibility_change` | The visibility of a gist is changed. |
|
||||
|
||||
{% ifversion ghec or ghes > 3.4 or ghae-issue-6724 %}
|
||||
{% ifversion git-events-audit-log %}
|
||||
## `git` カテゴリアクション
|
||||
|
||||
{% ifversion enable-git-events %}
|
||||
Before you'll see `git` category actions, you must enable Git events in the audit log. For more information, see "[Configuring the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/configuring-the-audit-log-for-your-enterprise#managing-git-events-in-the-audit-log)."
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.audit_log.git-events-not-in-search-results %}
|
||||
|
||||
| アクション | 説明 |
|
||||
| ----------- | --------------------------------------- |
|
||||
| `git.clone` | A repository was cloned. |
|
||||
@@ -818,20 +824,20 @@ The scope of the events that appear in your enterprise's audit log depend on whe
|
||||
| `project.update_team_permission` | A team's project board permission level was changed or when a team was added or removed from a project board. For more information, see "[Managing team access to an organization project board](/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board)." |
|
||||
| `project.update_user_permission` | An organization member or outside collaborator was added to or removed from a project board or had their permission level changed. For more information, see "[Managing an individual’s access to an organization project board](/organizations/managing-access-to-your-organizations-project-boards/managing-an-individuals-access-to-an-organization-project-board)." |
|
||||
|
||||
{%- ifversion fpt or ghec %}
|
||||
{%- ifversion projects-v2 %}
|
||||
## `project_field` category actions
|
||||
|
||||
| アクション | 説明 |
|
||||
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `project_field.create` | A field was created in a project board. For more information, see "[Creating a project (beta)](/issues/trying-out-the-new-projects-experience/creating-a-project#adding-fields)." |
|
||||
| `project_field.delete` | A field was deleted in a project board. For more information, see "[Creating a project (beta)](/issues/trying-out-the-new-projects-experience/creating-a-project#adding-fields)." |
|
||||
| アクション | 説明 |
|
||||
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `project_field.create` | A field was created in a project board. For more information, see "[Understanding field types](/issues/planning-and-tracking-with-projects/understanding-field-types)." |
|
||||
| `project_field.delete` | A field was deleted in a project board. For more information, see "[Deleting fields](/issues/planning-and-tracking-with-projects/understanding-field-types/deleting-fields)." |
|
||||
|
||||
## `project_view` category actions
|
||||
|
||||
| アクション | 説明 |
|
||||
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `project_view.create` | A view was created in a project board. For more information, see "[Customizing your project (beta) views](/issues/trying-out-the-new-projects-experience/customizing-your-project-views#creating-a-project-view)." |
|
||||
| `project_view.delete` | A view was deleted in a project board. For more information, see "[Customizing your project (beta) views](/issues/trying-out-the-new-projects-experience/customizing-your-project-views#deleting-a-saved-view)." |
|
||||
| アクション | 説明 |
|
||||
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `project_view.create` | A view was created in a project board. For more information, see "[Managing your views](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views)." |
|
||||
| `project_view.delete` | A view was deleted in a project board. For more information, see "[Managing your views](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views)." |
|
||||
{%- endif %}
|
||||
|
||||
## `protected_branch` カテゴリアクション
|
||||
@@ -898,28 +904,28 @@ The scope of the events that appear in your enterprise's audit log depend on whe
|
||||
|
||||
## `repo` カテゴリアクション
|
||||
|
||||
| アクション | 説明 |
|
||||
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `repo.access` | リポジトリの可視性がプライベート{%- ifversion ghes %}、パブリック、{% endif %} または内部に変更されました。 |
|
||||
| `repo.actions_enabled` | {% data variables.product.prodname_actions %} was enabled for a repository. |
|
||||
| `repo.add_member` | リポジトリにコラボレーターが追加されました。 |
|
||||
| `repo.add_topic` | A topic was added to a repository. |
|
||||
| `repo.advanced_security_disabled` | {% data variables.product.prodname_GH_advanced_security %} was disabled for a repository. |
|
||||
| `repo.advanced_security_enabled` | {% data variables.product.prodname_GH_advanced_security %} was enabled for a repository. |
|
||||
| `repo.advanced_security_policy_selected_member_disabled` | A repository administrator prevented {% data variables.product.prodname_GH_advanced_security %} features from being enabled for a repository. |
|
||||
| `repo.advanced_security_policy_selected_member_enabled` | A repository administrator allowed {% data variables.product.prodname_GH_advanced_security %} features to be enabled for a repository. |
|
||||
| `repo.archived` | リポジトリがアーカイブされました。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} のリポジトリをアーカイブする](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)」を参照してください。 |
|
||||
| `repo.code_scanning_analysis_deleted` | Code scanning analysis for a repository was deleted. For more information, see "[Delete a code scanning analysis from a repository](/rest/reference/code-scanning#delete-a-code-scanning-analysis-from-a-repository)." |
|
||||
| `repo.change_merge_setting` | Pull request merge options were changed for a repository. |
|
||||
| `repo.clear_actions_settings` | A repository administrator cleared {% data variables.product.prodname_actions %} policy settings for a repository. |
|
||||
| `repo.config` | A repository administrator blocked force pushes. 詳しくは、 [リポジトリへのフォースプッシュのブロック](/enterprise/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)を参照してください。 |
|
||||
| アクション | 説明 |
|
||||
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `repo.access` | The visibility of a repository changed to private{%- ifversion ghes %}, public,{% endif %} or internal. |
|
||||
| `repo.actions_enabled` | {% data variables.product.prodname_actions %} was enabled for a repository. |
|
||||
| `repo.add_member` | リポジトリにコラボレーターが追加されました。 |
|
||||
| `repo.add_topic` | A topic was added to a repository. |
|
||||
| `repo.advanced_security_disabled` | {% data variables.product.prodname_GH_advanced_security %} was disabled for a repository. |
|
||||
| `repo.advanced_security_enabled` | {% data variables.product.prodname_GH_advanced_security %} was enabled for a repository. |
|
||||
| `repo.advanced_security_policy_selected_member_disabled` | A repository administrator prevented {% data variables.product.prodname_GH_advanced_security %} features from being enabled for a repository. |
|
||||
| `repo.advanced_security_policy_selected_member_enabled` | A repository administrator allowed {% data variables.product.prodname_GH_advanced_security %} features to be enabled for a repository. |
|
||||
| `repo.archived` | リポジトリがアーカイブされました。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} のリポジトリをアーカイブする](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)」を参照してください。 |
|
||||
| `repo.code_scanning_analysis_deleted` | Code scanning analysis for a repository was deleted. For more information, see "[Delete a code scanning analysis from a repository](/rest/reference/code-scanning#delete-a-code-scanning-analysis-from-a-repository)." |
|
||||
| `repo.change_merge_setting` | Pull request merge options were changed for a repository. |
|
||||
| `repo.clear_actions_settings` | A repository administrator cleared {% data variables.product.prodname_actions %} policy settings for a repository. |
|
||||
| `repo.config` | A repository administrator blocked force pushes. For more information, see [Blocking force pushes to a repository](/enterprise/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) to a repository. |
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `repo.config.disable_collaborators_only` | The interaction limit for collaborators only was disabled. 詳しい情報については「[リポジトリでの操作の制限](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)」を参照してください。 | `repo.config.disable_contributors_only` | The interaction limit for prior contributors only was disabled in a repository. 詳しい情報については「[リポジトリでの操作の制限](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)」を参照してください。 | `repo.config.disable_sockpuppet_disallowed` | The interaction limit for existing users only was disabled in a repository. 詳しい情報については「[リポジトリでの操作の制限](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)」を参照してください。 | `repo.config.enable_collaborators_only` | The interaction limit for collaborators only was enabled in a repository. Users that are not collaborators or organization members were unable to interact with a repository for a set duration. 詳しい情報については「[リポジトリでの操作の制限](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)」を参照してください。 | `repo.config.enable_contributors_only` | The interaction limit for prior contributors only was enabled in a repository. Users that are not prior contributors, collaborators or organization members were unable to interact with a repository for a set duration. 詳しい情報については「[リポジトリでの操作の制限](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)」を参照してください。 | `repo.config.enable_sockpuppet_disallowed` | The interaction limit for existing users was enabled in a repository. New users aren't able to interact with a repository for a set duration. Existing users of the repository, contributors, collaborators or organization members are able to interact with a repository. 詳しい情報については「[リポジトリでの操作の制限](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)」を参照してください。
|
||||
{%- endif %}
|
||||
{%- ifversion ghes %}
|
||||
| `repo.config.disable_anonymous_git_access`| Anonymous Git read access was disabled for a repository. 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | `repo.config.enable_anonymous_git_access` | Anonymous Git read access was enabled for a repository. 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | `repo.config.lock_anonymous_git_access` | A repository's anonymous Git read access setting was locked, preventing repository administrators from changing (enabling or disabling) this setting. 詳細は「[ユーザによる匿名Git読み取りアクセスの変更を禁止する](/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | `repo.config.unlock_anonymous_git_access` | A repository's anonymous Git read access setting was unlocked, allowing repository administrators to change (enable or disable) this setting. 詳細は「[ユーザによる匿名Git読み取りアクセスの変更を禁止する](/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。
|
||||
| `repo.config.disable_anonymous_git_access`| Anonymous Git read access was disabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository)." | `repo.config.enable_anonymous_git_access` | Anonymous Git read access was enabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository)." | `repo.config.lock_anonymous_git_access` | A repository's anonymous Git read access setting was locked, preventing repository administrators from changing (enabling or disabling) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | `repo.config.unlock_anonymous_git_access` | A repository's anonymous Git read access setting was unlocked, allowing repository administrators to change (enable or disable) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)."
|
||||
{%- endif %}
|
||||
| `repo.create` | A repository was created. | `repo.create_actions_secret` | A {% data variables.product.prodname_actions %} secret was created for a repository. 詳しい情報については、「[リポジトリに対して暗号化されたシークレットを作成する](/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository)」を参照してください。 | `repo.create_integration_secret` | A {% data variables.product.prodname_dependabot %}{% ifversion fpt or ghec %} or {% data variables.product.prodname_codespaces %}{% endif %} integration secret was created for a repository. | `repo.destroy` | A repository was deleted.
|
||||
| `repo.create` | A repository was created. | `repo.create_actions_secret` | A {% data variables.product.prodname_actions %} secret was created for a repository. For more information, see "[Creating encrypted secrets for a repository](/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." | `repo.create_integration_secret` | A {% data variables.product.prodname_dependabot %}{% ifversion fpt or ghec %} or {% data variables.product.prodname_codespaces %}{% endif %} integration secret was created for a repository. | `repo.destroy` | A repository was deleted.
|
||||
{%- ifversion ghes %}
|
||||
| `repo.disk_archive` | A repository was archived on disk. For more information, see "[Archiving repositories](/repositories/archiving-a-github-repository/archiving-repositories)."
|
||||
{%- endif %}
|
||||
@@ -1183,11 +1189,11 @@ The scope of the events that appear in your enterprise's audit log depend on whe
|
||||
|
||||
## `team_discussions` カテゴリアクション
|
||||
|
||||
| アクション | 説明 |
|
||||
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `team_discussions.clear` | An organization owner cleared the setting to allow team discussions for an organization or enterprise. |
|
||||
| `team_discussions.disable` | An organization owner disabled team discussions for an organization. For more information, see "[Disabling team discussions for your organization](/organizations/organizing-members-into-teams/disabling-team-discussions-for-your-organization)." |
|
||||
| `team_discussions.enable` | An organization owner enabled team discussions for an organization. |
|
||||
| アクション | 説明 |
|
||||
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `team_discussions.clear` | An organization owner cleared the setting to allow team discussions for an organization or enterprise. |
|
||||
| `team_discussions.disable` | An organization owner disabled team discussions for an organization. 詳しい情報については [Organization の Team ディスカッションの無効化](/organizations/organizing-members-into-teams/disabling-team-discussions-for-your-organization)を参照してください。 |
|
||||
| `team_discussions.enable` | An organization owner enabled team discussions for an organization. |
|
||||
|
||||
{%- ifversion ghec %}
|
||||
## `team_sync_tenant` category actions
|
||||
@@ -1228,7 +1234,7 @@ The scope of the events that appear in your enterprise's audit log depend on whe
|
||||
{%- ifversion ghes %}
|
||||
| `user.demote` | A site administrator was demoted to an ordinary user account.
|
||||
{%- endif %}
|
||||
| `user.destroy` | A user deleted his or her account, triggering `user.async_delete`. | `user.failed_login` | A user tries to sign in with an incorrect username, password, or two-factor authentication code. | `user.flag_as_large_scale_contributor` | A user account was flagged as a large scale contributor. Only contributions from public repositories the user owns will be shown in their contribution graph, in order to prevent timeouts. | `user.forgot_password` | A user requested a password reset via the sign-in page. | `user.hide_private_contributions_count` | A user changed the visibility of their private contributions. The number of contributions to private repositories on the user's profile are now hidden. For more information, see "[Publicizing or hiding your private contributions on your profile](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile)." | `user.lockout` | A user was locked out of their account. | `user.login` | A user signed in.
|
||||
| `user.destroy` | A user deleted his or her account, triggering `user.async_delete`. | `user.failed_login` | A user tries to sign in with an incorrect username, password, or two-factor authentication code. | `user.flag_as_large_scale_contributor` | A user account was flagged as a large scale contributor. Only contributions from public repositories the user owns will be shown in their contribution graph, in order to prevent timeouts. | `user.forgot_password` | A user requested a password reset via the sign-in page. | `user.hide_private_contributions_count` | A user changed the visibility of their private contributions. The number of contributions to private repositories on the user's profile are now hidden. 詳細は「[プライベートコントリビューションをプロフィールで公開または非公開にする](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile)」を参照してください。 | `user.lockout` | A user was locked out of their account. | `user.login` | A user signed in.
|
||||
{%- ifversion ghes or ghae %}
|
||||
| `user.mandatory_message_viewed` | A user viewed a mandatory message. For more information see "[Customizing user messages for your enterprise](/admin/user-management/managing-users-in-your-enterprise/customizing-user-messages-for-your-enterprise)" for details."
|
||||
{%- endif %}
|
||||
@@ -1236,7 +1242,7 @@ The scope of the events that appear in your enterprise's audit log depend on whe
|
||||
{%- ifversion ghes %}
|
||||
| `user.promote` | An ordinary user account was promoted to a site administrator.
|
||||
{%- endif %}
|
||||
| `user.recreate` | A user's account was restored. | `user.remove_email` | An email address was removed from a user account. | `user.remove_large_scale_contributor_flag` | A user account was no longer flagged as a large scale contributor. | `user.rename` | A username was changed. | `user.reset_password` | A user reset their account password. | `user.show_private_contributions_count` | A user changed the visibility of their private contributions. The number of contributions to private repositories on the user's profile are now shown. For more information, see "[Publicizing or hiding your private contributions on your profile](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile)." | `user.sign_in_from_unrecognized_device` | A user signed in from an unrecognized device. | `user.sign_in_from_unrecognized_device_and_location` | A user signed in from an unrecognized device and location. | `user.sign_in_from_unrecognized_location` | A user signed in from an unrecognized location. | `user.suspend` | A user account was suspended by an enterprise owner {% ifversion ghes %} or site administrator{% endif %}. | `user.two_factor_challenge_failure` | A 2FA challenge issued for a user account failed. | `user.two_factor_challenge_success` | A 2FA challenge issued for a user account succeeded. | `user.two_factor_recover` | A user used their 2FA recovery codes. | `user.two_factor_recovery_codes_downloaded` | A user downloaded 2FA recovery codes for their account. | `user.two_factor_recovery_codes_printed` | A user printed 2FA recovery codes for their account. | `user.two_factor_recovery_codes_viewed` | A user viewed 2FA recovery codes for their account. | `user.two_factor_requested` | A user was prompted for a two-factor authentication code. | `user.unblock_user` | A user was unblocked another user{% ifversion ghes %} or a site administrator{% endif %}. | `user.unminimize_comment` | A comment made by a user was unminimized. | `user.unsuspend` | A user account was unsuspended by an enterprise owner {% ifversion ghes %} or site administrator{% endif %}.
|
||||
| `user.recreate` | A user's account was restored. | `user.remove_email` | An email address was removed from a user account. | `user.remove_large_scale_contributor_flag` | A user account was no longer flagged as a large scale contributor. | `user.rename` | A username was changed. | `user.reset_password` | A user reset their account password. | `user.show_private_contributions_count` | A user changed the visibility of their private contributions. The number of contributions to private repositories on the user's profile are now shown. 詳細は「[プライベートコントリビューションをプロフィールで公開または非公開にする](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile)」を参照してください。 | `user.sign_in_from_unrecognized_device` | A user signed in from an unrecognized device. | `user.sign_in_from_unrecognized_device_and_location` | A user signed in from an unrecognized device and location. | `user.sign_in_from_unrecognized_location` | A user signed in from an unrecognized location. | `user.suspend` | A user account was suspended by an enterprise owner {% ifversion ghes %} or site administrator{% endif %}. | `user.two_factor_challenge_failure` | A 2FA challenge issued for a user account failed. | `user.two_factor_challenge_success` | A 2FA challenge issued for a user account succeeded. | `user.two_factor_recover` | A user used their 2FA recovery codes. | `user.two_factor_recovery_codes_downloaded` | A user downloaded 2FA recovery codes for their account. | `user.two_factor_recovery_codes_printed` | A user printed 2FA recovery codes for their account. | `user.two_factor_recovery_codes_viewed` | A user viewed 2FA recovery codes for their account. | `user.two_factor_requested` | A user was prompted for a two-factor authentication code. | `user.unblock_user` | A user was unblocked another user{% ifversion ghes %} or a site administrator{% endif %}. | `user.unminimize_comment` | A comment made by a user was unminimized. | `user.unsuspend` | A user account was unsuspended by an enterprise owner {% ifversion ghes %} or site administrator{% endif %}.
|
||||
{%- endif %}
|
||||
|
||||
{%- ifversion ghec or ghes %}
|
||||
|
||||
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: Configuring the audit log for your enterprise
|
||||
intro: You can configure settings for your enterprise's audit log.
|
||||
shortTitle: Configure audit logs
|
||||
permissions: Enterprise owners can configure the audit log.
|
||||
versions:
|
||||
feature: audit-data-retention-tab
|
||||
type: how_to
|
||||
topics:
|
||||
- Auditing
|
||||
- Enterprise
|
||||
- Logging
|
||||
---
|
||||
|
||||
## About audit log configuration
|
||||
|
||||
You can configure a retention period for audit log data and see index storage details.
|
||||
|
||||
{% ifversion enable-git-events %}
|
||||
After you configure a retention period, you can enable or disable Git-related events from appearing in the audit log.
|
||||
{% endif %}
|
||||
|
||||
## Configuring a retention period for audit log data
|
||||
|
||||
You can configure a retention period for audit log data for {% data variables.product.product_location %}. Data that exceeds the period you configure will be permanently removed from disk.
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.audit-log-tab %}
|
||||
{% data reusables.audit_log.audit-data-retention-tab %}
|
||||
1. Under "Configure audit log retention settings", select the dropdown menu and click a retention period.
|
||||
|
||||
|
||||
1. [**Save**] をクリックします。
|
||||
|
||||
{% ifversion enable-git-events %}
|
||||
## Managing Git events in the audit log
|
||||
|
||||
You can enable or disable Git-related events, such as `git.clone` and `git.push`, from appearing in your audit log. For a list of the Git events are are logged, see "[Audit log events for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#git-category-actions)."
|
||||
|
||||
If you do enable Git events, due to the large number of Git events that are logged, we recommend monitoring your instance's file storage and reviewing your related alert configurations. For more information, see "[Monitoring storage](/admin/enterprise-management/monitoring-your-appliance/recommended-alert-thresholds#monitoring-storage)."
|
||||
|
||||
Before you can enable Git events in the audit log, you must configure a retention period for audit log data other than "infinite." For more information, see "[Configuring a retention period for audit log data](#configuring-a-retention-period-for-audit-log-data)."
|
||||
|
||||
{% data reusables.audit_log.git-events-not-in-search-results %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.audit-log-tab %}
|
||||
{% data reusables.audit_log.audit-data-retention-tab %}
|
||||
1. Under "Git event opt-in", select or deselect **Enable git events in the audit-log**.
|
||||
|
||||
|
||||
1. [**Save**] をクリックします。
|
||||
|
||||
{% endif %}
|
||||
@@ -11,6 +11,7 @@ topics:
|
||||
children:
|
||||
- /about-the-audit-log-for-your-enterprise
|
||||
- /accessing-the-audit-log-for-your-enterprise
|
||||
- /configuring-the-audit-log-for-your-enterprise
|
||||
- /displaying-ip-addresses-in-the-audit-log-for-your-enterprise
|
||||
- /searching-the-audit-log-for-your-enterprise
|
||||
- /exporting-audit-log-activity-for-your-enterprise
|
||||
|
||||
@@ -29,9 +29,11 @@ You can search your enterprise audit log directly from the user interface by usi
|
||||
|
||||
For more information about viewing your enterprise audit log, see "[Accessing the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise)."
|
||||
|
||||
{% data reusables.audit_log.git-events-not-in-search-results %}
|
||||
|
||||
You can also use the API to retrieve audit log events. For more information, see "[Using the audit log API for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise)."
|
||||
|
||||
テキストを使用してエントリを検索することはできません。 ただし、さまざまなフィルターを使用すれば検索クエリを作成できます。 ログを検索するときに使用される多くの演算子 (`-`、`>`、`<` など) は、{% data variables.product.product_name %} 全体で検索するものと同じ形式です。 詳細は「[{% data variables.product.prodname_dotcom %} での検索](/search-github/getting-started-with-searching-on-github/about-searching-on-github)」を参照してください。
|
||||
You cannot search for entries using text. ただし、さまざまなフィルターを使用すれば検索クエリを作成できます。 ログを検索するときに使用される多くの演算子 (`-`、`>`、`<` など) は、{% data variables.product.product_name %} 全体で検索するものと同じ形式です。 詳細は「[{% data variables.product.prodname_dotcom %} での検索](/search-github/getting-started-with-searching-on-github/about-searching-on-github)」を参照してください。
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -16,11 +16,11 @@ topics:
|
||||
|
||||
## {% data variables.product.prodname_container_registry %} について
|
||||
|
||||
{% data reusables.package_registry.container-registry-benefits %} For more information, see "[Working with the {% data variables.product.prodname_container_registry %}](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)."
|
||||
{% data reusables.package_registry.container-registry-benefits %} 詳しい情報については「[{% data variables.product.prodname_container_registry %}での作業](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)」を参照してください。
|
||||
|
||||
For more information about configuring {% data variables.product.prodname_registry %} for {% data variables.product.product_location %}, see "[Getting started with {% data variables.product.prodname_registry %} for your enterprise](/admin/packages/getting-started-with-github-packages-for-your-enterprise)."
|
||||
|
||||
## About migration from the Docker registry
|
||||
## Dockerレジストリからの移行について
|
||||
|
||||
{% data reusables.package_registry.container-registry-replaces-docker-registry %} If the Docker registry on {% data variables.product.product_location %} contains images, you must manually migrate the images to the {% data variables.product.prodname_container_registry %}.
|
||||
|
||||
|
||||
@@ -68,7 +68,7 @@ When you want to use an {% data variables.product.prodname_oauth_app %} that int
|
||||
| Personal user data | User data includes information found in your user profile, like your name, e-mail address, and location. |
|
||||
| Repositories | Repository information includes the names of contributors, the branches you've created, and the actual files within your repository. Apps can request access for either public or private repositories on a user-wide level. |
|
||||
| Repository delete | Apps can request to delete repositories that you administer, but they won't have access to your code. |{% ifversion projects-oauth-scope %}
|
||||
| Projects | Access to user and organization projects (beta). Apps can request either read/write or read only access. |{% endif %}
|
||||
| Projects | Access to user and organization {% data variables.projects.projects_v2 %}. Apps can request either read/write or read only access. |{% endif %}
|
||||
|
||||
## Requesting updated permissions
|
||||
|
||||
|
||||
@@ -22,6 +22,9 @@ Organization については、Organization のオーナーと支払いマネー
|
||||
{% data reusables.organizations.billing-settings %}
|
||||
{% data reusables.dotcom_billing.codespaces-minutes %}
|
||||
{% data reusables.dotcom_billing.actions-packages-report-download-org-account %}
|
||||
1. Filter the report to show only rows that mention "Codespaces" in the `Product` field.
|
||||
|
||||
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Enterprise アカウントの {% data variables.product.prodname_codespaces %} の使用状況を表示する
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: GitHub Advisory Databaseのセキュリティアドバイザリの閲覧
|
||||
intro: '{% data variables.product.prodname_advisory_database %}を閲覧して、{% data variables.product.company_short %}でホストされているオープンソースプロジェクトのセキュリティリスクに対するアドバイザリを見つけることができます。'
|
||||
shortTitle: Advisory Databaseの参照
|
||||
title: Browsing security advisories in the GitHub Advisory Database
|
||||
intro: 'You can browse the {% data variables.product.prodname_advisory_database %} to find advisories for security risks in open source projects that are hosted on {% data variables.product.company_short %}.'
|
||||
shortTitle: Browse Advisory Database
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database
|
||||
@@ -21,127 +21,143 @@ topics:
|
||||
- Vulnerabilities
|
||||
- CVEs
|
||||
---
|
||||
|
||||
<!--Marketing-LINK: From /features/security/software-supply-chain page "Browsing security vulnerabilities in the GitHub Advisory Database".-->
|
||||
|
||||
## {% data variables.product.prodname_advisory_database %} について
|
||||
## About the {% data variables.product.prodname_advisory_database %}
|
||||
|
||||
The {% data variables.product.prodname_advisory_database %} contains a list of known security vulnerabilities {% ifversion GH-advisory-db-supports-malware %}and malware, {% endif %}grouped in two categories: {% data variables.product.company_short %}-reviewed advisories and unreviewed advisories.
|
||||
|
||||
{% data reusables.repositories.tracks-vulnerabilities %}
|
||||
|
||||
## セキュリティアドバイザリのタイプについて
|
||||
## About types of security advisories
|
||||
|
||||
{% data reusables.advisory-database.beta-malware-advisories %}
|
||||
|
||||
Each advisory in the {% data variables.product.prodname_advisory_database %} is for a vulnerability in open source projects{% ifversion GH-advisory-db-supports-malware %} or for malicious open source software{% endif %}.
|
||||
Each advisory in the {% data variables.product.prodname_advisory_database %} is for a vulnerability in open source projects{% ifversion GH-advisory-db-supports-malware %} or for malicious open source software{% endif %}.
|
||||
|
||||
通常、コード内の{% data reusables.repositories.a-vulnerability-is %}の脆弱性は、偶然に導入され、発見されるとすぐに修正されます。 依存関係の修正されたバージョンを使うよう、コードはできるかぎり早く更新しなければなりません。
|
||||
{% data reusables.repositories.a-vulnerability-is %} Vulnerabilities in code are usually introduced by accident and fixed soon after they are discovered. You should update your code to use the fixed version of the dependency as soon as it is available.
|
||||
|
||||
{% ifversion GH-advisory-db-supports-malware %}
|
||||
|
||||
対照的に、悪意のあるソフトウェア、またはマルウェアは、意図的に望ましくない、もしくは有害な機能を実行するように設計されたものです。 マルウェアは、ハードウェア、ソフトウェア、機密データ、あるいはマルウェアを使うアプリケーションのユーザを標的にする可能性があります。 マルウェアはプロジェクトから取り除き、その依存関係の安全な代替物を見つけなければなりません。
|
||||
In contrast, malicious software, or malware, is code that is intentionally designed to perform unwanted or harmful functions. The malware may target hardware, software, confidential data, or users of any application that uses the malware. You need to remove the malware from your project and find an alternative, more secure replacement for the dependency.
|
||||
|
||||
{% endif %}
|
||||
|
||||
### {% data variables.product.company_short %}がレビューしたアドバイザリ
|
||||
### {% data variables.product.company_short %}-reviewed advisories
|
||||
|
||||
{% data variables.product.company_short %}-reviewed advisories are security vulnerabilities{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %} that have been mapped to packages in ecosystems we support. 各アドバイザリの有効性は慎重にレビューされ、完全な説明が成されており、エコシステムとパッケージの両方の情報が含まれていることが保証されています。
|
||||
{% data variables.product.company_short %}-reviewed advisories are security vulnerabilities{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %} that have been mapped to packages in ecosystems we support. We carefully review each advisory for validity and ensure that they have a full description, and contain both ecosystem and package information.
|
||||
|
||||
一般的に、サポートされているエコシステムはソフトウェアプログラミング言語の関連するパッケージレジストリにちなんで名付けられています。 アドバイザリは、サポートされているレジストリから来たパッケージ内の脆弱性に対するものであれば、レビューが行われます。
|
||||
Generally, we name our supported ecosystems after the software programming language's associated package registry. We review advisories if they are for a vulnerability in a package that comes from a supported registry.
|
||||
|
||||
- Composer (registry: https://packagist.org/){% ifversion GH-advisory-db-erlang-support %}
|
||||
- Erlang (registry: https://hex.pm/){% endif %}
|
||||
- Go (レジストリ: https://pkg.go.dev/)
|
||||
- Maven (レジストリ: https://repo1.maven.org/maven2/org/)
|
||||
- npm (レジストリ: https://www.npmjs.com/)
|
||||
- NuGet (レジストリ: https://www.nuget.org/)
|
||||
- pip (レジストリ: https://pypi.org/)
|
||||
- RubyGems (レジストリ: https://rubygems.org/)
|
||||
- Rust (レジストリ: https://crates.io/)
|
||||
- Go (registry: https://pkg.go.dev/)
|
||||
- Maven (registry: https://repo1.maven.org/maven2/org/)
|
||||
- npm (registry: https://www.npmjs.com/)
|
||||
- NuGet (registry: https://www.nuget.org/)
|
||||
- pip (registry: https://pypi.org/)
|
||||
- RubyGems (registry: https://rubygems.org/)
|
||||
- Rust (registry: https://crates.io/)
|
||||
|
||||
サポートすべき新しいエコシステムの提案がある場合は、議論のための[Issue](https://github.com/github/advisory-database/issues)をオープンしてください。
|
||||
If you have a suggestion for a new ecosystem we should support, please open an [issue](https://github.com/github/advisory-database/issues) for discussion.
|
||||
|
||||
If you enable {% data variables.product.prodname_dependabot_alerts %} for your repositories, you are automatically notified when a new {% data variables.product.company_short %}-reviewed advisory reports a vulnerability {% ifversion GH-advisory-db-supports-malware %}or malware{% endif %} for a package you depend on. 詳しい情報については「[{% data variables.product.prodname_dependabot_alerts %}について](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)」を参照してください。
|
||||
If you enable {% data variables.product.prodname_dependabot_alerts %} for your repositories, you are automatically notified when a new {% data variables.product.company_short %}-reviewed advisory reports a vulnerability {% ifversion GH-advisory-db-supports-malware %}or malware{% endif %} for a package you depend on. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)."
|
||||
|
||||
### レビューされていないアドバイザリ
|
||||
### Unreviewed advisories
|
||||
|
||||
レビューされていないアドバイザリは、自動的にNational Vulnerability Databaseフィードから直接{% data variables.product.prodname_advisory_database %}へ展開されたセキュリティ脆弱性です。
|
||||
Unreviewed advisories are security vulnerabilites that we publish automatically into the {% data variables.product.prodname_advisory_database %}, directly from the National Vulnerability Database feed.
|
||||
|
||||
この種のアドバイザリは妥当性あるいは完全性がチェックされていないので、レビューされていないアドバイザリに対して{% data variables.product.prodname_dependabot %}は{% data variables.product.prodname_dependabot_alerts %}を生成しません。
|
||||
{% data variables.product.prodname_dependabot %} doesn't create {% data variables.product.prodname_dependabot_alerts %} for unreviewed advisories as this type of advisory isn't checked for validity or completion.
|
||||
|
||||
## セキュリティアドバイザリ内の情報について
|
||||
## About information in security advisories
|
||||
|
||||
Each security advisory contains information about the vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware,{% endif %} which may include the description, severity, affected package, package ecosystem, affected versions and patched versions, impact, and optional information such as references, workarounds, and credits. さらに、National Vulnerability Database リストのアドバイザリには、CVE レコードへのリンクが含まれており、脆弱性、その CVSS スコア、その定性的な重要度レベルの詳細を確認できます。 詳しい情報については、アメリカ国立標準技術研究所の「[National Vulnerability Database](https://nvd.nist.gov/)"」を参照してください。
|
||||
Each security advisory contains information about the vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware,{% endif %} which may include the description, severity, affected package, package ecosystem, affected versions and patched versions, impact, and optional information such as references, workarounds, and credits. In addition, advisories from the National Vulnerability Database list contain a link to the CVE record, where you can read more details about the vulnerability, its CVSS scores, and its qualitative severity level. For more information, see the "[National Vulnerability Database](https://nvd.nist.gov/)" from the National Institute of Standards and Technology.
|
||||
|
||||
重大度レベルは「[Common Vulnerability Scoring System (CVSS), Section 5](https://www.first.org/cvss/specification-document)」で定義されている 4 つのレベルのいずれかです。
|
||||
The severity level is one of four possible levels defined in the "[Common Vulnerability Scoring System (CVSS), Section 5](https://www.first.org/cvss/specification-document)."
|
||||
- Low
|
||||
- Medium/Moderate
|
||||
- High
|
||||
- Critical
|
||||
|
||||
{% data variables.product.prodname_advisory_database %} は、上記の CVSS レベルを使用します。 {% data variables.product.company_short %} が CVE を取得した場合、{% data variables.product.prodname_advisory_database %} は CVSS バージョン 3.1 を使用します。 CVE がインポートされた場合、{% data variables.product.prodname_advisory_database %} は CVSS バージョン 3.0 と 3.1 の両方をサポートします。
|
||||
The {% data variables.product.prodname_advisory_database %} uses the CVSS levels described above. If {% data variables.product.company_short %} obtains a CVE, the {% data variables.product.prodname_advisory_database %} uses CVSS version 3.1. If the CVE is imported, the {% data variables.product.prodname_advisory_database %} supports both CVSS versions 3.0 and 3.1.
|
||||
|
||||
{% data reusables.repositories.github-security-lab %}
|
||||
|
||||
## {% data variables.product.prodname_advisory_database %} のアドバイザリにアクセスする
|
||||
## Accessing an advisory in the {% data variables.product.prodname_advisory_database %}
|
||||
|
||||
1. Https://github.com/advisories にアクセスします。
|
||||
2. 必要に応じて、リストをフィルタするには、ドロップダウンメニューを使用します。 
|
||||
1. Navigate to https://github.com/advisories.
|
||||
2. Optionally, to filter the list, use any of the drop-down menus.
|
||||
|
||||
{% tip %}
|
||||
|
||||
**参考:** 左側のサイドバーを使って、{% data variables.product.company_short %}がレビューしたアドバイザリとレビューされていないアドバイザリを個別に調べることができます。
|
||||
**Tip:** You can use the sidebar on the left to explore {% data variables.product.company_short %}-reviewed and unreviewed advisories separately.
|
||||
|
||||
{% endtip %}
|
||||
3. Click an advisory to view details. デフォルトでは、セキュリティ脆弱性に対する{% data variables.product.company_short %}がレビューしたアドバイザリが表示されます。 {% ifversion GH-advisory-db-supports-malware %}To show malware advisories, use `type:malware` in the search bar.{% endif %}
|
||||
3. Click an advisory to view details. By default, you will see {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities. {% ifversion GH-advisory-db-supports-malware %}To show malware advisories, use `type:malware` in the search bar.{% endif %}
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
データベースは、GraphQL API を使用してアクセスすることもできます。 {% ifversion GH-advisory-db-supports-malware %}By default, queries will return {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities unless you specify `type:malware`.{% endif %} For more information, see the "[`security_advisory` webhook event](/webhooks/event-payloads/#security_advisory)."
|
||||
The database is also accessible using the GraphQL API. {% ifversion GH-advisory-db-supports-malware %}By default, queries will return {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities unless you specify `type:malware`.{% endif %} For more information, see the "[`security_advisory` webhook event](/webhooks/event-payloads/#security_advisory)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## {% data variables.product.prodname_advisory_database %}中のアドバイザリの編集
|
||||
{% data variables.product.prodname_advisory_database %}のアドバイザリには、改善を提案できます。 詳しい情報については「[{% data variables.product.prodname_advisory_database %}中のセキュリティアドバイザリの編集](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/editing-security-advisories-in-the-github-advisory-database)」を参照してください。
|
||||
## Editing an advisory in the {% data variables.product.prodname_advisory_database %}
|
||||
You can suggest improvements to any advisory in the {% data variables.product.prodname_advisory_database %}. For more information, see "[Editing security advisories in the {% data variables.product.prodname_advisory_database %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/editing-security-advisories-in-the-github-advisory-database)."
|
||||
|
||||
## {% data variables.product.prodname_advisory_database %} を検索する
|
||||
## Searching the {% data variables.product.prodname_advisory_database %}
|
||||
|
||||
データベースを検索し、修飾子を使用して検索を絞り込むことができます。 たとえば、特定の日付、特定のエコシステム、または特定のライブラリで作成されたアドバイザリを検索できます。
|
||||
You can search the database, and use qualifiers to narrow your search. For example, you can search for advisories created on a certain date, in a specific ecosystem, or in a particular library.
|
||||
|
||||
{% data reusables.time_date.date_format %} {% data reusables.time_date.time_format %}
|
||||
|
||||
{% data reusables.search.date_gt_lt %}
|
||||
|
||||
| 修飾子 | サンプル |
|
||||
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `type:reviewed` | [**type:reviewed**](https://github.com/advisories?query=type%3Areviewed)は、セキュリティ脆弱性に対する{% data variables.product.company_short %}がレビューしたアドバイザリを表示します。 |
|
||||
| Qualifier | Example |
|
||||
| ------------- | ------------- |
|
||||
| `type:reviewed`| [**type:reviewed**](https://github.com/advisories?query=type%3Areviewed) will show {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities. |
|
||||
{% ifversion GH-advisory-db-supports-malware %}| `type:malware` | [**type:malware**](https://github.com/advisories?query=type%3Amalware) will show {% data variables.product.company_short %}-reviewed advisories for malware. |
|
||||
{% endif %}| `type:unreviewed`| [**type:unreviewed**](https://github.com/advisories?query=type%3Aunreviewed) will show unreviewed advisories. |
|
||||
| `GHSA-ID`| [**GHSA-49wp-qq6x-g2rf**](https://github.com/advisories?query=GHSA-49wp-qq6x-g2rf) will show the advisory with this {% data variables.product.prodname_advisory_database %} ID. | | `CVE-ID`| [**CVE-2020-28482**](https://github.com/advisories?query=CVE-2020-28482) will show the advisory with this CVE ID number. | | `ecosystem:ECOSYSTEM`| [**ecosystem:npm**](https://github.com/advisories?utf8=%E2%9C%93&query=ecosystem%3Anpm) will show only advisories affecting NPM packages. | | `severity:LEVEL`| [**severity:high**](https://github.com/advisories?utf8=%E2%9C%93&query=severity%3Ahigh) will show only advisories with a high severity level. | | `affects:LIBRARY`| [**affects:lodash**](https://github.com/advisories?utf8=%E2%9C%93&query=affects%3Alodash) will show only advisories affecting the lodash library. | | `cwe:ID`| [**cwe:352**](https://github.com/advisories?query=cwe%3A352) will show only advisories with this CWE number. | | `credit:USERNAME`| [**credit:octocat**](https://github.com/advisories?query=credit%3Aoctocat) will show only advisories credited to the "octocat" user account. | | `sort:created-asc`| [**sort:created-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-asc) will sort by the oldest advisories first. | | `sort:created-desc`| [**sort:created-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-desc) will sort by the newest advisories first. | | `sort:updated-asc`| [**sort:updated-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-asc) will sort by the least recently updated first. | | `sort:updated-desc`| [**sort:updated-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-desc) will sort by the most recently updated first. | | `is:withdrawn`| [**is:withdrawn**](https://github.com/advisories?utf8=%E2%9C%93&query=is%3Awithdrawn) will show only advisories that have been withdrawn. | | `created:YYYY-MM-DD`| [**created:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=created%3A2021-01-13) will show only advisories created on this date. | | `updated:YYYY-MM-DD`| [**updated:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=updated%3A2021-01-13) will show only advisories updated on this date. |
|
||||
| `GHSA-ID`| [**GHSA-49wp-qq6x-g2rf**](https://github.com/advisories?query=GHSA-49wp-qq6x-g2rf) will show the advisory with this {% data variables.product.prodname_advisory_database %} ID. |
|
||||
| `CVE-ID`| [**CVE-2020-28482**](https://github.com/advisories?query=CVE-2020-28482) will show the advisory with this CVE ID number. |
|
||||
| `ecosystem:ECOSYSTEM`| [**ecosystem:npm**](https://github.com/advisories?utf8=%E2%9C%93&query=ecosystem%3Anpm) will show only advisories affecting NPM packages. |
|
||||
| `severity:LEVEL`| [**severity:high**](https://github.com/advisories?utf8=%E2%9C%93&query=severity%3Ahigh) will show only advisories with a high severity level. |
|
||||
| `affects:LIBRARY`| [**affects:lodash**](https://github.com/advisories?utf8=%E2%9C%93&query=affects%3Alodash) will show only advisories affecting the lodash library. |
|
||||
| `cwe:ID`| [**cwe:352**](https://github.com/advisories?query=cwe%3A352) will show only advisories with this CWE number. |
|
||||
| `credit:USERNAME`| [**credit:octocat**](https://github.com/advisories?query=credit%3Aoctocat) will show only advisories credited to the "octocat" user account. |
|
||||
| `sort:created-asc`| [**sort:created-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-asc) will sort by the oldest advisories first. |
|
||||
| `sort:created-desc`| [**sort:created-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-desc) will sort by the newest advisories first. |
|
||||
| `sort:updated-asc`| [**sort:updated-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-asc) will sort by the least recently updated first. |
|
||||
| `sort:updated-desc`| [**sort:updated-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-desc) will sort by the most recently updated first. |
|
||||
| `is:withdrawn`| [**is:withdrawn**](https://github.com/advisories?utf8=%E2%9C%93&query=is%3Awithdrawn) will show only advisories that have been withdrawn. |
|
||||
| `created:YYYY-MM-DD`| [**created:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=created%3A2021-01-13) will show only advisories created on this date. |
|
||||
| `updated:YYYY-MM-DD`| [**updated:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=updated%3A2021-01-13) will show only advisories updated on this date. |
|
||||
|
||||
## 脆弱性のあるリポジトリを表示する
|
||||
## Viewing your vulnerable repositories
|
||||
|
||||
For any {% data variables.product.company_short %}-reviewed advisory in the {% data variables.product.prodname_advisory_database %}, you can see which of your repositories are affected by that security vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %}. 脆弱性のあるリポジトリを確認するには、そのリポジトリの {% data variables.product.prodname_dependabot_alerts %} にアクセスできる必要があります。 詳しい情報については「[{% data variables.product.prodname_dependabot_alerts %}について](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)」を参照してください。
|
||||
For any {% data variables.product.company_short %}-reviewed advisory in the {% data variables.product.prodname_advisory_database %}, you can see which of your repositories are affected by that security vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %}. To see a vulnerable repository, you must have access to {% data variables.product.prodname_dependabot_alerts %} for that repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)."
|
||||
|
||||
1. Https://github.com/advisories にアクセスします。
|
||||
2. アドバイザリをクリックします。
|
||||
3. アドバイザリページの上部にある [**Dependabot alerts**] をクリックします。 
|
||||
4. 必要に応じて、リストをフィルタするには、検索バーまたはドロップダウンメニューを使用します。 [Organization] ドロップダウンメニューを使用すると、オーナー（Organization またはユーザ）ごとに {% data variables.product.prodname_dependabot_alerts %} をフィルタできます。 
|
||||
5. アドバイザリに関する詳細、そして脆弱性のあるリポジトリの修正方法に関するアドバイスについては、リポジトリ名をクリックしてください。
|
||||
1. Navigate to https://github.com/advisories.
|
||||
2. Click an advisory.
|
||||
3. At the top of the advisory page, click **Dependabot alerts**.
|
||||
|
||||
4. Optionally, to filter the list, use the search bar or the drop-down menus. The "Organization" drop-down menu allows you to filter the {% data variables.product.prodname_dependabot_alerts %} per owner (organization or user).
|
||||
|
||||
5. For more details about the advisory, and for advice on how to fix the vulnerable repository, click the repository name.
|
||||
|
||||
{% ifversion security-advisories-ghes-ghae %}
|
||||
## Accessing the local advisory database on {% data variables.product.product_location %}
|
||||
|
||||
If your site administrator has enabled {% data variables.product.prodname_github_connect %} for {% data variables.product.product_location %}, you can also browse reviewed advisories locally. 詳しい情報については「[{% data variables.product.prodname_github_connect %}について](/admin/configuration/configuring-github-connect/about-github-connect)」を参照してください。
|
||||
If your site administrator has enabled {% data variables.product.prodname_github_connect %} for {% data variables.product.product_location %}, you can also browse reviewed advisories locally. For more information, see "[About {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/about-github-connect)".
|
||||
|
||||
You can use your local advisory database to check whether a specific security vulnerability is included, and therefore whether you'd get alerts for vulnerable dependencies. You can also view any vulnerable repositories.
|
||||
You can use your local advisory database to check whether a specific security vulnerability is included, and therefore whether you'd get alerts for vulnerable dependencies. You can also view any vulnerable repositories.
|
||||
|
||||
1. Navigate to `https://HOSTNAME/advisories`.
|
||||
2. 必要に応じて、リストをフィルタするには、ドロップダウンメニューを使用します。 
|
||||
2. Optionally, to filter the list, use any of the drop-down menus.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Only reviewed advisories will be listed. Unreviewed advisories can be viewed in the {% data variables.product.prodname_advisory_database %} on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Accessing an advisory in the GitHub Advisory Database](#accessing-an-advisory-in-the-github-advisory-database)".
|
||||
**Note:** Only reviewed advisories will be listed. Unreviewed advisories can be viewed in the {% data variables.product.prodname_advisory_database %} on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Accessing an advisory in the GitHub Advisory Database](#accessing-an-advisory-in-the-github-advisory-database)".
|
||||
|
||||
{% endnote %}
|
||||
3. Click an advisory to view details.{% ifversion GH-advisory-db-supports-malware %} By default, you will see {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities. To show malware advisories, use `type:malware` in the search bar.{% endif %}
|
||||
@@ -152,16 +168,18 @@ You can also suggest improvements to any advisory directly from your local advis
|
||||
|
||||
{% data reusables.repositories.enable-security-alerts %}
|
||||
|
||||
In the local advisory database, you can see which repositories are affected by each security vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %}. 脆弱性のあるリポジトリを確認するには、そのリポジトリの {% data variables.product.prodname_dependabot_alerts %} にアクセスできる必要があります。 詳しい情報については「[{% data variables.product.prodname_dependabot_alerts %}について](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)」を参照してください。
|
||||
In the local advisory database, you can see which repositories are affected by each security vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %}. To see a vulnerable repository, you must have access to {% data variables.product.prodname_dependabot_alerts %} for that repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)."
|
||||
|
||||
1. Navigate to `https://HOSTNAME/advisories`.
|
||||
2. アドバイザリをクリックします。
|
||||
3. アドバイザリページの上部にある [**Dependabot alerts**] をクリックします。 
|
||||
4. 必要に応じて、リストをフィルタするには、検索バーまたはドロップダウンメニューを使用します。 [Organization] ドロップダウンメニューを使用すると、オーナー（Organization またはユーザ）ごとに {% data variables.product.prodname_dependabot_alerts %} をフィルタできます。 
|
||||
5. アドバイザリに関する詳細、そして脆弱性のあるリポジトリの修正方法に関するアドバイスについては、リポジトリ名をクリックしてください。
|
||||
2. Click an advisory.
|
||||
3. At the top of the advisory page, click **Dependabot alerts**.
|
||||
|
||||
4. Optionally, to filter the list, use the search bar or the drop-down menus. The "Organization" drop-down menu allows you to filter the {% data variables.product.prodname_dependabot_alerts %} per owner (organization or user).
|
||||
|
||||
5. For more details about the advisory, and for advice on how to fix the vulnerable repository, click the repository name.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## 参考リンク
|
||||
## Further reading
|
||||
|
||||
- MITREの[「脆弱性」の定義](https://www.cve.org/ResourcesSupport/Glossary#vulnerability)
|
||||
- MITRE's [definition of "vulnerability"](https://www.cve.org/ResourcesSupport/Glossary#vulnerability)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: GitHub Advisory Databaseのセキュリティアドバイザリの編集
|
||||
intro: '{% data variables.product.prodname_advisory_database %}で公開されているアドバイザリには、改善を提案できます。'
|
||||
title: Editing security advisories in the GitHub Advisory Database
|
||||
intro: 'You can submit improvements to any advisory published in the {% data variables.product.prodname_advisory_database %}.'
|
||||
redirect_from:
|
||||
- /code-security/security-advisories/editing-security-advisories-in-the-github-advisory-database
|
||||
- /code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/editing-security-advisories-in-the-github-advisory-database
|
||||
@@ -16,32 +16,34 @@ topics:
|
||||
- Dependabot
|
||||
- Vulnerabilities
|
||||
- CVEs
|
||||
shortTitle: Advisory Databaseの編集
|
||||
shortTitle: Edit Advisory Database
|
||||
---
|
||||
|
||||
## {% data variables.product.prodname_advisory_database %}内のアドバイザリの編集について
|
||||
[github.com/advisories](https://github.com/advisories)にある{% data variables.product.prodname_advisory_database %}中のセキュリティアドバイザリは、グローバルなアドバイザリとみなされています。 {% data variables.product.prodname_advisory_database %}中のグローバルなセキュリティアドバイザリには、誰でも改善を提案できます。 追加で影響を受けるエコシステム、重要度、影響を受ける人の説明を含む、いかなる詳細も編集や追加ができます。 {% data variables.product.prodname_security %}のキュレーションチームは提案された改善をレビューし、受理されればそれらを{% data variables.product.prodname_advisory_database %}上に公開します。
|
||||
## About editing advisories in the {% data variables.product.prodname_advisory_database %}
|
||||
Security advisories in the {% data variables.product.prodname_advisory_database %} at [github.com/advisories](https://github.com/advisories) are considered global advisories. Anyone can suggest improvements on any global security advisory in the {% data variables.product.prodname_advisory_database %}. You can edit or add any detail, including additionally affected ecosystems, severity level or description of who is impacted. The {% data variables.product.prodname_security %} curation team will review the submitted improvements and publish them onto the {% data variables.product.prodname_advisory_database %} if accepted.
|
||||
{% ifversion fpt or ghec %}
|
||||
リポジトリレベルのセキュリティアドバイザリを編集できるのは、リポジトリのオーナーと管理者のみです。 For more information, see "[Editing a repository security advisory](/code-security/security-advisories/editing-a-security-advisory)."{% endif %}
|
||||
Only repository owners and administrators can edit repository-level security advisories. For more information, see "[Editing a repository security advisory](/code-security/security-advisories/editing-a-security-advisory)."{% endif %}
|
||||
|
||||
## GitHub Advisory Database中のアドバイザリの編集
|
||||
## Editing advisories in the GitHub Advisory Database
|
||||
|
||||
1. Https://github.com/advisories にアクセスします。
|
||||
2. コントリビュートしたいセキュリティアドバイザリを選択してください。
|
||||
3. ページの右側で、**Suggest improvements for this vulnerability（この脆弱性に改善を提案）**をクリックしてください。 
|
||||
4. コントリビューションフォームで、希望する改善を行ってください。 どのような詳細でも編集あるいは追加できます。
|
||||
5. アドバイザリの編集を終えたら、**Submit improvements（改善を提案）**をクリックしてください。
|
||||
6. 改善を提案したら、その変更を含むPull Requestが{% data variables.product.prodname_security %}キュレーションチームによって[github/advisory-database](https://github.com/github/advisory-database)内にレビューのために作成されます。 そのアドバイザリの発生元が{% data variables.product.prodname_dotcom %}リポジトリなら、オプションのコメントのためにオリジナルの公開者をタグ付けします。 あなたはこのPull Requestを見ることができ、このPull Requestが更新されるかクローズされると通知を受けます。
|
||||
1. Navigate to https://github.com/advisories.
|
||||
2. Select the security advisory you would like to contribute to.
|
||||
3. On the right-hand side of the page, click the **Suggest improvements for this vulnerability** link.
|
||||
|
||||
4. In the contribution form, make the desired improvements. You can edit or add any detail.
|
||||
5. When you finish editing the advisory, click **Submit improvements**.
|
||||
6. Once you submit your improvements, a pull request containing your changes will be created for review in [github/advisory-database](https://github.com/github/advisory-database) by the {% data variables.product.prodname_security %} curation team. If the advisory originated from a {% data variables.product.prodname_dotcom %} repository, we will also tag the original publisher for optional commentary. You can view the pull request and get notifications when it is updated or closed.
|
||||
|
||||
[github/advisory-database](https://github.com/github/advisory-database)リポジトリ中のアドバイザリファイルに対して直接Pull Requestをオープンすることもできます。 詳しい情報については[コントリビューションのガイドライン](https://github.com/github/advisory-database/blob/main/CONTRIBUTING.md)を参照してください。
|
||||
You can also open a pull request directly on an advisory file in the [github/advisory-database](https://github.com/github/advisory-database) repository. For more information, see the [contribution guidelines](https://github.com/github/advisory-database/blob/main/CONTRIBUTING.md).
|
||||
|
||||
{% ifversion security-advisories-ghes-ghae %}
|
||||
## Editing advisories from {% data variables.product.product_location %}
|
||||
|
||||
If you have {% data variables.product.prodname_github_connect %} enabled for {% data variables.product.product_location %}, you will be able to see advisories by adding `/advisories` to the instance url.
|
||||
If you have {% data variables.product.prodname_github_connect %} enabled for {% data variables.product.product_location %}, you will be able to see advisories by adding `/advisories` to the instance url.
|
||||
|
||||
1. Navigate to `https://HOSTNAME/advisories`.
|
||||
2. コントリビュートしたいセキュリティアドバイザリを選択してください。
|
||||
3. On the right-hand side of the page, click the **Suggest improvements for this vulnerability on Github.com.** link. A new tab opens with the same security advisory on {% data variables.product.prodname_dotcom_the_website %}. 
|
||||
2. Select the security advisory you would like to contribute to.
|
||||
3. On the right-hand side of the page, click the **Suggest improvements for this vulnerability on Github.com.** link. A new tab opens with the same security advisory on {% data variables.product.prodname_dotcom_the_website %}.
|
||||
|
||||
4. Edit the advisory, following steps four through six in "[Editing advisories in the GitHub Advisory Database](#editing-advisories-in-the-github-advisory-database)" above.
|
||||
{% endif %}
|
||||
|
||||
@@ -43,6 +43,8 @@ For workflows initiated by {% data variables.product.prodname_dependabot %} (`gi
|
||||
For workflows initiated by {% data variables.product.prodname_dependabot %} (`github.actor == "dependabot[bot]"`) using the `pull_request_target` event, if the base ref of the pull request was created by {% data variables.product.prodname_dependabot %} (`github.actor == "dependabot[bot]"`), the `GITHUB_TOKEN` will be read-only and secrets are not available.
|
||||
{% endif %}
|
||||
|
||||
{% ifversion actions-stable-actor-ids %}These restrictions apply even if the workflow is re-run by a different actor.{% endif %}
|
||||
|
||||
For more information, see ["Keeping your GitHub Actions and workflows secure: Preventing pwn requests"](https://securitylab.github.com/research/github-actions-preventing-pwn-requests/).
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.3 %}
|
||||
@@ -224,8 +226,16 @@ jobs:
|
||||
|
||||
### Manually re-running a workflow
|
||||
|
||||
{% ifversion actions-stable-actor-ids %}
|
||||
|
||||
When you manually re-run a Dependabot workflow, it will run with the same privileges as before even if the user who initiated the rerun has different privileges. For more information, see "[Re-running workflows and jobs](/actions/managing-workflow-runs/re-running-workflows-and-jobs)."
|
||||
|
||||
{% else %}
|
||||
|
||||
You can also manually re-run a failed Dependabot workflow, and it will run with a read-write token and access to secrets. Before manually re-running a failed workflow, you should always check the dependency being updated to ensure that the change doesn't introduce any malicious or unintended behavior.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Common Dependabot automations
|
||||
|
||||
Here are several common scenarios that can be automated using {% data variables.product.prodname_actions %}.
|
||||
@@ -466,7 +476,8 @@ on: pull_request_target
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
|
||||
pull-requests: write
|
||||
|
||||
jobs:
|
||||
dependabot:
|
||||
runs-on: ubuntu-latest
|
||||
@@ -497,6 +508,7 @@ on: pull_request
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
pull-requests: write
|
||||
|
||||
jobs:
|
||||
dependabot:
|
||||
|
||||
@@ -24,8 +24,16 @@ shortTitle: Push protection
|
||||
|
||||
Up to now, {% data variables.product.prodname_secret_scanning_GHAS %} checks for secrets _after_ a push and alerts users to exposed secrets. {% data reusables.secret-scanning.push-protection-overview %}
|
||||
|
||||
If a contributor bypasses a push protection block for a secret, {% data variables.product.prodname_dotcom %}:
|
||||
- generates an alert.
|
||||
- creates an alert in the "Security" tab of the repository.
|
||||
- adds the bypass event to the audit log.{% ifversion secret-scanning-push-protection-email %}
|
||||
- sends an email alert to organization owners, security managers, and repository administrators, with a link to the related secret and the reason why it was allowed.{% endif %}
|
||||
|
||||
{% data variables.product.prodname_secret_scanning_caps %} as a push protection currently scans repositories for secrets issued by the following service providers.
|
||||
|
||||
{% data reusables.secret-scanning.secret-scanning-pattern-pair-matches %}
|
||||
|
||||
{% data reusables.secret-scanning.secret-list-private-push-protection %}
|
||||
|
||||
## Enabling {% data variables.product.prodname_secret_scanning %} as a push protection
|
||||
@@ -78,6 +86,8 @@ If you confirm a secret is real and that you intend to fix it later, you should
|
||||
|
||||
{% data reusables.secret-scanning.push-protection-allow-secrets-alerts %}
|
||||
|
||||
{% data reusables.secret-scanning.push-protection-allow-email %}
|
||||
|
||||
1. Visit the URL returned by {% data variables.product.prodname_dotcom %} when your push was blocked.
|
||||
|
||||
{% data reusables.secret-scanning.push-protection-choose-allow-secret-options %}
|
||||
@@ -103,6 +113,8 @@ If {% data variables.product.prodname_dotcom %} blocks a secret that you believe
|
||||
|
||||
{% data reusables.secret-scanning.push-protection-allow-secrets-alerts %}
|
||||
|
||||
{% data reusables.secret-scanning.push-protection-allow-email %}
|
||||
|
||||
If you confirm a secret is real and that you intend to fix it later, you should aim to remediate the secret as soon as possible.
|
||||
|
||||
1. In the banner that appeared at the top of the page when {% data variables.product.prodname_dotcom %} blocked your commit, click **Bypass protection**.
|
||||
|
||||
@@ -34,6 +34,8 @@ Organizations using {% data variables.product.prodname_ghe_cloud %} with {% data
|
||||
|
||||
{% data variables.product.product_name %} currently scans public repositories for secrets issued by the following service providers. For more information about {% data variables.product.prodname_secret_scanning_partner %}, see "[About {% data variables.product.prodname_secret_scanning_partner %}](/code-security/secret-scanning/about-secret-scanning#about-secret-scanning-for-partner-patterns)."
|
||||
|
||||
{% data reusables.secret-scanning.secret-scanning-pattern-pair-matches %}
|
||||
|
||||
{% data reusables.secret-scanning.partner-secret-list-public-repo %}
|
||||
{% endif %}
|
||||
|
||||
@@ -42,6 +44,8 @@ Organizations using {% data variables.product.prodname_ghe_cloud %} with {% data
|
||||
|
||||
When {% data variables.product.prodname_secret_scanning_GHAS %} is enabled, {% data variables.product.prodname_dotcom %} scans for secrets issued by the following service providers. {% ifversion ghec %}For more information about {% data variables.product.prodname_secret_scanning_GHAS %}, see "[About {% data variables.product.prodname_secret_scanning_GHAS %}](/code-security/secret-scanning/about-secret-scanning#about-secret-scanning-for-advanced-security)."{% endif %}
|
||||
|
||||
{% data reusables.secret-scanning.secret-scanning-pattern-pair-matches %}
|
||||
|
||||
If you use the REST API for secret scanning, you can use the `Secret type` to report on secrets from specific issuers. For more information, see "[Secret scanning](/enterprise-cloud@latest/rest/secret-scanning)."
|
||||
|
||||
{% ifversion ghes or ghae or ghec %}
|
||||
|
||||
@@ -52,6 +52,8 @@ The dependency review feature becomes available when you enable the dependency g
|
||||
|
||||
The action is available for all {% ifversion fpt or ghec %}public repositories, as well as private {% endif %}repositories that have {% data variables.product.prodname_GH_advanced_security %} enabled.
|
||||
|
||||
{% data reusables.dependency-review.action-enterprise %}
|
||||
|
||||
You can use the {% data variables.product.prodname_dependency_review_action %} in your repository to enforce dependency reviews on your pull requests. The action scans for vulnerable versions of dependencies introduced by package version changes in pull requests, and warns you about the associated security vulnerabilities. This gives you better visibility of what's changing in a pull request, and helps prevent vulnerabilities being added to your repository. For more information, see [`dependency-review-action`](https://github.com/actions/dependency-review-action).
|
||||
|
||||
|
||||
@@ -61,7 +63,7 @@ By default, the {% data variables.product.prodname_dependency_review_action %} c
|
||||
The action uses the Dependency Review REST API to get the diff of dependency changes between the base commit and head commit. You can use the Dependency Review API to get the diff of dependency changes, including vulnerability data, between any two commits on a repository. For more information, see "[Dependency review](/rest/reference/dependency-graph#dependency-review)."
|
||||
|
||||
{% ifversion dependency-review-action-configuration %}
|
||||
You can configure the {% data variables.product.prodname_dependency_review_action %} to better suit your needs. For example, you can specify the severity level that will make the action fail, or set an allow or deny list for licenses to scan. For more information, see "[Configuring dependency review](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review#configuring-the-dependency-review-github-action)."
|
||||
You can configure the {% data variables.product.prodname_dependency_review_action %} to better suit your needs. For example, you can specify the severity level that will make the action fail{% ifversion dependency-review-action-licenses %}, or set an allow or deny list for licenses to scan{% endif %}. For more information, see "[Configuring dependency review](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review#configuring-the-dependency-review-github-action)."
|
||||
{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -56,17 +56,21 @@ topics:
|
||||
|
||||
以下の設定オプションが利用できます。
|
||||
|
||||
| オプション | 必須 | 使い方 |
|
||||
| ------------------ | -- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `fail-on-severity` | 任意 | 重要度(`low`、`moderate`、`high`、`critical`)の閾値を定義します。</br>指定された重要度以上の脆弱性を導入するPull Requestについて、このアクションは失敗します。 |
|
||||
| `allow-licenses` | 任意 | 許可されているライセンスのリストを含みます。 このパラメータで利用できる値は、APIドキュメンテーションの[Licenses](/rest/licenses)ページにあります。</br>このリストにマッチしないライセンスを持つ依存関係を導入するPull Requestについて、このアクションは失敗します。 |
|
||||
| `deny-licenses` | 任意 | 禁じられているライセンスのリストを含みます。 このパラメータで利用できる値は、APIドキュメンテーションの[Licenses](/rest/licenses)ページにあります。</br>このリストにマッチするライセンスを持つ依存関係を導入するPull Requestについて、このアクションは失敗します。 |
|
||||
| オプション | 必須 | 使い方 |
|
||||
| ------------------ | -- | -------------------------------------------------------------------------------------------------------- |
|
||||
| `fail-on-severity` | 任意 | 重要度(`low`、`moderate`、`high`、`critical`)の閾値を定義します。</br>指定された重要度以上の脆弱性を導入するPull Requestについて、このアクションは失敗します。 |
|
||||
{%- ifversion dependency-review-action-licenses %}
|
||||
| `allow-licenses` | Optional | Contains a list of allowed licenses. You can find the possible values for this parameter in the [Licenses](/rest/licenses) page of the API documentation.</br>The action will fail on pull requests that introduce dependencies with licenses that do not match the list.|{% endif %}
|
||||
{%- ifversion dependency-review-action-licenses %}
|
||||
| `deny-licenses` | Optional | Contains a list of prohibited licenses. You can find the possible values for this parameter in the [Licenses](/rest/licenses) page of the API documentation.</br>The action will fail on pull requests that introduce dependencies with licenses that match the list.|{% endif %}
|
||||
|
||||
{% ifversion dependency-review-action-licenses %}
|
||||
{% tip %}
|
||||
|
||||
**参考:** `allow-licenses`及び`deny-licenses`オプションは、相互排他です。
|
||||
|
||||
{% endtip %}
|
||||
{% endif %}
|
||||
|
||||
この{% data variables.product.prodname_dependency_review_action %}のサンプルファイルは、これらの設定オプションの使い方を示しています。
|
||||
|
||||
@@ -86,16 +90,18 @@ jobs:
|
||||
- name: Dependency Review
|
||||
uses: actions/dependency-review-action@v2
|
||||
with:
|
||||
# 取り得る値: "critical", "high", "moderate", "low"
|
||||
# Possible values: "critical", "high", "moderate", "low"
|
||||
fail-on-severity: critical
|
||||
# この2つの選択肢のいずれかだけを含めることができる: `allow-licenses` and `deny-licences`
|
||||
{% ifversion dependency-review-action-licenses %}
|
||||
# You can only can only include one of these two options: `allow-licenses` and `deny-licences`
|
||||
# ([String]). これらのライセンスだけを許可 (オプション)
|
||||
# 取り得る値: https://docs.github.com/en/rest/licensesからの任意の`spdx_id`値
|
||||
# 許可ライセンス: GPL-3.0, BSD-3-Clause, MIT
|
||||
|
||||
# ([String]). これらのライセンスでPull Requestはブロック (オプション)
|
||||
# 取り得る値: https://docs.github.com/en/rest/licensesからの任意の`spdx_id`値
|
||||
# 拒否ライセンス: LGPL-2.0, BSD-2-Clause
|
||||
# ([String]). Block the pull request on these licenses (optional)
|
||||
# Possible values: Any `spdx_id` value(s) from https://docs.github.com/en/rest/licenses
|
||||
# deny-licenses: LGPL-2.0, BSD-2-Clause
|
||||
{% endif %}
|
||||
```
|
||||
|
||||
これらの設定オプションに関する詳細については[`dependency-review-action`](https://github.com/actions/dependency-review-action#readme)を参照してください。
|
||||
|
||||
@@ -20,7 +20,7 @@ shortTitle: 暗号化されたシークレット
|
||||
|
||||
|
||||
|
||||
## About encrypted secrets for {% data variables.product.prodname_github_codespaces %}
|
||||
## {% data variables.product.prodname_github_codespaces %} の暗号化されたシークレットについて
|
||||
|
||||
You can add encrypted secrets to your personal account that you want to use in your codespaces. たとえば、次のような機密情報を暗号化されたシークレットとして保存しアクセスするとよいでしょう。
|
||||
|
||||
@@ -41,7 +41,7 @@ You can add encrypted secrets to your personal account that you want to use in y
|
||||
|
||||
### シークレットの制限
|
||||
|
||||
You can store up to 100 secrets for {% data variables.product.prodname_github_codespaces %}.
|
||||
{% data variables.product.prodname_github_codespaces %} には最大 100 個のシークレットを保存できます。
|
||||
|
||||
シークレットの容量は最大64 KBです。
|
||||
|
||||
@@ -75,6 +75,22 @@ You can store up to 100 secrets for {% data variables.product.prodname_github_co
|
||||
1. [Codespaces secrets] で、削除するシークレットの右にある [**Delete**] をクリックします。 ![[Delete] ボタン](/assets/images/help/settings/codespaces-secret-delete-button.png)
|
||||
1. 警告を読んで、**OK**をクリックしてください。 
|
||||
|
||||
## シークレットを使用する
|
||||
|
||||
A secret is exported as an environment variable into the user's terminal session.
|
||||
|
||||
|
||||
|
||||
You can use secrets in a codespace after the codespace is built and is running. For example, a secret can be used:
|
||||
|
||||
* When launching an application from the integrated terminal or ssh session.
|
||||
* Within a dev container lifecycle script that is run after the codespace is running. For more information about dev container lifecycle scripts, see the documentation on containers.dev: [Specification](https://containers.dev/implementors/json_reference/#lifecycle-scripts).
|
||||
|
||||
Codespace secrets cannot be used during:
|
||||
|
||||
* Codespace build time (that is, within a Dockerfile or custom entry point).
|
||||
* Within a dev container feature. For more information, see the `features` attribute in the documentation on containers.dev: [Specification](https://containers.dev/implementors/json_reference/#general-properties).
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- "[Managing encrypted secrets for your repository and organization for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces)"
|
||||
|
||||
@@ -34,8 +34,8 @@ shortTitle: アカウントからのブロック
|
||||
- リポジトリのコラボレータとして削除されます
|
||||
- そのユーザの、あなたへのスポンサーシップはキャンセルされます
|
||||
- ブロックされたユーザへの、またはブロックされたユーザからの保留中のリポジトリまたはアカウント継承者の招待がキャンセルされます
|
||||
- The user is removed as a collaborator from all the Project Boards & Projects (beta) owned by you
|
||||
- You are removed as a collaborator from all the Project Boards & Projects (beta) owned by the user
|
||||
- The user is removed as a collaborator from all the projects and {% data variables.projects.projects_v1_boards %} owned by you
|
||||
- You are removed as a collaborator from all the projects and {% data variables.projects.projects_v1_boards %} owned by the user
|
||||
|
||||
ユーザをブロックすると、ユーザは以下のことができなくなります:
|
||||
- あなたのユーザ名の [@メンション](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)を含む、あなたへの通知の送信
|
||||
@@ -48,8 +48,8 @@ shortTitle: アカウントからのブロック
|
||||
- あなたのリポジトリをコメント中でクロス参照すること
|
||||
- リポジトリのフォーク、Watch、ピン留め、Star 付け
|
||||
- あなたをスポンサーすること
|
||||
- Add you as a collaborator on their Project Boards & Projects (beta)
|
||||
- Make changes to your public Project Boards & Projects (beta)
|
||||
- Add you as a collaborator on their projects and {% data variables.projects.projects_v1_boards %}
|
||||
- Make changes to your public projects and {% data variables.projects.projects_v1_boards %}
|
||||
|
||||
あなたが所有するリポジトリでは、ブロックされたユーザは以下のこともできなくなります:
|
||||
- Issue のオープン
|
||||
|
||||
@@ -39,45 +39,45 @@ X-Accepted-OAuth-Scopes: user
|
||||
|
||||
## 利用できるスコープ
|
||||
|
||||
| 名前 | 説明 |
|
||||
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion not ghae %}
|
||||
| 名前 | 説明 |
|
||||
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion not ghae %}
|
||||
| **`(スコープなし)`** | パブリックな情報への読み取りのみのアクセスを許可します (ユーザのプロフィール情報、リポジトリの情報、Gist){% endif %}{% ifversion ghes or ghae %}
|
||||
| **`site_admin`** | サイト管理者に[{% data variables.product.prodname_ghe_server %}の管理APIエンドポイント](/rest/reference/enterprise-admin)へのアクセスを許可します。{% endif %}
|
||||
| **`repo`** | プライベートリポジトリを含め、リポジトリへの完全なアクセスを許可します。 これにはコード、コミットのステータス、リポジトリおよびOrganizationのプロジェクト、招待、コラボレータ、Teamのメンバーシップの追加、デプロイメントのステータス、リポジトリとOrganizationのためのリポジトリwebhookが含まれます。 また、ユーザプロジェクトを管理する機能も許可します。 |
|
||||
|  `repo:status` | Grants read/write access to commit statuses in {% ifversion fpt %}public and private{% elsif ghec or ghes %}public, private, and internal{% elsif ghae %}private and internal{% endif %} repositories. このスコープが必要になるのは、コードへのアクセスを許可*することなく*他のユーザあるいはサービスにプライベートリポジトリのコミットステータスへのアクセスを許可したい場合のみです。 |
|
||||
| **`repo`** | Grants full access to public{% ifversion ghec or ghes or ghae %}, internal,{% endif %} and private repositories including read and write access to code, commit statuses, repository invitations, collaborators, deployment statuses, and repository webhooks. **Note**: In addition to repository related resources, the `repo` scope also grants access to manage organization-owned resources including projects, invitations, team memberships and webhooks. This scope also grants the ability to manage projects owned by users. |
|
||||
|  `repo:status` | Grants read/write access to commit statuses in {% ifversion fpt %}public and private{% elsif ghec or ghes %}public, private, and internal{% elsif ghae %}private and internal{% endif %} repositories. このスコープが必要になるのは、コードへのアクセスを許可*することなく*他のユーザあるいはサービスにプライベートリポジトリのコミットステータスへのアクセスを許可したい場合のみです。 |
|
||||
|  `repo_deployment` | [デプロイメントステータス](/rest/reference/repos#deployments) for {% ifversion not ghae %}パブリック{% else %}内部{% endif %}およびプライベートリポジトリへのアクセスを許可します。 このスコープが必要になるのは、コードへのアクセスを許可*することなく*デプロイメントステータスへのアクセスをユーザまたはサービスに許可する場合のみです。{% ifversion not ghae %}
|
||||
|  `public_repo` | アクセスをパブリックリポジトリのみに制限します。 これには、コード、コミットステータス、リポジトリプロジェクト、コラボレータ、パブリックリポジトリ及びOrganizationのデプロイメントステータスへの読み書きアクセスが含まれます。 パブリックリポジトリにStarを付けるためにも必要です。{% endif %}
|
||||
|  `repo:invite` | リポジトリでのコラボレーションへの招待の承認／拒否を許可します。 このスコープが必要になるのは、コードへのアクセスを許可*することなく*他のユーザまたはサービスに招待へのアクセスを許可する場合のみです。{% ifversion fpt or ghes or ghec %}
|
||||
|  `security_events` | Grants: <br/> read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/rest/reference/code-scanning) {%- ifversion ghec %}<br/> read and write access to security events in the [{% data variables.product.prodname_secret_scanning %} API](/rest/reference/secret-scanning){%- endif %} <br/> This scope is only necessary to grant other users or services access to security events *without* granting access to the code.{% endif %}
|
||||
| **`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in {% ifversion fpt %}public or private{% elsif ghec or ghes %}public, private, or internal{% elsif ghae %}private or internal{% endif %} repositories. `repo`{% ifversion fpt or ghec or ghes %}および`public_repo`スコープは、{% else %}{% endif %}リポジトリフックを含むリポジトリへの完全なアクセスを許可します。 アクセスをリポジトリフックのみに限定するには、`admin:repo_hook`スコープを使ってください。 |
|
||||
|  `write:repo_hook` | Grants read, write, and ping access to hooks in {% ifversion fpt %}public or private{% elsif ghec or ghes %}public, private, or internal{% elsif ghae %}private or internal{% endif %} repositories. |
|
||||
|  `read:repo_hook` | Grants read and ping access to hooks in {% ifversion fpt %}public or private{% elsif ghec or ghes %}public, private, or internal{% elsif ghae %}private or internal{% endif %} repositories. |
|
||||
| **`admin:org`** | OrganizationとそのTeam、プロジェクト、メンバーシップを完全に管理できます。 |
|
||||
|  `write:org` | Organizationのメンバーシップ、Organizationのプロジェクト、Teamのメンバーシップへの読み書きアクセス。 |
|
||||
|  `read:org` | Organizationのメンバーシップ、Organizationのプロジェクト、Teamのメンバーシップへの読み取りのみのアクセス。 |
|
||||
| **`admin:public_key`** | 公開鍵を完全に管理できます。 |
|
||||
|  `write:public_key` | 公開鍵の作成、リスト、詳細の表示。 |
|
||||
|  `read:public_key` | 公開鍵のリストと詳細の表示。 |
|
||||
| **`admin:org_hook`** | Organizationフックへの読み書き、ping、削除アクセスを許可します。 **ノート:** OAuthトークンがこれらのアクションを行えるのは、OAuth Appが作成したOrganizationフックに対してのみです。 個人アクセストークンがこれらのアクションを行えるのは、ユーザが作成したOrganizationフックに対してのみです。 |
|
||||
| **`gist`** | Gistへの書き込みアクセスを許可します。 |
|
||||
| **`notifications`** | 許可するアクセス: <br/>* ユーザの通知に対する読み取りアクセス<br/>* スレッドへの既読アクセス<br/>* リポジトリへのWatch及びWatch解除のアクセス<br/>* スレッドのサブスクリプションに対する読み書き及び削除アクセス。 |
|
||||
| **`ユーザ`** | プロフィール情報にのみ読み書きアクセスを許可します。 このスコープには`user:email`と`user:follow`が含まれることに注意してください。 |
|
||||
|  `read:user` | ユーザのプロフィールデータへの読み取りアクセスを許可します。 |
|
||||
|  `user:email` | ユーザのメールアドレスへの読み取りアクセスを許可します。 |
|
||||
| **`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in {% ifversion fpt %}public or private{% elsif ghec or ghes %}public, private, or internal{% elsif ghae %}private or internal{% endif %} repositories. `repo`{% ifversion fpt or ghec or ghes %}および`public_repo`スコープは、{% else %}{% endif %}リポジトリフックを含むリポジトリへの完全なアクセスを許可します。 アクセスをリポジトリフックのみに限定するには、`admin:repo_hook`スコープを使ってください。 |
|
||||
|  `write:repo_hook` | Grants read, write, and ping access to hooks in {% ifversion fpt %}public or private{% elsif ghec or ghes %}public, private, or internal{% elsif ghae %}private or internal{% endif %} repositories. |
|
||||
|  `read:repo_hook` | Grants read and ping access to hooks in {% ifversion fpt %}public or private{% elsif ghec or ghes %}public, private, or internal{% elsif ghae %}private or internal{% endif %} repositories. |
|
||||
| **`admin:org`** | OrganizationとそのTeam、プロジェクト、メンバーシップを完全に管理できます。 |
|
||||
|  `write:org` | Organizationのメンバーシップ、Organizationのプロジェクト、Teamのメンバーシップへの読み書きアクセス。 |
|
||||
|  `read:org` | Organizationのメンバーシップ、Organizationのプロジェクト、Teamのメンバーシップへの読み取りのみのアクセス。 |
|
||||
| **`admin:public_key`** | 公開鍵を完全に管理できます。 |
|
||||
|  `write:public_key` | 公開鍵の作成、リスト、詳細の表示。 |
|
||||
|  `read:public_key` | 公開鍵のリストと詳細の表示。 |
|
||||
| **`admin:org_hook`** | Organizationフックへの読み書き、ping、削除アクセスを許可します。 **ノート:** OAuthトークンがこれらのアクションを行えるのは、OAuth Appが作成したOrganizationフックに対してのみです。 個人アクセストークンがこれらのアクションを行えるのは、ユーザが作成したOrganizationフックに対してのみです。 |
|
||||
| **`gist`** | Gistへの書き込みアクセスを許可します。 |
|
||||
| **`notifications`** | 許可するアクセス: <br/>* ユーザの通知に対する読み取りアクセス<br/>* スレッドへの既読アクセス<br/>* リポジトリへのWatch及びWatch解除のアクセス<br/>* スレッドのサブスクリプションに対する読み書き及び削除アクセス。 |
|
||||
| **`ユーザ`** | プロフィール情報にのみ読み書きアクセスを許可します。 このスコープには`user:email`と`user:follow`が含まれることに注意してください。 |
|
||||
|  `read:user` | ユーザのプロフィールデータへの読み取りアクセスを許可します。 |
|
||||
|  `user:email` | ユーザのメールアドレスへの読み取りアクセスを許可します。 |
|
||||
|  `user:follow` | Grants access to follow or unfollow other users.{% ifversion projects-oauth-scope %}
|
||||
| **`project`** | Grants read/write access to user and organization projects (beta). |
|
||||
|  `read:project` | Grants read only access to user and organization projects (beta).{% endif %}
|
||||
| **`delete_repo`** | 管理可能なリポジトリの削除アクセスを許可します。 |
|
||||
| **`write:discussion`** | Teamのディスカッションの読み書きアクセスを許可します。 |
|
||||
|  `read:discussion` | Allows read access for team discussions. |
|
||||
| **`write:packages`** | {% data variables.product.prodname_registry %}でのパッケージのアップロードあるいは公開のアクセスを許可します。 詳しい情報については「[パッケージの公開](/github/managing-packages-with-github-packages/publishing-a-package)」を参照してください。 |
|
||||
| **`read:packages`** | {% data variables.product.prodname_registry %}からのパッケージのダウンロードあるいはインストールのアクセスを許可します。 詳しい情報については「[パッケージのインストール](/github/managing-packages-with-github-packages/installing-a-package)」を参照してください。 |
|
||||
| **`delete:packages`** | {% data variables.product.prodname_registry %}からのパッケージの削除アクセスを許可します。 詳しい情報については、「[パッケージの削除とリストア](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。 |
|
||||
| **`admin:gpg_key`** | GPGキーを完全に管理できます。 |
|
||||
|  `write:gpg_key` | GPGキーの作成、リスト、詳細の表示ができます。 |
|
||||
| **`project`** | Grants read/write access to user and organization {% data variables.projects.projects_v2 %}. |
|
||||
|  `read:project` | Grants read only access to user and organization {% data variables.projects.projects_v2 %}.{% endif %}
|
||||
| **`delete_repo`** | 管理可能なリポジトリの削除アクセスを許可します。 |
|
||||
| **`write:discussion`** | Teamのディスカッションの読み書きアクセスを許可します。 |
|
||||
|  `read:discussion` | Allows read access for team discussions. |
|
||||
| **`write:packages`** | {% data variables.product.prodname_registry %}でのパッケージのアップロードあるいは公開のアクセスを許可します。 詳しい情報については「[パッケージの公開](/github/managing-packages-with-github-packages/publishing-a-package)」を参照してください。 |
|
||||
| **`read:packages`** | {% data variables.product.prodname_registry %}からのパッケージのダウンロードあるいはインストールのアクセスを許可します。 詳しい情報については「[パッケージのインストール](/github/managing-packages-with-github-packages/installing-a-package)」を参照してください。 |
|
||||
| **`delete:packages`** | {% data variables.product.prodname_registry %}からのパッケージの削除アクセスを許可します。 詳しい情報については、「[パッケージの削除とリストア](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。 |
|
||||
| **`admin:gpg_key`** | GPGキーを完全に管理できます。 |
|
||||
|  `write:gpg_key` | GPGキーの作成、リスト、詳細の表示ができます。 |
|
||||
|  `read:gpg_key` | GPGキーのリストと詳細を表示できます。{% ifversion fpt or ghec %}
|
||||
| **`codespace`** | Grants the ability to create and manage codespaces. Codespaces can expose a GITHUB_TOKEN which may have a different set of scopes. For more information, see "[Security in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/security-in-github-codespaces#authentication)."{% endif %}
|
||||
| **`ワークフロー`** | {% data variables.product.prodname_actions %}のワークフローファイルの追加と更新機能を許可します。 同じリポジトリ内の他のブランチに同じファイル（パスと内容が同じ）が存在する場合、ワークフローファイルはこのスコープがなくてもコミットできます。 ワークフローファイルは、異なるスコープのセットを持ちうる`GITHUB_TOKEN`を公開できます。 詳しい情報については、「[ワークフローでの認証](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)」を参照してください。 |
|
||||
| **`ワークフロー`** | {% data variables.product.prodname_actions %}のワークフローファイルの追加と更新機能を許可します。 同じリポジトリ内の他のブランチに同じファイル（パスと内容が同じ）が存在する場合、ワークフローファイルはこのスコープがなくてもコミットできます。 ワークフローファイルは、異なるスコープのセットを持ちうる`GITHUB_TOKEN`を公開できます。 詳しい情報については、「[ワークフローでの認証](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)」を参照してください。 |
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -892,10 +892,10 @@ GitHub Marketplace の購入に関連するアクティビティ。 {% data reus
|
||||
- Organization webhook
|
||||
- `repository_projects` または `organization_projects` 権限のある {% data variables.product.prodname_github_apps %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
{% ifversion projects-v2 %}
|
||||
{% note %}
|
||||
|
||||
**Note**: This event does not occur for Projects (beta).
|
||||
**Note**: This event only occurs for {% data variables.product.prodname_projects_v1 %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
@@ -924,10 +924,10 @@ GitHub Marketplace の購入に関連するアクティビティ。 {% data reus
|
||||
- Organization webhook
|
||||
- `repository_projects` または `organization_projects` 権限のある {% data variables.product.prodname_github_apps %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
{% ifversion projects-v2 %}
|
||||
{% note %}
|
||||
|
||||
**Note**: This event does not occur for Projects (beta).
|
||||
**Note**: This event only occurs for {% data variables.product.prodname_projects_v1 %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
@@ -954,6 +954,14 @@ GitHub Marketplace の購入に関連するアクティビティ。 {% data reus
|
||||
- Organization webhook
|
||||
- `repository_projects` または `organization_projects` 権限のある {% data variables.product.prodname_github_apps %}
|
||||
|
||||
{% ifversion projects-v2 %}
|
||||
{% note %}
|
||||
|
||||
**Note**: This event only occurs for {% data variables.product.prodname_projects_v1 %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
### webhook ペイロードオブジェクト
|
||||
|
||||
{% data reusables.webhooks.project_column_properties %}
|
||||
@@ -972,11 +980,11 @@ GitHub Marketplace の購入に関連するアクティビティ。 {% data reus
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Webhook events for Projects (beta) are currently in beta and subject to change. To share feedback about Projects (beta) webhooks with {% data variables.product.product_name %}, see the [Projects (beta) webhook feedback discussion](https://github.com/github/feedback/discussions/17405).
|
||||
**ノート:** {% data variables.projects.projects_v2 %}のwebhookイベントは現在ベータであり、変更されることがあります。 To share feedback about {% data variables.projects.projects_v2 %} webhooks with {% data variables.product.product_name %}, see the [Projects webhook feedback discussion](https://github.com/github/feedback/discussions/17405).
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Activity related to items in a Projects (beta) project. {% data reusables.webhooks.action_type_desc %} For more information, see "[About projects (beta)](/issues/trying-out-the-new-projects-experience/about-projects)."
|
||||
Activity related to items in a {% data variables.projects.project_v2 %}. {% data reusables.webhooks.action_type_desc %} For more information, see "[About {% data variables.projects.projects_v2 %}](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)."
|
||||
|
||||
### 利用の可否
|
||||
|
||||
@@ -985,11 +993,11 @@ Activity related to items in a Projects (beta) project. {% data reusables.webhoo
|
||||
|
||||
### webhook ペイロードオブジェクト
|
||||
|
||||
| キー | 種類 | 説明 |
|
||||
| ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `action` | `string` | The action that was performed on the project item. Can be one of `archived`, `converted`, `created`, `edited`, `restored`, `deleted`, or `reordered`. |
|
||||
| `projects_v2_item` | `オブジェクト` | The project item itself. To find more information about the project item, you can use `node_id` (the node ID of the project item) and `project_node_id` (the node ID of the project) to query information in the GraphQL API. For more information, see "[Using the API to manage projects (beta)](/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects)." |
|
||||
| `changes` | `オブジェクト` | The changes to the project item. |
|
||||
| キー | 種類 | 説明 |
|
||||
| ------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `action` | `string` | The action that was performed on the project item. Can be one of `archived`, `converted`, `created`, `edited`, `restored`, `deleted`, or `reordered`. |
|
||||
| `projects_v2_item` | `オブジェクト` | The project item itself. To find more information about the project item, you can use `node_id` (the node ID of the project item) and `project_node_id` (the node ID of the project) to query information in the GraphQL API. For more information, see "[Using the API to manage projects](/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)." |
|
||||
| `changes` | `オブジェクト` | The changes to the project item. |
|
||||
{% data reusables.webhooks.org_desc %}
|
||||
{% data reusables.webhooks.app_desc %}
|
||||
{% data reusables.webhooks.sender_desc %}
|
||||
@@ -1320,7 +1328,7 @@ Activity related to items in a Projects (beta) project. {% data reusables.webhoo
|
||||
|
||||
Activity related to a security advisory that has been reviewed by {% data variables.product.company_short %}. A {% data variables.product.company_short %}-reviewed security advisory provides information about security-related vulnerabilities in software on {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
The security advisory dataset also powers the GitHub {% data variables.product.prodname_dependabot_alerts %}. 詳しい情報については、「[{% data variables.product.prodname_dependabot_alerts %} について](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/)」を参照してください。
|
||||
The security advisory dataset also powers the GitHub {% data variables.product.prodname_dependabot_alerts %}. 詳しい情報については「[{% data variables.product.prodname_dependabot_alerts %}について](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/)」を参照してください。
|
||||
|
||||
### 利用の可否
|
||||
|
||||
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
title: Getting started with GitHub Community Exchange
|
||||
shortTitle: 始めましょう！
|
||||
intro: 'Learn how to access {% data variables.product.prodname_community_exchange %} and submit your repository.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
---
|
||||
|
||||
## はじめに
|
||||
|
||||
{% data reusables.education.about-github-community-exchange-intro %} {% data variables.product.prodname_community_exchange %} can help you make your first open source contribution or grow your own open source project.
|
||||
|
||||
For more information about how {% data variables.product.prodname_community_exchange %} can help you as a student, see "[About {% data variables.product.prodname_community_exchange %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-community-exchange)."
|
||||
|
||||
## Accessing {% data variables.product.prodname_community_exchange %}
|
||||
|
||||
{% data reusables.education.access-github-community-exchange %}
|
||||
|
||||
## Finding interesting repositories
|
||||
|
||||
You can browse repositories submitted to {% data variables.product.prodname_community_exchange %} from the gallery page.
|
||||
|
||||
As you think about what open source repositories may be interesting, consider if you're wanting to learn or collaborate, or if there are particular topics or languages that could be a good starting point.
|
||||
|
||||
When exploring repositories in the {% data variables.product.prodname_community_exchange %} gallery, you can filter available repositories by purpose, topics, or languages, and search for repositories by name and description. You can sort the list of repositories in the gallery by submission date, or by the number of stars, forks, or issues a repository has.
|
||||
|
||||
|
||||
|
||||
## Starring repositories
|
||||
|
||||
You can star repositories listed in the {% data variables.product.prodname_community_exchange %} gallery. Starring makes it easy to find a repository in the gallery again later. リポジトリに Star を付けるということは、リポジトリメンテナに対してその作業についての感謝を示すことでもあります。
|
||||
|
||||
Repository listings in the {% data variables.product.prodname_community_exchange %} gallery can be sorted on the number of stars a repository has.
|
||||
|
||||
To star a repository: Go to your {% data variables.product.prodname_community_exchange %} home page, find the repository you want to star, and click {% octicon "star" aria-label="The star icon" %} **Star** button found right by its name.
|
||||
|
||||
## Reporting abuse
|
||||
|
||||
The {% data variables.product.prodname_community_exchange %} community moderates repository submissions. You can report abusive repositories, spammy, or disruptive content at any time.
|
||||
|
||||
To report an abusive repository: Go to your {% data variables.product.prodname_community_exchange %} home page, find the repository you want to report, click the {% octicon "kebab-horizontal" aria-label="The edit icon" %} drop-down right by its name, then click {% octicon "report" aria-label="The report symbol" %} **Report abuse**.
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- 「[{% data variables.product.prodname_community_exchange %} について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-community-exchange)」
|
||||
@@ -0,0 +1,12 @@
|
||||
---
|
||||
title: Contribute with GitHub Community Exchange
|
||||
shortTitle: '{% data variables.product.prodname_community_exchange %}'
|
||||
intro: 'With {% data variables.product.prodname_community_exchange %}, you can use {% data variables.product.product_name %} to contribute to open source and build your portfolio.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
children:
|
||||
- /getting-started-with-github-community-exchange
|
||||
- /submitting-your-repository-to-github-community-exchange
|
||||
- /managing-your-submissions-to-github-community-exchange
|
||||
---
|
||||
|
||||
@@ -0,0 +1,24 @@
|
||||
---
|
||||
title: Managing your submissions to GitHub Community Exchange
|
||||
shortTitle: Manage your submissions
|
||||
intro: 'You can manage the purpose, topics, and offers assigned to each of your repositories in the {% data variables.product.prodname_community_exchange %} gallery, or delete your repository submissions.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
---
|
||||
|
||||
## About your submissions
|
||||
|
||||
During the {% data variables.product.prodname_community_exchange %} submission process, you will choose a purpose, topics, and offers for your repository. Once a repository has been submitted to {% data variables.product.prodname_community_exchange %}, it will be published with these details. For more information, see "[Submitting your repository to GitHub Community Exchange](/education/contribute-with-github-community-exchange/submitting-your-repository-to-github-community-exchange)."
|
||||
|
||||
After you've submitted, you can still edit the topics and offers associated with your repository. You can also update the purpose of your repository by changing the corresponding topic(s). 詳細は「[トピックでリポジトリを分類する](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics)」を参照してください。
|
||||
|
||||
The language associated with your repository is the primary language used and is automatically determined by {% data variables.product.prodname_dotcom %}. For more information, see "[About repository languages](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-repository-languages)."
|
||||
|
||||
The {% data variables.product.prodname_community_exchange %} community moderates all repository submissions.
|
||||
|
||||
## Managing your submissions
|
||||
|
||||
1. From your {% data variables.product.prodname_global_campus %} dashboard, navigate to the {% data variables.product.prodname_community_exchange %} home page.
|
||||
1. Above the list of repositories, click the **Submissions** tab. 
|
||||
1. Optionally, edit your submitted repository. To the right of the repository you want to edit, click {% octicon "pencil" aria-label="The edit icon" %} to go directly to your repository homepage. From there, you can update the purpose, topics, and offers assigned to your repository.
|
||||
1. Optionally, delete a submitted repository from the gallery. To the right of the repository submission you want to remove, click {% octicon "trash" aria-label="The trash icon" %}.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: Submitting your repository to GitHub Community Exchange
|
||||
shortTitle: Submit your repository
|
||||
intro: 'You can submit your repository to {% data variables.product.prodname_community_exchange %} for others to view or contribute to.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
---
|
||||
|
||||
## About repository submissions
|
||||
|
||||
Only public repositories owned by personal accounts can be submitted to {% data variables.product.prodname_community_exchange %}.
|
||||
|
||||
There are three types of repository submissions:
|
||||
|
||||
- **Learn.** A repository to share step-by-step instructions to build a project.
|
||||
- **Collaborate.** A repository seeking collaborators to work on a project.
|
||||
- **Learn and Collaborate.** A repository which is a combination of `Learn` and `Collaborate`.
|
||||
|
||||
Consider what the main purpose of your repository is when choosing the type of submission for your repository.
|
||||
|
||||
To promote your project and make it more discoverable to other students, you should assign one or more topics and {% data variables.product.prodname_student_pack %} offers to your repository. 詳細は「[トピックでリポジトリを分類する](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics)」を参照してください。
|
||||
|
||||
Once a repository has been submitted to {% data variables.product.prodname_community_exchange %}, it will be published immediately with the purpose, topics, and offers you've chosen. The {% data variables.product.prodname_community_exchange %} community moderates all repository submissions.
|
||||
|
||||
### Submission requirements
|
||||
|
||||
Your repository must meet a minimum set of requirements for a submission to be accepted. During the submission process, if the submission criteria hasn't been met for your selected repository, you will be notified of the missing items.
|
||||
|
||||
For a submission with a purpose of `Learn`, your repository must have:
|
||||
- A description.
|
||||
- A LEARN.md file to provide step-by-step instructions, with text and/or media, on how you built your project. Ideally, your LEARN.md file will deconstruct your project into small components and provide thorough details of each step, so that other students can code their project by following your instructions.
|
||||
- A README.md file to provide a detailed description of your project.
|
||||
|
||||
For a submission with a purpose of `Collaborate`, your repository must have:
|
||||
- A description.
|
||||
- A README.md file to provide a detailed description of your project.
|
||||
- One or more issues for collaborators to work on.
|
||||
|
||||
A good repository submission for both `Learn` and `Collaborate` purposes, is a repository that follows community standards. For more information, see "[About community profiles for public repositories](/communities/setting-up-your-project-for-healthy-contributions/about-community-profiles-for-public-repositories)."
|
||||
|
||||
## Submitting your repository
|
||||
|
||||
1. From your {% data variables.product.prodname_global_campus %} dashboard, navigate to the {% data variables.product.prodname_community_exchange %} home page.
|
||||
1. Above the list of repositories, to the right of the search and dropdown filters, click **Add repository**. 
|
||||
1. Use the **What is the purpose of your submission?** drop-down menu and select one or more entries matching your submission. 
|
||||
1. Use the **Which repository would you like to use?** drop-down menu and select the repository for your submission. If the submission criteria hasn't been met, you will be notified of the missing items. 
|
||||
1. Use the **Which offers did you use for your project?** drop-down menu and select one or more entries matching your submission. 
|
||||
1. Click **Submit the project**.
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
title: About GitHub Community Exchange
|
||||
intro: 'As a student, learn the skills you need to contribute to open source projects and grow your own portfolio, with {% data variables.product.prodname_community_exchange %}.'
|
||||
intro: 'Learn the skills you need to contribute to open source projects and grow your own portfolio, with {% data variables.product.prodname_community_exchange %}.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
shortTitle: Community Exchange
|
||||
shortTitle: About Community Exchange
|
||||
---
|
||||
|
||||
## {% data variables.product.prodname_community_exchange %}について
|
||||
|
||||
{% data variables.product.prodname_community_exchange %} is a student community within the {% data variables.product.prodname_global_campus %} portal. As a student, it's a place where you can get exposure for your project and discover other student repositories in need of collaborators and maintainers.
|
||||
{% data reusables.education.about-github-community-exchange-intro %}
|
||||
|
||||
|
||||
|
||||
@@ -21,10 +21,10 @@ You can help your peers learn open source skills, become a project maintainer, a
|
||||
- Submit a repository to teach new skills
|
||||
- Manage your repository submissions
|
||||
|
||||
To access {% data variables.product.prodname_community_exchange %}, visit your {% data variables.product.prodname_global_campus %} dashboard at https://education.github.com.
|
||||
For more information, see "[Contribute with GitHub Community Exchange](/education/contribute-with-github-community-exchange)."
|
||||
|
||||
If you're a student or faculty member at an accredited educational institution, you can apply for {% data variables.product.prodname_education %} benefits, which includes access to {% data variables.product.prodname_community_exchange %} within {% data variables.product.prodname_global_campus %}.
|
||||
{% data reusables.education.access-github-community-exchange %}
|
||||
|
||||
- If you’re a student and you haven't joined {% data variables.product.prodname_education %} yet, apply using the [student application form](https://education.github.com/discount_requests/student_application). For more information, see "[About GitHub Education for students](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-education-for-students)."
|
||||
## 参考リンク
|
||||
|
||||
- If you’re an educator and you haven't joined {% data variables.product.prodname_education %} yet, apply using the [teacher application form](https://education.github.com/discount_requests/teacher_application). For more information, see "[About GitHub Education for educators](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-in-your-classroom-and-research/apply-for-an-educator-or-researcher-discount)."
|
||||
- 「[{% data variables.product.prodname_community_exchange %} を使ってみる](/education/contribute-with-github-community-exchange/getting-started-with-github-community-exchange)」
|
||||
|
||||
@@ -46,3 +46,5 @@ shortTitle: ガイド
|
||||
- [{% data variables.product.prodname_education_community %}]({% data variables.product.prodname_education_forum_link %})
|
||||
- [Campus Expertsについて](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-campus-experts)
|
||||
- [Campus Advisorsについて](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-campus-advisors)
|
||||
- [{% data variables.product.prodname_community_exchange %}について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-community-exchange)
|
||||
- [Contribute with GitHub Community Exchange](/education/contribute-with-github-community-exchange)
|
||||
|
||||
@@ -27,6 +27,7 @@ versions:
|
||||
children:
|
||||
- /quickstart
|
||||
- /explore-the-benefits-of-teaching-and-learning-with-github-education
|
||||
- /contribute-with-github-community-exchange
|
||||
- /manage-coursework-with-github-classroom
|
||||
- /guides
|
||||
---
|
||||
|
||||
@@ -26,7 +26,17 @@ This tutorial uses [the Spoon-Knife project](https://github.com/octocat/Spoon-Kn
|
||||
|
||||
1. Navigate to the `Spoon-Knife` project at https://github.com/octocat/Spoon-Knife.
|
||||
2. Click **Fork**. ![[Fork] ボタン](/assets/images/help/repository/fork_button.png)
|
||||
1. {% data variables.product.product_name %} will take you to your copy (your fork) of the Spoon-Knife repository.
|
||||
3. Select an owner for the forked repository. 
|
||||
4. By default, forks are named the same as their parent repositories. You can change the name of the fork to distinguish it further. 
|
||||
5. Optionally, add a description of your fork. 
|
||||
6. Choose whether to copy only the default branch or all branches to the new fork. For many forking scenarios, such as contributing to open-source projects, you only need to copy the default branch. By default, only the default branch is copied. 
|
||||
7. Click **Create fork**. 
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** If you want to copy additional branches from the parent repository, you can do so from the **Branches** page. 詳しい情報については[リポジトリ内でのブランチの作成と削除](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository)を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Cloning a fork
|
||||
|
||||
|
||||
@@ -57,7 +57,17 @@ If you have not yet, you should first [set up Git](/articles/set-up-git). [Git
|
||||
上流または元のリポジトリへの変更を提案するために、プロジェクトをフォークする場合があります。 この場合、自分のフォークを上流のリポジトリと定期的に同期させるとよいでしょう。 これには、コマンドラインで Git を使用する必要があります。 先程フォークした同じ [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) リポジトリを使用して、上流リポジトリの設定を練習できます。
|
||||
|
||||
1. On {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom_the_website %}{% else %}{% data variables.product.product_location %}{% endif %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository.
|
||||
2. ページの右上にある [**Fork**] をクリックします。 ![[Fork] ボタン](/assets/images/help/repository/fork_button.png)
|
||||
2. In the top-right corner of the page, click **Fork**. ![[Fork] ボタン](/assets/images/help/repository/fork_button.png)
|
||||
3. Select an owner for the forked repository. 
|
||||
4. By default, forks are named the same as their parent repositories. You can change the name of the fork to distinguish it further. 
|
||||
5. Optionally, add a description of your fork. 
|
||||
6. Choose whether to copy only the default branch or all branches to the new fork. For many forking scenarios, such as contributing to open-source projects, you only need to copy the default branch. By default, only the default branch is copied. 
|
||||
7. Click **Create fork**. 
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** If you want to copy additional branches from the parent repository, you can do so from the **Branches** page. For more information, see "[Creating and deleting branches within your repository](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository)."{% endnote %}
|
||||
|
||||
{% endwebui %}
|
||||
|
||||
|
||||
@@ -39,8 +39,8 @@ When you open the command palette, it shows your location at the top left and us
|
||||
{% note %}
|
||||
|
||||
**ノート:**
|
||||
- If you are editing Markdown text, open the command palette with <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>K</kbd> (Windows and Linux) or <kbd>Command</kbd>+<kbd>Option</kbd>+<kbd>K</kbd> (Mac).
|
||||
- If you are working on a project (beta), a project-specific command palette is displayed instead. 詳しい情報については「[プロジェクト（ベータ）のビューのカスタマイズ](/issues/trying-out-the-new-projects-experience/customizing-your-project-views)」を参照してください。
|
||||
- If you are editing Markdown text, open the command palette with <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>K</kbd> (Windows and Linux) or <kbd>Command</kbd>+<kbd>Option</kbd>+<kbd>K</kbd> (Mac).{% ifversion projects-v2 %}
|
||||
- If you are working on a {% data variables.projects.project_v2 %}, a project-specific command palette is displayed instead. For more information, see "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)."{% endif %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -151,7 +151,7 @@ These commands are available from all scopes.
|
||||
| `Import repository` | Create a new repository by importing a project from another version control system. For more information, see "[Importing a repository with GitHub importer](/get-started/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer)." |
|
||||
| `New gist` | Open a new gist. For more information, see "[Creating a gist](/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)." |
|
||||
| `New organization` | Create a new organization. 詳しい情報については、「[新しい Organization をゼロから作成する](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)」を参照してください。 |
|
||||
| `新規プロジェクト` | Create a new project board. For more information, see "[Creating a project](/issues/trying-out-the-new-projects-experience/creating-a-project)." |
|
||||
| `新規プロジェクト` | Create a new project board. For more information, see "[Creating a project](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)." |
|
||||
| `New repository` | Create a new repository from scratch. 詳しい情報については「[新しいリポジトリの作成](/repositories/creating-and-managing-repositories/creating-a-new-repository)」を参照してください。 |
|
||||
| `Switch theme to <theme name>` | Change directly to a different theme for the UI. For more information, see "[Managing your theme settings](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-theme-settings)." |
|
||||
|
||||
|
||||
@@ -146,7 +146,34 @@ The {% data variables.product.prodname_command_palette %} also gives you quick a
|
||||
| <kbd>Alt</kbd> およびクリック | Toggle between collapsing and expanding all outdated review comments in a pull request by holding down <kbd>Alt</kbd> and clicking **Show outdated** or **Hide outdated**. |
|
||||
| Click, then <kbd>Shift</kbd> and click | Comment on multiple lines of a pull request by clicking a line number, holding <kbd>Shift</kbd>, then clicking another line number. 詳しい情報については、「[プルリクエストへコメントする](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)」を参照してください。 |
|
||||
|
||||
## プロジェクトボード
|
||||
{% ifversion projects-v2 %}
|
||||
|
||||
## {% data variables.projects.projects_v2_caps %}
|
||||
|
||||
### Navigating a project
|
||||
|
||||
| キーボードショートカット | 説明 |
|
||||
| ------------------------------------------------------------------------------- | ---------------------------- |
|
||||
| <kbd>⌘</kbd>+<kbd>f</kbd> (Mac) or <kbd>Ctrl</kbd>+<kbd>f</kbd> (Windows/Linux) | Focus filter field |
|
||||
| <kbd>←</kbd> | Move cell focus to the left |
|
||||
| <kbd>→</kbd> | Move cell focus to the right |
|
||||
| <kbd>↑</kbd> | Move cell focus up |
|
||||
| <kbd>↓</kbd> | Move cell focus down |
|
||||
|
||||
### Manipulating a project
|
||||
|
||||
| キーボードショートカット | 説明 |
|
||||
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
|
||||
| <kbd>Enter</kbd> | Toggle edit mode for the focused cell |
|
||||
| <kbd>Escape</kbd> | Cancel editing for the focused cell |
|
||||
| <kbd>⌘</kbd>+<kbd>Shift</kbd>+<kbd>\</kbd> (Mac) or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>\</kbd> (Windows/Linux) | Open row actions menu |
|
||||
| <kbd>Shift</kbd>+<kbd>Space</kbd> | アイテムを選択 |
|
||||
| <kbd>Space</kbd> | Open selected item |
|
||||
| <kbd>e</kbd> | Archive selected items |
|
||||
|
||||
{% endif %}
|
||||
|
||||
## {% data variables.product.prodname_projects_v1_caps %}
|
||||
|
||||
### 列を移動する
|
||||
|
||||
@@ -203,8 +230,8 @@ The {% data variables.product.prodname_command_palette %} also gives you quick a
|
||||
|
||||
| キーボードショートカット | 説明 |
|
||||
| ----------------------------- | ------------ |
|
||||
| <kbd>E</kbd> | 完了済としてマークします |
|
||||
| <kbd>Shift</kbd>+<kbd>U</kbd> | 未読としてマークします |
|
||||
| <kbd>E</kbd> | 完了としてマーク |
|
||||
| <kbd>Shift</kbd>+<kbd>U</kbd> | 未読としてマーク |
|
||||
| <kbd>Shift</kbd>+<kbd>I</kbd> | 既読としてマーク |
|
||||
| <kbd>Shift</kbd>+<kbd>M</kbd> | サブスクライブ解除します |
|
||||
|
||||
|
||||
@@ -16,11 +16,7 @@ topics:
|
||||
- Pull requests
|
||||
---
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning:** If you attach a file to a pull request or issue comment, anyone can view the anonymized URL without authentication, even if the pull request is in a private repository{% ifversion ghes %}, or if private mode is enabled{% endif %}. To keep sensitive media files private, serve them from a private network or server that requires authentication. {% ifversion fpt or ghec %}For more information on anonymized URLs see "[About anonymized URLs](/github/authenticating-to-github/about-anonymized-urls)".{% endif %}
|
||||
|
||||
{% endwarning %}
|
||||
{% data reusables.repositories.anyone-can-view-anonymized-url %}
|
||||
|
||||
Issue やプルリクエストの会話にファイルを添付するには、コメントボックスにファイルをドラッグアンドドロップします。 または、コメントボックスの下部にあるバーをクリックしてコンピュータからファイルを参照、選択、追加することもできます。
|
||||
|
||||
|
||||
@@ -45,6 +45,15 @@ shortTitle: Auto linked references
|
||||
If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)."
|
||||
{% endif %}
|
||||
|
||||
## ラベル
|
||||
When referencing the URL of a label in Markdown, the label is automatically rendered. Only labels of the same repository are rendered, URLs pointing to a label from a different repository are rendered as any [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls).
|
||||
|
||||
The URL of a label can be found by navigating to the labels page and clicking on a label. For example, the URL of the label "enhancement" in our public [docs repository](https://github.com/github/docs/) is
|
||||
|
||||
```md
|
||||
https://github.com/github/docs/labels/enhancement
|
||||
```
|
||||
|
||||
## コミット SHA
|
||||
|
||||
コミットの SHA ハッシュへの参照は、{% data variables.product.product_name %}上のコミットへの短縮リンクに自動的に変換されます。
|
||||
|
||||
@@ -10,11 +10,11 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
includeGuides:
|
||||
- /issues/trying-out-the-new-projects-experience/automating-projects
|
||||
- /issues/trying-out-the-new-projects-experience/creating-a-project
|
||||
- /issues/trying-out-the-new-projects-experience/customizing-your-project-views
|
||||
- /issues/trying-out-the-new-projects-experience/quickstart
|
||||
- /issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects
|
||||
- /issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions
|
||||
- /issues/planning-and-tracking-with-projects/creating-projects/creating-a-project
|
||||
- /issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view
|
||||
- /issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects
|
||||
- /issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects
|
||||
- /issues/tracking-your-work-with-issues/quickstart
|
||||
- /issues/tracking-your-work-with-issues/creating-an-issue
|
||||
- /issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests
|
||||
|
||||
@@ -8,18 +8,19 @@ introLinks:
|
||||
featuredLinks:
|
||||
guides:
|
||||
- /issues/tracking-your-work-with-issues/creating-issues/creating-an-issue
|
||||
- /issues/trying-out-the-new-projects-experience/quickstart
|
||||
- /issues/trying-out-the-new-projects-experience/best-practices-for-managing-projects
|
||||
- /issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects
|
||||
- /issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects
|
||||
- /communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository
|
||||
- /issues/tracking-your-work-with-issues/planning-and-tracking-work-for-your-team-or-project
|
||||
guideCards:
|
||||
- /issues/trying-out-the-new-projects-experience/automating-projects
|
||||
- /issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view
|
||||
- /issues/tracking-your-work-with-issues/creating-issues/linking-a-pull-request-to-an-issue
|
||||
- '{% ifversion ghes or ghae %}/issues/organizing-your-work-with-project-boards/managing-project-boards/configuring-automation-for-project-boards{% endif %}'
|
||||
- /issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects
|
||||
- /issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions
|
||||
popular:
|
||||
- /issues/tracking-your-work-with-issues/creating-issues/about-issues
|
||||
- /issues/trying-out-the-new-projects-experience/about-projects
|
||||
- /issues/planning-and-tracking-with-projects/learning-about-projects/about-projects
|
||||
- /issues/planning-and-tracking-with-projects/creating-projects/creating-a-project
|
||||
- /issues/tracking-your-work-with-issues/creating-issues/about-task-lists
|
||||
- /communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates
|
||||
- /issues/using-labels-and-milestones-to-track-work/managing-labels
|
||||
@@ -32,8 +33,8 @@ featuredLinks:
|
||||
href: 'https://www.youtube-nocookie.com/embed/HwpVvDURHKw'
|
||||
- title: Issue Forms for open source – Luke Hefson
|
||||
href: 'https://www.youtube-nocookie.com/embed/2Yh8ueUE0oY'
|
||||
videosHeading: GitHub Universe 2021 videos
|
||||
product_video: 'https://www.youtube-nocookie.com/embed/uiaLWluYJsA'
|
||||
videosHeading: Videos
|
||||
product_video: '{% ifversion projects-v2 %}https://www.youtube-nocookie.com/embed/yFQ-p6wMS_Y{% else %}https://www.youtube-nocookie.com/embed/uiaLWluYJsA{% endif %}'
|
||||
layout: product-landing
|
||||
beta_product: false
|
||||
versions:
|
||||
@@ -43,7 +44,7 @@ versions:
|
||||
ghec: '*'
|
||||
children:
|
||||
- /tracking-your-work-with-issues
|
||||
- /trying-out-the-new-projects-experience
|
||||
- /planning-and-tracking-with-projects
|
||||
- /organizing-your-work-with-project-boards
|
||||
- /using-labels-and-milestones-to-track-work
|
||||
- /guides
|
||||
|
||||
@@ -1,12 +1,10 @@
|
||||
---
|
||||
title: プロジェクトボードで作業を整理する
|
||||
shortTitle: プロジェクトボード
|
||||
intro: 'プロジェクトボードを使って{% data variables.product.prodname_dotcom %}上の作業を管理してください'
|
||||
title: 'Organizing your work with {% data variables.product.prodname_projects_v1 %}'
|
||||
shortTitle: '{% data variables.product.prodname_projects_v1_caps %}'
|
||||
intro: 'Use {% data variables.product.prodname_projects_v1 %} to manage your work on {% data variables.product.prodname_dotcom %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
|
||||
@@ -1,31 +1,29 @@
|
||||
---
|
||||
title: プロジェクトボードの自動化について
|
||||
intro: プロジェクトボードカードのステータスを関連するIssueやプルリクエストと同期させておくために、自動化されたワークフローを設定できます。
|
||||
title: 'About automation for {% data variables.product.prodname_projects_v1 %}'
|
||||
intro: 'You can configure automatic workflows to keep the status of {% data variables.projects.projects_v1_board %} cards in sync with the associated issues and pull requests.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/about-automation-for-project-boards
|
||||
- /articles/about-automation-for-project-boards
|
||||
- /github/managing-your-work-on-github/about-automation-for-project-boards
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: プロジェクトボードの自動化
|
||||
shortTitle: 'Automation for {% data variables.product.prodname_projects_v1 %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
{% data reusables.project-management.automate-project-board-permissions %} 詳細は「[Organization のプロジェクトボードの権限](/articles/project-board-permissions-for-an-organization)」を参照してください。
|
||||
{% data reusables.project-management.automate-project-board-permissions %} For more information, see "[{% data variables.product.prodname_projects_v1_caps %} permissions for an organization](/articles/project-board-permissions-for-an-organization)."
|
||||
|
||||
プロジェクトボードの列に対するトリガーとなるイベントに基づいて、アクションを自動化できます。 これによって、プロジェクトボードを管理するための手作業のタスクの一部を撤廃できます。 たとえば"To do"列を設定して、プロジェクトボードに追加された新しいIssueあるいはプルリクエストが自動的に設定された列に移動するようにできます。 詳しい情報については[プロジェクトボードのための自動化の設定](/articles/configuring-automation-for-project-boards)を参照してください。
|
||||
You can automate actions based on triggering events for {% data variables.projects.projects_v1_board %} columns. This eliminates some of the manual tasks in managing a {% data variables.projects.projects_v1_board %}. For example, you can configure a "To do" column, where any new issues or pull requests you add to a {% data variables.projects.projects_v1_board %} are automatically moved to the configured column. For more information, see "[Configuring automation for {% data variables.product.prodname_projects_v1 %}](/articles/configuring-automation-for-project-boards)."
|
||||
|
||||
{% data reusables.project-management.use-automated-template %}
|
||||
|
||||
{% data reusables.project-management.copy-project-boards %}
|
||||
|
||||
プロジェクトボードの自動化は、特定のアクションに対する標準化されたワークフローを作成することによって、プロジェクトボードの目的とTeamの開発プロセスの共通理解を育むための役にも立ちます。
|
||||
{% data variables.projects.projects_v1_board_caps %} automation can also help teams develop a shared understanding of a {% data variables.projects.projects_v1_board %}'s purpose and the team's development process by creating a standard workflow for certain actions.
|
||||
|
||||
{% data reusables.project-management.resync-automation %}
|
||||
|
||||
@@ -39,11 +37,10 @@ shortTitle: プロジェクトボードの自動化
|
||||
|
||||
## プロジェクトの進捗の追跡
|
||||
|
||||
進捗は、プロジェクトボードで追跡できます。 [To do]、[In progress]、または [Done] 列のカードの数は、プロジェクトの進捗全体にカウントされます。 {% data reusables.project-management.project-progress-locations %}
|
||||
You can track the progress on your {% data variables.projects.projects_v1_board %}. [To do]、[In progress]、または [Done] 列のカードの数は、プロジェクトの進捗全体にカウントされます。 {% data reusables.project-management.project-progress-locations %}
|
||||
|
||||
詳細については「[プロジェクトボードで進捗を追跡する](/github/managing-your-work-on-github/tracking-progress-on-your-project-board)」を参照してください。
|
||||
For more information, see "[Tracking progress on your {% data variables.product.prodname_project_v1 %}](/github/managing-your-work-on-github/tracking-progress-on-your-project-board)."
|
||||
|
||||
## 参考リンク
|
||||
- 「[プロジェクトボードの自動化を設定する](/articles/configuring-automation-for-project-boards)」{% ifversion fpt or ghec %}
|
||||
- [プロジェクトボードのコピー](/articles/copying-a-project-board)
|
||||
{% endif %}
|
||||
- "[Configuring automation for {% data variables.product.prodname_projects_v1 %}](/articles/configuring-automation-for-project-boards)"{% ifversion fpt or ghec %}
|
||||
- "[Copying a {% data variables.product.prodname_project_v1 %}](/articles/copying-a-project-board)"{% endif %}
|
||||
|
||||
@@ -1,55 +1,53 @@
|
||||
---
|
||||
title: プロジェクトボードについて
|
||||
intro: '{% data variables.product.product_name %}のプロジェクトボードは、作業を整理して優先順位付けするための役に立ちます。 プロジェクトボードは、特定の機能の作業、包括的なロードマップ、さらにはリリースのチェックリストのためにも作成できます。 プロジェクトボードを使うと、要求に適したカスタマイズされたワークフローを作成する柔軟性が得られます。'
|
||||
title: '{% data variables.product.prodname_projects_v1 %}について'
|
||||
intro: '{% data variables.product.prodname_projects_v1_caps %} on {% data variables.product.product_name %} help you organize and prioritize your work. You can create {% data variables.projects.projects_v1_boards %} for specific feature work, comprehensive roadmaps, or even release checklists. With {% data variables.product.prodname_projects_v1 %}, you have the flexibility to create customized workflows that suit your needs.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/about-project-boards
|
||||
- /articles/about-projects
|
||||
- /articles/about-project-boards
|
||||
- /github/managing-your-work-on-github/about-project-boards
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
プロジェクトボードは、Issue、プルリクエスト、選択した列内でカードとして分類されるノートから構成されます。 列内のカードの並び替え、列から列へのカードの移動、および列の順序の変更には、ドラッグアンドドロップまたはキーボードショートカットが利用できます。
|
||||
{% data variables.projects.projects_v1_boards_caps %} are made up of issues, pull requests, and notes that are categorized as cards in columns of your choosing. 列内のカードの並び替え、列から列へのカードの移動、および列の順序の変更には、ドラッグアンドドロップまたはキーボードショートカットが利用できます。
|
||||
|
||||
プロジェクトボードのカードには、ラベル、アサインされた人、スタータス、オープンした人など、Issueやプルリクエストに関連するメタデータが含まれます。 {% data reusables.project-management.edit-in-project %}
|
||||
{% data variables.projects.projects_v1_board_caps %} cards contain relevant metadata for issues and pull requests, like labels, assignees, the status, and who opened it. {% data reusables.project-management.edit-in-project %}
|
||||
|
||||
タスクのリマインダとして機能するノートを列内に作成し、{% data variables.product.product_location %} 上の任意のリポジトリからの Issue やプルリクエストを参照させたり、プロジェクトボードに関係する情報を追加したりすることができます。 ノートにリンクを追加することで、他のプロジェクトを参照するカードを作成することもできます。 ノートでは要求を満たせない場合、ノートを Issue に変換することができます。 プロジェクトボードのノートのIssueへの変換に関する詳しい情報については[プロジェクトボードへのノートの追加](/articles/adding-notes-to-a-project-board)を参照してください。
|
||||
You can create notes within columns to serve as task reminders, references to issues and pull requests from any repository on {% data variables.product.product_location %}, or to add information related to the {% data variables.projects.projects_v1_board %}. You can create a reference card for another {% data variables.projects.projects_v1_board %} by adding a link to a note. ノートでは要求を満たせない場合、ノートを Issue に変換することができます。 For more information on converting notes to issues, see "[Adding notes to a {% data variables.product.prodname_project_v1 %}](/articles/adding-notes-to-a-project-board)."
|
||||
|
||||
プロジェクトボードには以下の種類があります:
|
||||
|
||||
- **ユーザが所有するプロジェクトボード**には、任意の個人リポジトリからの Issue およびプルリクエストを含めることができます。
|
||||
- **Organization内プロジェクトボード**は、Organizationに属する任意のリポジトリからのIssueやプルリクエストを含むことができます。 {% data reusables.project-management.link-repos-to-project-board %}詳細は「[リポジトリをプロジェクトボードにリンクする](/articles/linking-a-repository-to-a-project-board)」を参照してください。
|
||||
- **リポジトリプロジェクトボード**は、単一のリポジトリ内の Issue とプルリクエストを対象とします。 他のリポジトリの Issue やプルリクエストを参照するノートも含まれます。
|
||||
- **User-owned {% data variables.projects.projects_v1_board %}** can contain issues and pull requests from any personal repository.
|
||||
- **Organization-wide {% data variables.projects.projects_v1_board %}** can contain issues and pull requests from any repository that belongs to an organization. {% data reusables.project-management.link-repos-to-project-board %} For more information, see "[Linking a repository to a {% data variables.product.prodname_project_v1 %}](/articles/linking-a-repository-to-a-project-board)."
|
||||
- **Repository {% data variables.projects.projects_v1_board %}** are scoped to issues and pull requests within a single repository. 他のリポジトリの Issue やプルリクエストを参照するノートも含まれます。
|
||||
|
||||
## プロジェクトボードの作成と表示
|
||||
## Creating and viewing {% data variables.projects.projects_v1_boards %}
|
||||
|
||||
Organization にプロジェクトボードを作成するには、Organization のメンバーでなければなりません。 Organization のオーナーおよびプロジェクトボードの管理者権限を持っている人は、プロジェクトボードへのアクセスをカスタマイズできます。
|
||||
To create a {% data variables.projects.projects_v1_board %} for your organization, you must be an organization member. Organization owners and people with {% data variables.projects.projects_v1_board %} admin permissions can customize access to the {% data variables.projects.projects_v1_board %}.
|
||||
|
||||
Organization が所有するプロジェクトボードに、あなたが表示する権限を持っていないリポジトリからの Issue あるいはプルリクエストが含まれている場合、そのカードは削除編集されます。 詳しい情報については、「[Organization のプロジェクトボードの権限](/articles/project-board-permissions-for-an-organization)」を参照してください。
|
||||
If an organization-owned {% data variables.projects.projects_v1_board %} includes issues or pull requests from a repository that you don't have permission to view, the card will be redacted. For more information, see "[{% data variables.product.prodname_project_v1_caps %} permissions for an organization](/articles/project-board-permissions-for-an-organization)."
|
||||
|
||||
アクティビティビューには、誰かが作成したカードや、列間での移動など、プロジェクトの最近の履歴が表示されます。 アクティビティビューにアクセスするには、[**Menu**] をクリックしてスクロールダウンします。
|
||||
The activity view shows the {% data variables.projects.projects_v1_board %}'s recent history, such as cards someone created or moved between columns. アクティビティビューにアクセスするには、[**Menu**] をクリックしてスクロールダウンします。
|
||||
|
||||
プロジェクトボード上で特定のカードを見つける、あるいはカード群の一部を見るために、プロジェクトボードカードをフィルタリングできます。 詳細は「[プロジェクトボード上でカードをフィルタリングする](/articles/filtering-cards-on-a-project-board)」を参照してください。
|
||||
To find specific cards on a {% data variables.projects.projects_v1_board %} or view a subset of the cards, you can filter {% data variables.projects.projects_v1_board %} cards. For more information, see "[Filtering cards on a {% data variables.product.prodname_project_v1 %}](/articles/filtering-cards-on-a-project-board)."
|
||||
|
||||
ワークフローをシンプルにし、完了したタスクをプロジェクトボードから外しておくために、カードをアーカイブできます。 詳細は「[プロジェクトボードのカードをアーカイブする](/articles/archiving-cards-on-a-project-board)」を参照してください。
|
||||
To simplify your workflow and keep completed tasks off your {% data variables.projects.projects_v1_board %}, you can archive cards. For more information, see "[Archiving cards on a {% data variables.product.prodname_project_v1 %}](/articles/archiving-cards-on-a-project-board)."
|
||||
|
||||
プロジェクトボードのタスクがすべて完了した、あるいはプロジェクトボードを使う必要がなくなったりした場合には、プロジェクトボードをクローズできます。 詳しい情報については[プロジェクトボードのクローズ](/articles/closing-a-project-board)を参照してください。
|
||||
If you've completed all of your {% data variables.projects.projects_v1_board %} tasks or no longer need to use your {% data variables.projects.projects_v1_board %}, you can close the {% data variables.projects.projects_v1_board %}. For more information, see "[Closing a {% data variables.product.prodname_project_v1 %}](/articles/closing-a-project-board)."
|
||||
|
||||
また、別の方法で作業を追跡したい場合は、[リポジトリ中でプロジェクトボードを無効化する](/articles/disabling-project-boards-in-a-repository)、あるいは[Organization 内でプロジェクトボードを無効化する](/articles/disabling-project-boards-in-your-organization)こともできます。
|
||||
You can also [disable {% data variables.projects.projects_v1_boards %} in a repository](/articles/disabling-project-boards-in-a-repository) or [disable {% data variables.projects.projects_v1_boards %} in your organization](/articles/disabling-project-boards-in-your-organization), if you prefer to track your work in a different way.
|
||||
|
||||
{% data reusables.project-management.project-board-import-with-api %}
|
||||
|
||||
## プロジェクトボードのテンプレート
|
||||
## Templates for {% data variables.projects.projects_v1_boards %}
|
||||
|
||||
テンプレートを使って、新しいプロジェクトボードを素早くセットアップできます。 テンプレートを使用してプロジェクトボードを作成すると、新しいボードには、列だけでなく、プロジェクトボードの便利な利用方法が書かれたカードが付きます。 また、自動化が設定済みのテンプレートを選択することもできます。
|
||||
You can use templates to quickly set up a new {% data variables.projects.projects_v1_board %}. When you use a template to create a {% data variables.projects.projects_v1_board %}, your new board will include columns as well as cards with tips for using {% data variables.product.prodname_projects_v1 %}. また、自動化が設定済みのテンプレートを選択することもできます。
|
||||
|
||||
| テンプレート | 説明 |
|
||||
| ---------------------------- | ------------------------------------------------------------------------------ |
|
||||
@@ -58,18 +56,17 @@ Organization が所有するプロジェクトボードに、あなたが表示
|
||||
| Automated kanban with review | プルリクエストレビューのステータスのための追加のトリガーで、カードは [To do]、[In progress]、[Done] 列の間を自動的に移動します。 |
|
||||
| Bug triage | [To do]、[High priority]、[Low priority]、[Closed] 列でバグのトリアージと優先順位付けをします。 |
|
||||
|
||||
プロジェクトボードのための自動化に関する詳しい情報については、「[プロジェクトボードの自動化について](/articles/about-automation-for-project-boards)」を参照してください。
|
||||
For more information on automation for {% data variables.product.prodname_projects_v1 %}, see "[About automation for {% data variables.product.prodname_projects_v1 %}](/articles/about-automation-for-project-boards)."
|
||||
|
||||
|
||||
|
||||
|
||||
{% data reusables.project-management.copy-project-boards %}
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [プロジェクトボードの作成](/articles/creating-a-project-board)
|
||||
- [プロジェクトボードの編集](/articles/editing-a-project-board){% ifversion fpt or ghec %}
|
||||
- [プロジェクトボードのコピー](/articles/copying-a-project-board)
|
||||
{% endif %}
|
||||
- [プロジェクトボードへの Issue およびプルリクエストの追加](/articles/adding-issues-and-pull-requests-to-a-project-board)
|
||||
- [Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-organization)
|
||||
- [{% data variables.product.prodname_project_v1 %}を作成する](/articles/creating-a-project-board)
|
||||
- "[Editing a {% data variables.product.prodname_project_v1 %}](/articles/editing-a-project-board)"{% ifversion fpt or ghec %}
|
||||
- "[Copying a {% data variables.product.prodname_project_v1 %}](/articles/copying-a-project-board)"{% endif %}
|
||||
- "[Adding issues and pull requests to a {% data variables.product.prodname_project_v1 %}](/articles/adding-issues-and-pull-requests-to-a-project-board)"
|
||||
- "[{% data variables.product.prodname_project_v1_caps %} permissions for an organization](/articles/project-board-permissions-for-an-organization)"
|
||||
- [キーボードショートカット](/articles/keyboard-shortcuts/#project-boards)
|
||||
|
||||
@@ -1,18 +1,16 @@
|
||||
---
|
||||
title: プロジェクトボードの表示設定の変更
|
||||
intro: 'Organization のオーナーまたはプロジェクトボードの管理者は、プロジェクトボードを{% ifversion ghae %}内部{% else %}パブリック{% endif %}またはプライベートにすることができます。'
|
||||
title: 'Changing {% data variables.product.prodname_project_v1 %} visibility'
|
||||
intro: 'As an organization owner or {% data variables.projects.projects_v1_board %} admin, you can make a {% data variables.projects.projects_v1_board %} {% ifversion ghae %}internal{% else %}public{% endif %} or private.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/changing-project-board-visibility
|
||||
- /articles/changing-project-board-visibility
|
||||
- /github/managing-your-work-on-github/changing-project-board-visibility
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: 可視性の変更
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
@@ -21,7 +19,7 @@ shortTitle: 可視性の変更
|
||||
|
||||
{% tip %}
|
||||
|
||||
**参考:** プロジェクトボードを{% ifversion ghae %}内部{% else %}パブリックにすると{% endif %}、Organization のメンバーにはデフォルトで読み取りアクセスが付与されます。 特定の Organization メンバーに書き込み権限や管理者権限を与えるには、参加している Team にプロジェクトボードへのアクセス権限を与えるか、プロジェクトボードにコラボレータとして追加してください。 詳しい情報については、「[Organization のプロジェクトボードの権限](/articles/project-board-permissions-for-an-organization)」を参照してください。
|
||||
**Tip:** When you make your {% data variables.projects.projects_v1_board %} {% ifversion ghae %}internal{% else %}public{% endif %}, organization members are given read access by default. You can give specific organization members write or admin permissions by giving access to teams they're on or by adding them to the {% data variables.projects.projects_v1_board %} as a collaborator. For more information, see "[{% data variables.product.prodname_project_v1_caps %} permissions for an organization](/articles/project-board-permissions-for-an-organization)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
|
||||
@@ -1,34 +1,32 @@
|
||||
---
|
||||
title: プロジェクトボードをクローズする
|
||||
intro: プロジェクトボードのタスクをすべて完了したか、プロジェクトボードを使う必要がなくなった場合、そのプロジェクトボードをクローズできます。
|
||||
title: 'Closing a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'If you''ve completed all the tasks in a {% data variables.projects.projects_v1_board %} or no longer need to use a {% data variables.projects.projects_v1_board %}, you can close the {% data variables.projects.projects_v1_board %}.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/closing-a-project-board
|
||||
- /articles/closing-a-project
|
||||
- /articles/closing-a-project-board
|
||||
- /github/managing-your-work-on-github/closing-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
プロジェクトボードをクローズすると、設定されたワークフローの自動化はデフォルトですべて停止します。
|
||||
When you close a {% data variables.projects.projects_v1_board %}, any configured workflow automation will pause by default.
|
||||
|
||||
プロジェクトボードを再びオープンする場合、自動化を*同期*するよう設定することができます。それにより、ボードに設定されている自動化設定に従ってボード上のカードのポジションが更新されます。 詳しい情報については、「[クローズされたプロジェクトボードを再びオープンする](/articles/reopening-a-closed-project-board)」や「[プロジェクトボードの自動化について](/articles/about-automation-for-project-boards)」を参照してください。
|
||||
If you reopen a {% data variables.projects.projects_v1_board %}, you have the option to *sync* automation, which updates the position of the cards on the board according to the automation settings configured for the board. For more information, see "[Reopening a closed {% data variables.product.prodname_project_v1 %}](/articles/reopening-a-closed-project-board)" or "[About automation for {% data variables.product.prodname_projects_v1 %}](/articles/about-automation-for-project-boards)."
|
||||
|
||||
1. リポジトリもしくはOrganization内、あるいは個人アカウントが所有するプロジェクトボードのリストにアクセスしてください。
|
||||
2. プロジェクトリストで、クローズしたいプロジェクトボードの隣にある {% octicon "chevron-down" aria-label="The chevron icon" %}をクリックします。 
|
||||
1. Navigate to the list of {% data variables.projects.projects_v1_boards %} in your repository or organization, or owned by your personal account.
|
||||
2. In the projects list, next to the {% data variables.projects.projects_v1_board %} you want to close, click {% octicon "chevron-down" aria-label="The chevron icon" %}. 
|
||||
3. [**Close**] をクリックします。 ![プロジェクトボードのドロップダウンメニューにある [Close] アイテム](/assets/images/help/projects/close-project.png)
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [プロジェクトボードについて](/articles/about-project-boards)
|
||||
- [プロジェクトボードの削除](/articles/deleting-a-project-board)
|
||||
- [リポジトリ内のプロジェクトボードを無効化](/articles/disabling-project-boards-in-a-repository)
|
||||
- "[Organization 内のプロジェクトボードの無効化](/articles/disabling-project-boards-in-your-organization)"
|
||||
- [Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-organization)
|
||||
- [{% data variables.product.prodname_projects_v1 %}について](/articles/about-project-boards)
|
||||
- "[Deleting a {% data variables.product.prodname_project_v1 %}](/articles/deleting-a-project-board)"
|
||||
- "[Disabling {% data variables.product.prodname_projects_v1 %} in a repository](/articles/disabling-project-boards-in-a-repository)"
|
||||
- "[Disabling {% data variables.product.prodname_projects_v1 %} in your organization](/articles/disabling-project-boards-in-your-organization)"
|
||||
- "[{% data variables.product.prodname_project_v1_caps %} permissions for an organization](/articles/project-board-permissions-for-an-organization)"
|
||||
|
||||
@@ -1,15 +1,12 @@
|
||||
---
|
||||
title: プロジェクトボードの自動化を設定する
|
||||
intro: 指定したイベントが発生した時に Issue やプルリクエストをプロジェクトボードに移動させるよう、自動化されたワークフローを設定できます。
|
||||
title: 'Configuring automation for {% data variables.product.prodname_projects_v1 %}'
|
||||
intro: 'You can set up automatic workflows to move issues and pull requests to a {% data variables.projects.projects_v1_board %} column when a specified event occurs.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/configuring-automation-for-project-boards
|
||||
- /articles/configuring-automation-for-project-boards
|
||||
- /github/managing-your-work-on-github/configuring-automation-for-project-boards
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
- Projects
|
||||
@@ -17,11 +14,12 @@ topics:
|
||||
- Project management
|
||||
shortTitle: 自動化の設定
|
||||
type: how_to
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
{% data reusables.project-management.automate-project-board-permissions %}詳しい情報については、「[プロジェクトボードの自動化について](/articles/about-automation-for-project-boards)」を参照してください。
|
||||
{% data reusables.project-management.automate-project-board-permissions %} For more information, see "[About automation for {% data variables.product.prodname_projects_v1 %}](/articles/about-automation-for-project-boards)."
|
||||
|
||||
{% data reusables.project-management.use-automated-template %}
|
||||
|
||||
@@ -33,7 +31,7 @@ type: how_to
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. 自動化したいプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} you want to automate.
|
||||
2. 自動化したい列で、{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}をクリックします。 
|
||||
3. [**Manage automation**] をクリックします。 ![[Manage automation] ボタン](/assets/images/help/projects/manage-automation-button.png)
|
||||
4. [Preset] ドロップダウンメニューで、自動化のプリセットを 1 つ選びます。 
|
||||
@@ -41,4 +39,4 @@ type: how_to
|
||||
6. [**Update automation**] をクリックします。
|
||||
|
||||
## 参考リンク
|
||||
- [プロジェクトボードの自動化について](/articles/about-automation-for-project-boards)
|
||||
- "[About automation for {% data variables.product.prodname_projects_v1 %}](/articles/about-automation-for-project-boards)"
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: プロジェクトボードをコピーする
|
||||
intro: プロジェクトボードをコピーして、新しいプロジェクトを素早く作成できます。 頻繁に使われるプロジェクトボードや、高度にカスタマイズされたプロジェクトボードをコピーすることは、ワークフローの標準化に役立ちます。
|
||||
title: 'Copying a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can copy a {% data variables.projects.projects_v1_board %} to quickly create a new project. Copying frequently used or highly customized {% data variables.projects.projects_v1_boards %} helps standardize your workflow.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/copying-a-project-board
|
||||
- /articles/copying-a-project-board
|
||||
@@ -10,23 +10,24 @@ versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Pull requests
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
プロジェクトボードをコピーすると、プロジェクトボードのタイトル、説明、自動化の設定を再利用できます。 プロジェクトボードをコピーすることで、同じようなワークフローのために新しいプロジェクトボードを手動で作成するプロセスをなくすことができます。
|
||||
Copying a {% data variables.projects.projects_v1_board %} allows you to reuse a {% data variables.projects.projects_v1_board %}'s title, description, and automation configuration. You can copy {% data variables.projects.projects_v1_boards %} to eliminate the manual process of creating new {% data variables.projects.projects_v1_boards %} for similar workflows.
|
||||
|
||||
コピー元のプロジェクトボードへの読み取りアクセス、およびコピー先のリポジトリまたは Organization への書き込みアクセスが必要です。
|
||||
You must have read access to a {% data variables.projects.projects_v1_board %} to copy it to a repository or organization where you have write access.
|
||||
|
||||
プロジェクトボードを Organization にコピーすると、プロジェクトボードの表示はデフォルトでプライベートになります。表示設定は変更できます。 詳しい情報については「[プロジェクトボードの表示設定を変更する](/articles/changing-project-board-visibility/)」を参照してください。
|
||||
When you copy a {% data variables.projects.projects_v1_board %} to an organization, the {% data variables.projects.projects_v1_board %}'s visibility will default to private, with an option to change the visibility. For more information, see "[Changing {% data variables.product.prodname_project_v1 %} visibility](/articles/changing-project-board-visibility/)."
|
||||
|
||||
プロジェクトボードの自動化も、デフォルトで有効になっています。 詳しい情報については「[プロジェクトボードの自動化について](/articles/about-automation-for-project-boards/)」を参照してください。
|
||||
A {% data variables.projects.projects_v1_board %}'s automation is also enabled by default. For more information, see "[About automation for {% data variables.product.prodname_projects_v1 %}](/articles/about-automation-for-project-boards/)."
|
||||
|
||||
1. コピーしたいプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} you want to copy.
|
||||
{% data reusables.project-management.click-menu %}
|
||||
3. {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}をクリックしてから、[**Copy**] をクリックします。 ![プロジェクトボードのサイドバーにある、ドロップダウンメニューの [Copy] オプション](/assets/images/help/projects/project-board-copy-setting.png)
|
||||
4. [Owner] の下にあるドロップダウンメニューで、プロジェクトボードのコピー先にするリポジトリまたは Organization をクリックします。 
|
||||
5. 必要に応じて、[Project board name] の下に、コピーしたプロジェクトボードの名前を入力します。 
|
||||
5. Optionally, under "Project board name", type the name of the copied {% data variables.projects.projects_v1_board %}. 
|
||||
6. 必要に応じて、他の人に読んでもらうために、[Description] の下に、コピーしたプロジェクトボードについての説明を入力します。 
|
||||
7. 必要に応じて、[Automation settings] の下で、設定済みの自動化されたワークフローをコピーするかどうかを選択します。 このオプションはデフォルトで有効になっています。 詳しい情報については「[プロジェクトボードの自動化について](/articles/about-automation-for-project-boards/)」を参照してください。 
|
||||
{% data reusables.project-management.choose-visibility %}
|
||||
|
||||
@@ -1,22 +1,20 @@
|
||||
---
|
||||
title: プロジェクトボードの作成
|
||||
intro: プロジェクトボードは、特定機能の働きの追跡と優先度付け、総合的なロードマップ、さらにはリリースチェックリストなど、ニーズを満たすカスタマイズワークフローを作成するために使用できます。
|
||||
title: '{% data variables.product.prodname_project_v1 %}の作成'
|
||||
intro: '{% data variables.projects.projects_v1_boards_caps %} can be used to create customized workflows to suit your needs, like tracking and prioritizing specific feature work, comprehensive roadmaps, or even release checklists.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/creating-a-project-board
|
||||
- /articles/creating-a-project
|
||||
- /articles/creating-a-project-board
|
||||
- /github/managing-your-work-on-github/creating-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
- Issues
|
||||
- Projects
|
||||
- Project management
|
||||
type: how_to
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
@@ -25,20 +23,21 @@ type: how_to
|
||||
|
||||
{% data reusables.project-management.copy-project-boards %}
|
||||
|
||||
{% data reusables.project-management.link-repos-to-project-board %}詳細は「[リポジトリをプロジェクトボードにリンクする](/articles/linking-a-repository-to-a-project-board)」を参照してください。
|
||||
{% data reusables.project-management.link-repos-to-project-board %} For more information, see "[Linking a repository to a {% data variables.product.prodname_project_v1 %} ](/articles/linking-a-repository-to-a-project-board)."
|
||||
|
||||
プロジェクトボードの作成が完了すると、そこへ Issue、プルリクエスト、およびノートを追加できます。 詳細は「[プロジェクトボードに Issue およびプルリクエストを追加する](/articles/adding-issues-and-pull-requests-to-a-project-board)」および「[プロジェクトボードにノートを追加する](/articles/adding-notes-to-a-project-board)」を参照してください。
|
||||
Once you've created your {% data variables.projects.projects_v1_board %}, you can add issues, pull requests, and notes to it. For more information, see "[Adding issues and pull requests to a {% data variables.product.prodname_project_v1 %}](/articles/adding-issues-and-pull-requests-to-a-project-board)" and "[Adding notes to a {% data variables.product.prodname_project_v1 %}](/articles/adding-notes-to-a-project-board)."
|
||||
|
||||
また、プロジェクトボードが Issue やプルリクエストのステータスと同期を保てるよう、ワークフローの自動化を設定することもできます。 詳しい情報については「[プロジェクトボードの自動化について](/articles/about-automation-for-project-boards)」を参照してください。
|
||||
You can also configure workflow automations to keep your {% data variables.projects.projects_v1_board %} in sync with the status of issues and pull requests. For more information, see "[About automation for {% data variables.product.prodname_projects_v1 %}](/articles/about-automation-for-project-boards)."
|
||||
|
||||
{% data reusables.project-management.project-board-import-with-api %}
|
||||
|
||||
## ユーザが所有するプロジェクトボードの作成
|
||||
## Creating a user-owned {% data variables.projects.projects_v1_board %}
|
||||
|
||||
{% data reusables.projects.classic-project-creation %}
|
||||
|
||||
{% data reusables.profile.access_profile %}
|
||||
2. プロフィールページの一番上のメインナビゲーションにある{% octicon "project" aria-label="The project board icon" %}[**Projects**] をクリックします。 
|
||||
2. プロフィールページの一番上のメインナビゲーションにある{% octicon "project" aria-label="The project board icon" %}[**Projects**] をクリックします。 {% ifversion projects-v2 %}
|
||||
1. Click **Projects (classic)**{% endif %}
|
||||
{% data reusables.project-management.click-new-project %}
|
||||
{% data reusables.project-management.create-project-name-description %}
|
||||
{% data reusables.project-management.choose-template %}
|
||||
@@ -54,13 +53,14 @@ type: how_to
|
||||
|
||||
{% data reusables.project-management.edit-project-columns %}
|
||||
|
||||
## Organization 全体のプロジェクトボードの作成
|
||||
## Creating an organization-wide {% data variables.projects.projects_v1_board %}
|
||||
|
||||
{% data reusables.projects.classic-project-creation %}
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.user-settings.access_org %}
|
||||
{% data reusables.organizations.organization-wide-project %}
|
||||
{% data reusables.organizations.organization-wide-project %}{% ifversion projects-v2 %}
|
||||
1. Click **Projects (classic)**{% endif %}
|
||||
{% data reusables.project-management.click-new-project %}
|
||||
{% data reusables.project-management.create-project-name-description %}
|
||||
{% data reusables.project-management.choose-template %}
|
||||
@@ -76,12 +76,13 @@ type: how_to
|
||||
|
||||
{% data reusables.project-management.edit-project-columns %}
|
||||
|
||||
## リポジトリのプロジェクトボードの作成
|
||||
## Creating a repository {% data variables.projects.projects_v1_board %}
|
||||
|
||||
{% data reusables.projects.classic-project-creation %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
2. リポジトリ名の下にある {% octicon "project" aria-label="The project board icon" %}[**Projects**] をクリックします。 
|
||||
2. リポジトリ名の下にある {% octicon "project" aria-label="The project board icon" %}[**Projects**] をクリックします。 {% ifversion projects-v2 %}
|
||||
1. Click **Projects (classic)**{% endif %}
|
||||
{% data reusables.project-management.click-new-project %}
|
||||
{% data reusables.project-management.create-project-name-description %}
|
||||
{% data reusables.project-management.choose-template %}
|
||||
|
||||
@@ -1,29 +1,27 @@
|
||||
---
|
||||
title: プロジェクトボードの削除
|
||||
intro: 既存のプロジェクトボードのコンテンツにアクセスする必要がない場合、削除することができます。
|
||||
title: 'Deleting a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can delete an existing {% data variables.projects.projects_v1_board %} if you no longer need access to its contents.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/deleting-a-project-board
|
||||
- /articles/deleting-a-project
|
||||
- /articles/deleting-a-project-board
|
||||
- /github/managing-your-work-on-github/deleting-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
**参考**: 完了したあるいは不要なプロジェクトボードへのアクセスを維持し、そのコンテンツへのアクセスも失いたくない場合、削除する代わりに[プロジェクトボードを閉じる](/articles/closing-a-project-board)ことができます。
|
||||
**Tip**: If you'd like to retain access to a completed or unneeded {% data variables.projects.projects_v1_board %} without losing access to its contents, you can [close the {% data variables.projects.projects_v1_board %}](/articles/closing-a-project-board) instead of deleting it.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. 削除対象のプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} you want to delete.
|
||||
{% data reusables.project-management.click-menu %}
|
||||
{% data reusables.project-management.click-edit-sidebar-menu-project-board %}
|
||||
4. [**Delete project**] をクリックします。 ![[Delete project] ボタン](/assets/images/help/projects/delete-project-button.png)
|
||||
@@ -31,6 +29,6 @@ topics:
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- "[プロジェクトボードをクローズする](/articles/closing-a-project-board)"
|
||||
- [リポジトリ内のプロジェクトボードを無効化](/articles/disabling-project-boards-in-a-repository)
|
||||
- "[Organization 内のプロジェクトボードの無効化](/articles/disabling-project-boards-in-your-organization)"
|
||||
- "[Closing a {% data variables.product.prodname_project_v1 %}](/articles/closing-a-project-board)"
|
||||
- "[Disabling {% data variables.product.prodname_project_v1_caps %} in a repository](/articles/disabling-project-boards-in-a-repository)"
|
||||
- "[Disabling {% data variables.product.prodname_project_v1_caps %} in your organization](/articles/disabling-project-boards-in-your-organization)"
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: プロジェクトボードの編集
|
||||
intro: 既存のプロジェクトボードのタイトルと説明を編集できます。
|
||||
title: 'Editing a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can edit the title and description of an existing {% data variables.projects.projects_v1_board %}.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/editing-a-project-board
|
||||
- /articles/editing-a-project
|
||||
@@ -8,29 +8,27 @@ redirect_from:
|
||||
- /articles/editing-a-project-board
|
||||
- /github/managing-your-work-on-github/editing-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
**ヒント:** プロジェクトボード内での列の追加、削除、編集の詳細については、「[プロジェクトボードの作成](/articles/creating-a-project-board)」を参照してください。
|
||||
**Tip:** For details on adding, removing, or editing columns in your {% data variables.projects.projects_v1_board %}, see "[Creating a {% data variables.product.prodname_project_v1 %}](/articles/creating-a-project-board)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. 編集するプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} you want to edit.
|
||||
{% data reusables.project-management.click-menu %}
|
||||
{% data reusables.project-management.click-edit-sidebar-menu-project-board %}
|
||||
4. プロジェクトボードの名前と説明を必要に応じて修正し、[**Save project**] をクリックします。 ![プロジェクトボードの名前と説明欄に記入し、[Save project] ボタンをクリックします。](/assets/images/help/projects/edit-project-board-save-button.png)
|
||||
4. Modify the {% data variables.projects.projects_v1_board %} name and description as needed, then click **Save project**. ![プロジェクトボードの名前と説明欄に記入し、[Save project] ボタンをクリックします。](/assets/images/help/projects/edit-project-board-save-button.png)
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [プロジェクトボードについて](/articles/about-project-boards)
|
||||
- [プロジェクトボードへの Issue およびプルリクエストの追加](/articles/adding-issues-and-pull-requests-to-a-project-board)
|
||||
- [プロジェクトボードの削除](/articles/deleting-a-project-board)
|
||||
- [{% data variables.product.prodname_projects_v1 %}について](/articles/about-project-boards)
|
||||
- "[Adding issues and pull requests to a {% data variables.product.prodname_project_v1 %}](/articles/adding-issues-and-pull-requests-to-a-project-board)"
|
||||
- "[Deleting a {% data variables.product.prodname_project_v1 %}](/articles/deleting-a-project-board)"
|
||||
|
||||
@@ -1,12 +1,9 @@
|
||||
---
|
||||
title: プロジェクトボードを管理する
|
||||
shortTitle: プロジェクトボードを管理する
|
||||
intro: プロジェクトボードの作成と管理の方法を学んでください
|
||||
title: '{% data variables.product.prodname_projects_v1 %}の管理'
|
||||
shortTitle: '{% data variables.product.prodname_projects_v1 %}の管理'
|
||||
intro: 'Learn how to create and manage {% data variables.projects.projects_v1_boards %}'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
@@ -24,6 +21,7 @@ children:
|
||||
- /deleting-a-project-board
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
@@ -1,27 +1,25 @@
|
||||
---
|
||||
title: リポジトリをプロジェクトボードにリンクする
|
||||
intro: リポジトリをOrganizationもしくは個人アカウントのプロジェクトボードにリンクできます。
|
||||
title: 'Linking a repository to a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can link a repository to your organization''s or personal account''s {% data variables.projects.projects_v1_board %}.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/linking-a-repository-to-a-project-board
|
||||
- /articles/linking-a-repository-to-a-project-board
|
||||
- /github/managing-your-work-on-github/linking-a-repository-to-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: ボードへのリポジトリのリンク
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
プロジェクトボードへの書き込み権限があれば誰でも、その Organization または個人アカウントが所有するリポジトリをプロジェクトボードにリンクできます。 詳細は「[Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-organization/)」または「[ユーザ所有のプロジェクトボードの権限レベル](/articles/permission-levels-for-user-owned-project-boards/)」を参照してください。
|
||||
Anyone with write permissions to a {% data variables.projects.projects_v1_board %} can link repositories owned by that organization or personal account to the {% data variables.projects.projects_v1_board %}. For more information, see "[{% data variables.product.prodname_project_v1_caps %} permissions for an organization](/articles/project-board-permissions-for-an-organization/)" or "[Permission levels for user-owned {% data variables.product.prodname_projects_v1 %}](/articles/permission-levels-for-user-owned-project-boards/)."
|
||||
|
||||
{% data reusables.project-management.link-repos-to-project-board %}Issue またはプルリクエストの URL をカードに入力すると、リンクされていないリポジトリから Issue またはプルリクエストを追加できます。 詳しい情報については、「[プロジェクトボードに Issue およびプルリクエストを追加する](/articles/adding-issues-and-pull-requests-to-a-project-board)」を参照してください。
|
||||
{% data reusables.project-management.link-repos-to-project-board %}Issue またはプルリクエストの URL をカードに入力すると、リンクされていないリポジトリから Issue またはプルリクエストを追加できます。 For more information, see "[Adding issues and pull requests to a {% data variables.product.prodname_project_v1 %}](/articles/adding-issues-and-pull-requests-to-a-project-board)."
|
||||
|
||||
1. リポジトリのリンク先にするプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} where you want to link a repository.
|
||||
{% data reusables.project-management.click-menu %}
|
||||
{% data reusables.project-management.access-collaboration-settings %}
|
||||
4. 左サイドバーで [**Linked repositories**] をクリックします。 ![左サイドバーの [Linked repositories] メニュー オプション](/assets/images/help/projects/project-board-linked-repositories-setting.png)
|
||||
@@ -31,10 +29,10 @@ shortTitle: ボードへのリポジトリのリンク
|
||||
|
||||
{% note %}
|
||||
|
||||
**注釈:** 自分の Organization またはユーザ所有のプロジェクトボードにリポジトリをリンクするには、リポジトリで Issue が有効になっている必要があります。 つまり、リポジトリには [Issue] タブがあるということです（フォークされたリポジトリでは、Issue はデフォルトで無効になっています）。 リポジトリの Issue を有効または無効にする方法については、「[リポジトリの Issue の無効化する](/github/managing-your-work-on-github/disabling-issues)」を参照してください。
|
||||
**Note:** In order to link a repository to your organization or user owned {% data variables.projects.projects_v1_board %} the repository needs to have issues enabled. つまり、リポジトリには [Issue] タブがあるということです（フォークされたリポジトリでは、Issue はデフォルトで無効になっています）。 リポジトリの Issue を有効または無効にする方法については、「[リポジトリの Issue の無効化する](/github/managing-your-work-on-github/disabling-issues)」を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- "[プロジェクトボードについて](/articles/about-project-boards)"
|
||||
- [{% data variables.product.prodname_projects_v1 %}について](/articles/about-project-boards)
|
||||
|
||||
@@ -1,32 +1,30 @@
|
||||
---
|
||||
title: クローズされたプロジェクトボードを再びオープンする
|
||||
intro: クローズされたプロジェクトボードを再びオープンして、プロジェクトボードに設定されているワークフローの自動化を再開できます。
|
||||
title: 'Reopening a closed {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can reopen a closed {% data variables.projects.projects_v1_board %} and restart any workflow automation that was configured for the {% data variables.projects.projects_v1_board %}.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-project-boards/reopening-a-closed-project-board
|
||||
- /articles/reopening-a-closed-project-board
|
||||
- /github/managing-your-work-on-github/reopening-a-closed-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: プロジェクトボードの再オープン
|
||||
shortTitle: 'Reopen {% data variables.product.prodname_project_v1 %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
プロジェクトボードをクローズすると、プロジェクトボードに設定されているワークフロー自動化はデフォルトで一時停止されます。 詳しい情報については[プロジェクトボードのクローズ](/articles/closing-a-project-board)を参照してください。
|
||||
When you close a {% data variables.projects.projects_v1_board %}, any workflow automation that was configured for the {% data variables.projects.projects_v1_board %} will pause by default. For more information, see "[Closing a {% data variables.product.prodname_project_v1 %}](/articles/closing-a-project-board)."
|
||||
|
||||
プロジェクトボードを再びオープンする際、自動化を*同期*するオプションがあります。これにより、ボードに設定されている自動化設定に従って、ボード上のカードの位置を更新します。
|
||||
When you reopen a {% data variables.projects.projects_v1_board %}, you have the option to *sync* automation, which updates the position of the cards on the board according to the automation settings configured for the board.
|
||||
|
||||
1. 再びオープンするプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} you want to reopen.
|
||||
{% data reusables.project-management.click-menu %}
|
||||
3. プロジェクトボードの自動化を同期するか、プロジェクトボードを同期なしで再びオープンするかを選択します。
|
||||
- プロジェクトボードを再びオープンして自動化を同期するには、[**Reopen and sync project**] をクリックします。 
|
||||
- プロジェクトボードを自動化の同期なしで再びオープンするには、再オープンドロップダウンメニューで [**Reopen only**] をクリックします。 続いて、[**Reopen only**] をクリックします。 
|
||||
3. Choose whether to sync automation for your {% data variables.projects.projects_v1_board %} or reopen your {% data variables.projects.projects_v1_board %} without syncing.
|
||||
- To reopen your {% data variables.projects.projects_v1_board %} and sync automation, click **Reopen and sync project**. 
|
||||
- To reopen your {% data variables.projects.projects_v1_board %} without syncing automation, using the reopen drop-down menu, click **Reopen only**. 続いて、[**Reopen only**] をクリックします。 
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- 「[プロジェクトボードの自動化を設定する](/articles/configuring-automation-for-project-boards)」
|
||||
- "[Configuring automation for {% data variables.product.prodname_projects_v1 %}](/articles/configuring-automation-for-project-boards)"
|
||||
|
||||
@@ -1,27 +1,25 @@
|
||||
---
|
||||
title: プロジェクトボードへの Issue およびプルリクエストの追加
|
||||
intro: Issue やプルリクエストはカードの形でプロジェクトボードに追加し、列にトリアージしていくことができます。
|
||||
title: 'Adding issues and pull requests to a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can add issues and pull requests to a {% data variables.projects.projects_v1_board %} in the form of cards and triage them into columns.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards/adding-issues-and-pull-requests-to-a-project-board
|
||||
- /articles/adding-issues-and-pull-requests-to-a-project
|
||||
- /articles/adding-issues-and-pull-requests-to-a-project-board
|
||||
- /github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: ボードへのIssueとPRの追加
|
||||
shortTitle: 'Add issues & PRs to {% data variables.product.prodname_project_v1 %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
以下のようにして、プロジェクトボードに Issue またはプルリクエストカードを追加できます:
|
||||
You can add issue or pull request cards to your {% data variables.projects.projects_v1_board %} by:
|
||||
- サイドバーの [**Triage**] セクションからカードをドラッグする。
|
||||
- Issue またはプルリクエストの URL をカード内に入力する。
|
||||
- プロジェクトボードの検索サイドバーで Issue またはプルリクエストを検索する。
|
||||
- Searching for issues or pull requests in the {% data variables.projects.projects_v1_board %} search sidebar.
|
||||
|
||||
各プロジェクト列には最大 2,500 のカードを置くことができます。 列のカード数が最大に達すると、その列にカードを移動させることはできません。
|
||||
|
||||
@@ -29,28 +27,28 @@ shortTitle: ボードへのIssueとPRの追加
|
||||
|
||||
{% note %}
|
||||
|
||||
**注釈:** ノートをタスクのリマインダ、{% data variables.product.product_name %} 上の任意のリポジトリからの Issue やプルリクエストへの参照、プロジェクトボードへの関連情報の追加として働くようにプロジェクトボードに追加することもできます。 詳細は「[プロジェクトボードにノートを追加する](/articles/adding-notes-to-a-project-board)」を参照してください。
|
||||
**Note:** You can also add notes to your project board to serve as task reminders, references to issues and pull requests from any repository on {% data variables.product.product_name %}, or to add related information to your {% data variables.projects.projects_v1_board %}. 詳細は「[プロジェクトボードにノートを追加する](/articles/adding-notes-to-a-project-board)」を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.project-management.edit-in-project %}
|
||||
|
||||
{% data reusables.project-management.link-repos-to-project-board %}プロジェクトボードに追加するために Issue やプルリクエストを検索する場合、自動的にその検索の対象はリンクされたリポジトリになります。 それらの条件を取り除いて、Organization のすべてのリポジトリを対象に検索することができます。 詳しい情報については、「[リポジトリをプロジェクトボードにリンクする](/articles/linking-a-repository-to-a-project-board)」を参照してください。
|
||||
{% data reusables.project-management.link-repos-to-project-board %} When you search for issues and pull requests to add to your {% data variables.projects.projects_v1_board %}, the search automatically scopes to your linked repositories. それらの条件を取り除いて、Organization のすべてのリポジトリを対象に検索することができます。 詳しい情報については、「[リポジトリをプロジェクトボードにリンクする](/articles/linking-a-repository-to-a-project-board)」を参照してください。
|
||||
|
||||
## プロジェクトボードへの Issue およびプルリクエストの追加
|
||||
## Adding issues and pull requests to a {% data variables.projects.projects_v1_board %}
|
||||
|
||||
1. Issue およびプルリクエストを追加するプロジェクトボードに移動します。
|
||||
2. プロジェクトボードで {% octicon "plus" aria-label="The plus icon" %} [**Add cards**] をクリックします。 
|
||||
3. 検索条件を使って、プロジェクトボードに追加したい Issue と Pull Request を検索してください。 利用できる検索条件に関する詳しい情報については「[Issue を検索する](/articles/searching-issues)」を参照してください。 
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} where you want to add issues and pull requests.
|
||||
2. In your {% data variables.projects.projects_v1_board %}, click {% octicon "plus" aria-label="The plus icon" %} **Add cards**. 
|
||||
3. Search for issues and pull requests to add to your {% data variables.projects.projects_v1_board %} using search qualifiers. 利用できる検索条件に関する詳しい情報については「[Issue を検索する](/articles/searching-issues)」を参照してください。 
|
||||
|
||||
{% tip %}
|
||||
|
||||
**参考:**
|
||||
- Issue あるいはプルリクエストの URL をカード内でタイプして、それらを追加することもできます。
|
||||
- 特定の機能について作業をしているなら、その機能に関連する Issue あるいはプルリクエストにラベルを適用して、そのラベル名を検索することでプロジェクトボードに簡単にカードを追加することができます。 詳細は「[Issue およびプルリクエストへのラベルの適用](/articles/applying-labels-to-issues-and-pull-requests)」を参照してください。
|
||||
- If you're working on a specific feature, you can apply a label to each related issue or pull request for that feature, and then easily add cards to your {% data variables.projects.projects_v1_board %} by searching for the label name. 詳細は「[Issue およびプルリクエストへのラベルの適用](/articles/applying-labels-to-issues-and-pull-requests)」を参照してください。
|
||||
|
||||
{% endtip %}
|
||||
4. フィルタリングされた Issue とプルリクエストのリストから、プロジェクトボードに追加したいカードをドラッグして、正しい列にドロップします。 あるいは、キーボードショートカットを使ってカードを移動させることもできます。 {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %}
|
||||
4. From the filtered list of issues and pull requests, drag the card you'd like to add to your {% data variables.projects.projects_v1_board %} and drop it in the correct column. あるいは、キーボードショートカットを使ってカードを移動させることもできます。 {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
@@ -58,16 +56,16 @@ shortTitle: ボードへのIssueとPRの追加
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## サイドバーからのプロジェクトボードへの Issue およびプルリクエストの追加
|
||||
## Adding issues and pull requests to a {% data variables.projects.projects_v1_board %} from the sidebar
|
||||
|
||||
1. Issue あるいはプルリクエストの右側で、[**Projects {% octicon "gear" aria-label="The Gear icon" %}**] をクリックします。 
|
||||
2. 追加したいプロジェクトボードの [**Recent**]、[**Repository**]、[**User**]、[**Organization**] タブをクリックします。 
|
||||
2. Click the **Recent**, **Repository**,**User**, or **Organization** tab for the {% data variables.projects.projects_v1_board %} you would like to add to. 
|
||||
3. [**Filter projects**] フィールドにプロジェクト名を入力します。 
|
||||
4. Issueまたはプルリクエストを追加する1つ以上のプロジェクトボードを選択します。 
|
||||
5. {% octicon "triangle-down" aria-label="The down triangle icon" %} をクリックし、Issueまたはプルリクエストが必要な列をクリックします。 カードが、選択したプロジェクトボードの列の下部に移動します。 ![[Move card to column] メニュー](/assets/images/help/projects/sidebar-select-project-board-column-menu.png)
|
||||
4. Select one or more {% data variables.projects.projects_v1_boards %} where you want to add the issue or pull request. 
|
||||
5. {% octicon "triangle-down" aria-label="The down triangle icon" %} をクリックし、Issueまたはプルリクエストが必要な列をクリックします。 The card will move to the bottom of the {% data variables.projects.projects_v1_board %} column you select. ![[Move card to column] メニュー](/assets/images/help/projects/sidebar-select-project-board-column-menu.png)
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [プロジェクトボードについて](/articles/about-project-boards)
|
||||
- [プロジェクトボードの編集](/articles/editing-a-project-board)
|
||||
- 「[プロジェクトボードでカードをフィルタリングする](/articles/filtering-cards-on-a-project-board)」
|
||||
- [{% data variables.product.prodname_projects_v1 %}について](/articles/about-project-boards)
|
||||
- "[Editing a {% data variables.product.prodname_project_v1 %}](/articles/editing-a-project-board)"
|
||||
- "[Filtering cards on a {% data variables.product.prodname_project_v1 %}](/articles/filtering-cards-on-a-project-board)"
|
||||
|
||||
@@ -1,19 +1,17 @@
|
||||
---
|
||||
title: プロジェクトボードへのノートの追加
|
||||
intro: タスクリマインダーとして働くノートや、プロジェクトボードに関連する情報を追加するためのノートをプロジェクトボードに追加できます。
|
||||
title: 'Adding notes to a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can add notes to a {% data variables.projects.projects_v1_board %} to serve as task reminders or to add information related to the {% data variables.projects.projects_v1_board %}.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards/adding-notes-to-a-project-board
|
||||
- /articles/adding-notes-to-a-project
|
||||
- /articles/adding-notes-to-a-project-board
|
||||
- /github/managing-your-work-on-github/adding-notes-to-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: ボードへのノートの追加
|
||||
shortTitle: 'Add notes to {% data variables.product.prodname_project_v1 %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
@@ -23,17 +21,17 @@ shortTitle: ボードへのノートの追加
|
||||
**参考:**
|
||||
- ノートは、Markdown の構文で書式設定できます。 たとえばヘッディング、リンク、タスクリスト、絵文字を使うことができます。 詳しい情報については[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax)を参照してください。
|
||||
- ドラッグアンドドロップやキーボードのショートカットを使用してノートを並び替えたり列間で移動させたりできます。 {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %}
|
||||
- ノートを追加するには、少なくとも 1 つの列がプロジェクトボードになければなりません。 詳しい情報については[プロジェクトボードの作成](/articles/creating-a-project-board)を参照してください。
|
||||
- Your {% data variables.projects.projects_v1_board %} must have at least one column before you can add notes. 詳しい情報については[プロジェクトボードの作成](/articles/creating-a-project-board)を参照してください。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
Issue、プルリクエスト、あるいは他のプロジェクトボードの URL をノートに追加すると、テキストの下のサマリーカードにプレビューが表示されます。
|
||||
When you add a URL for an issue, pull request, or another {% data variables.projects.projects_v1_board %} to a note, you'll see a preview in a summary card below your text.
|
||||
|
||||
|
||||
|
||||
## プロジェクトボードへのノートの追加
|
||||
## Adding notes to a {% data variables.projects.projects_v1_board %}
|
||||
|
||||
1. ノートを追加したいプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} where you want to add notes.
|
||||
2. ノートを追加したい列で {% octicon "plus" aria-label="The plus icon" %} をクリックします。 
|
||||
3. ノートを入力し、[**Add**] をクリックします。 
|
||||
|
||||
@@ -51,17 +49,17 @@ Issue、プルリクエスト、あるいは他のプロジェクトボードの
|
||||
|
||||
{% tip %}
|
||||
|
||||
**ヒント:** ノートの本体には誰かへの @メンション、他の Issue あるいはプルリクエストへのリンクを追加したり、絵文字を追加したりできます。 これらの {% data variables.product.prodname_dotcom %}形式の Markdown の機能はプロジェクトボードのノート内ではサポートされていませんが、ノートが Issue に変換されれば、正しく表示されるようになります。 これらの機能の使い方に関する詳しい情報については[{% data variables.product.prodname_dotcom %}上での書き込みと書式設定について](/articles/about-writing-and-formatting-on-github)を参照してください。
|
||||
**ヒント:** ノートの本体には誰かへの @メンション、他の Issue あるいはプルリクエストへのリンクを追加したり、絵文字を追加したりできます。 These {% data variables.product.prodname_dotcom %} Flavored Markdown features aren't supported within {% data variables.projects.projects_v1_board %} notes, but once your note is converted to an issue, they'll appear correctly. これらの機能の使い方に関する詳しい情報については[{% data variables.product.prodname_dotcom %}上での書き込みと書式設定について](/articles/about-writing-and-formatting-on-github)を参照してください。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. Issue に変換したいノートにアクセスしてください。
|
||||
{% data reusables.project-management.project-note-more-options %}
|
||||
3. [**Convert to issue**] をクリックします。 ![[Convert to issue] ボタン](/assets/images/help/projects/convert-to-issue.png)
|
||||
4. カードが Organization 全体のプロジェクトボード上にあるなら、ドロップダウンメニューから Issue を追加したいリポジトリを選択してください。 
|
||||
4. If the card is on an organization-wide {% data variables.projects.projects_v1_board %}, in the drop-down menu, choose the repository you want to add the issue to. 
|
||||
5. 事前に記入された Issue のタイトルを編集することもできます。そして Issue の本文を入力してください。 
|
||||
6. [**Convert to issue**] をクリックします。
|
||||
7. ノートは自動的に Issue に変換されます。 プロジェクトボードでは、新しい Issue のカードが以前のノートと同じ場所に置かれます。
|
||||
7. ノートは自動的に Issue に変換されます。 In the {% data variables.projects.projects_v1_board %}, the new issue card will be in the same location as the previous note.
|
||||
|
||||
## ノートの編集と削除
|
||||
|
||||
@@ -72,7 +70,7 @@ Issue、プルリクエスト、あるいは他のプロジェクトボードの
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [プロジェクトボードについて](/articles/about-project-boards)
|
||||
- [プロジェクトボードの作成](/articles/creating-a-project-board)
|
||||
- [プロジェクトボードの編集](/articles/editing-a-project-board)
|
||||
- [プロジェクトボードへの Issue およびプルリクエストの追加](/articles/adding-issues-and-pull-requests-to-a-project-board)
|
||||
- [{% data variables.product.prodname_projects_v1 %}について](/articles/about-project-boards)
|
||||
- [{% data variables.product.prodname_project_v1 %}を作成する](/articles/creating-a-project-board)
|
||||
- "[Editing a {% data variables.product.prodname_project_v1 %}](/articles/editing-a-project-board)"
|
||||
- "[Adding issues and pull requests to a {% data variables.product.prodname_project_v1 %}](/articles/adding-issues-and-pull-requests-to-a-project-board)"
|
||||
|
||||
@@ -1,31 +1,29 @@
|
||||
---
|
||||
title: プロジェクトボード上のカードのアーカイブ
|
||||
intro: プロジェクトボードのカードをアーカイブすることにより、プロジェクトの過去の経過を失うことなくワークフローを整理できます。
|
||||
title: 'Archiving cards on a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can archive {% data variables.projects.projects_v1_board %} cards to declutter your workflow without losing the historical context of a project.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards/archiving-cards-on-a-project-board
|
||||
- /articles/archiving-cards-on-a-project-board
|
||||
- /github/managing-your-work-on-github/archiving-cards-on-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: ボード上のカードのアーカイブ
|
||||
shortTitle: 'Archive cards on {% data variables.product.prodname_project_v1 %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
プロジェクトボードの自動化は、アーカイブされたプロジェクトボードのカードには適用されません。 たとえばプロジェクトボードのアーカイブで Issue をクローズしたとしても、アーカイブされたカードは自動的に "Done" 列には移動しません。 プロジェクトボードアーカイブからカードをリストアすると、そのカードはアーカイブされたときに置かれていた列に戻ります。
|
||||
Automation in your {% data variables.projects.projects_v1_board %} does not apply to archived {% data variables.projects.projects_v1_board %} cards. For example, if you close an issue in a {% data variables.projects.projects_v1_board %}'s archive, the archived card does not automatically move to the "Done" column. When you restore a card from the {% data variables.projects.projects_v1_board %} archive, the card will return to the column where it was archived.
|
||||
|
||||
## プロジェクトボード上のカードのアーカイブ
|
||||
## Archiving cards on a {% data variables.projects.projects_v1_board %}
|
||||
|
||||
1. プロジェクトボードで、アーカイブしたいカードを見つけて {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックします。 
|
||||
1. In a {% data variables.projects.projects_v1_board %}, find the card you want to archive, then click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. 
|
||||
2. [**Archive**] をクリックします。 
|
||||
|
||||
## サイドバーからのプロジェクトボード上のカードのリストア
|
||||
## Restoring cards on a {% data variables.projects.projects_v1_board %} from the sidebar
|
||||
|
||||
{% data reusables.project-management.click-menu %}
|
||||
2. {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックし、続いて [** View archive**] をクリックします。 
|
||||
3. アーカイブを解除するプロジェクトボードの上で [**Restore**] をクリックします。 
|
||||
3. Above the {% data variables.projects.projects_v1_board %} card you want to unarchive, click **Restore**. 
|
||||
|
||||
@@ -1,25 +1,23 @@
|
||||
---
|
||||
title: プロジェクトボードでカードをフィルタリングする
|
||||
intro: プロジェクトボード上のカードをフィルタリングして、特定のカードを検索したりカードのサブセットを表示したりできます。
|
||||
title: 'Filtering cards on a {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can filter the cards on a {% data variables.projects.projects_v1_board %} to search for specific cards or view a subset of the cards.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards/filtering-cards-on-a-project-board
|
||||
- /articles/filtering-cards-on-a-project-board
|
||||
- /github/managing-your-work-on-github/filtering-cards-on-a-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: ボード上のカードのフィルタ
|
||||
shortTitle: 'Filter cards on {% data variables.product.prodname_project_v1 %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
カードでは、任意のアサインされた人、マイルストーン、またはラベルをクリックして、その修飾子でプロジェクトをフィルタリングできます。 検索をクリアするには、同じアサインされた人、マイルストーン、またはラベルを再度クリックします。
|
||||
On a card, you can click any assignee, milestone, or label to filter the {% data variables.projects.projects_v1_board %} by that qualifier. 検索をクリアするには、同じアサインされた人、マイルストーン、またはラベルを再度クリックします。
|
||||
|
||||
また、各プロジェクトボードの上部にある [Filter cards] 検索バーを使用して、カードを検索することも可能です。 以下の検索修飾子をさまざまに組み合わせて使用したり、検索したいテキストを入力したりすることで、カードをフィルタリングできます。
|
||||
You can also use the "Filter cards" search bar at the top of each {% data variables.projects.projects_v1_board %} to search for cards. 以下の検索修飾子をさまざまに組み合わせて使用したり、検索したいテキストを入力したりすることで、カードをフィルタリングできます。
|
||||
|
||||
- `author:USERNAME` を使用してカードを作者でフィルタする
|
||||
- `assignee:USERNAME` または `no:assignee` を使用して、カードをアサインされた人でフィルタリングする
|
||||
@@ -31,9 +29,9 @@ shortTitle: ボード上のカードのフィルタ
|
||||
- `type:issue`、`type:pr`、または `type:note` を使用して、カードをタイプでフィルタリングする
|
||||
- `is:open`、`is:closed`、または `is:merged`と、`is:issue`、`is:pr`、または `is:note` とを使用して、カードをステータスとタイプでフィルタリングする
|
||||
- `linked:pr`を使用したクローズしているリファレンスによってプルリクエストにリンクされているIssueのフィルタリング
|
||||
- `repo:ORGANIZATION/REPOSITORY` を使用して、Organization 全体のプロジェクトボード内のリポジトリでカードをフィルタリングする
|
||||
- Filter cards by repository in an organization-wide {% data variables.projects.projects_v1_board %} using `repo:ORGANIZATION/REPOSITORY`
|
||||
|
||||
1. フィルタリングしたいカードが含まれるプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} that contains the cards you want to filter.
|
||||
2. プロジェクトのカード列の上で、[Filter cards] 検索バーをクリックして検索クエリを入力し、カードをフィルタリングします。 
|
||||
|
||||
{% tip %}
|
||||
@@ -44,6 +42,6 @@ shortTitle: ボード上のカードのフィルタ
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [プロジェクトボードについて](/articles/about-project-boards)
|
||||
- [プロジェクトボードへの Issue およびプルリクエストの追加](/articles/adding-issues-and-pull-requests-to-a-project-board)
|
||||
- 「[プロジェクトボードにノートを追加する](/articles/adding-notes-to-a-project-board)」
|
||||
- [{% data variables.product.prodname_projects_v1 %}について](/articles/about-project-boards)
|
||||
- "[Adding issues and pull requests to a {% data variables.product.prodname_project_v1 %}](/articles/adding-issues-and-pull-requests-to-a-project-board)"
|
||||
- "[Adding notes to a {% data variables.product.prodname_project_v1 %}](/articles/adding-notes-to-a-project-board)"
|
||||
|
||||
@@ -1,12 +1,9 @@
|
||||
---
|
||||
title: プロジェクトボードで進捗を追跡する
|
||||
shortTitle: プロジェクトの追跡
|
||||
intro: プロジェクトボードで作業を追跡する方法を学んでください
|
||||
title: 'Tracking progress on your {% data variables.product.prodname_projects_v1 %}'
|
||||
shortTitle: 'Tracking {% data variables.product.prodname_projects_v1 %}'
|
||||
intro: 'Learn how to track your work on {% data variables.projects.projects_v1_board %}'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
@@ -18,6 +15,7 @@ children:
|
||||
- /archiving-cards-on-a-project-board
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
@@ -1,25 +1,23 @@
|
||||
---
|
||||
title: プロジェクトボードで進捗を追跡する
|
||||
intro: プロジェクトの進捗全体は、プログレスバーで確認できます。
|
||||
title: 'Tracking progress on your {% data variables.product.prodname_project_v1 %}'
|
||||
intro: 'You can see the overall progress of your {% data variables.projects.projects_v1_board %} in a progress bar.'
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards/tracking-progress-on-your-project-board
|
||||
- /articles/tracking-progress-on-your-project-board
|
||||
- /github/managing-your-work-on-github/tracking-progress-on-your-project-board
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v1
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: ボードでの進捗の追跡
|
||||
shortTitle: 'Track progress on {% data variables.product.prodname_project_v1 %}'
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.project_boards_old %}
|
||||
|
||||
{% data reusables.project-management.project-progress-locations %}
|
||||
|
||||
1. プロジェクトの進捗の追跡を有効化または無効化したいプロジェクトボードに移動します。
|
||||
1. Navigate to the {% data variables.projects.projects_v1_board %} where you want to enable or disable project progress tracking.
|
||||
{% data reusables.project-management.click-menu %}
|
||||
{% data reusables.project-management.click-edit-sidebar-menu-project-board %}
|
||||
4. [**Track project progress**] を選択または選択解除します。
|
||||
|
||||
@@ -1,33 +1,18 @@
|
||||
---
|
||||
title: プロジェクト（ベータ）の自動化
|
||||
intro: '組み込みのワークフロー、あるいはAPIと{% data variables.product.prodname_actions %}を使ってプロジェクトを管理できます。'
|
||||
allowTitleToDifferFromFilename: true
|
||||
title: 'Automating {% data variables.product.prodname_projects_v2 %} using Actions'
|
||||
shortTitle: Automating with Actions
|
||||
intro: 'You can use {% data variables.product.prodname_actions %} to automate your projects.'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/automating-projects
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
- Workflows
|
||||
- Project management
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data reusables.projects.projects-beta %}
|
||||
|
||||
{% data reusables.projects.graphql-deprecation %}
|
||||
|
||||
## はじめに
|
||||
|
||||
プロジェクトの管理に役立つ自動化を追加できます。 プロジェクト（ベータ）には、UIを通じて設定できる組み込みのワークフローが含まれています。 加えて、GraphQL APIと{% data variables.product.prodname_actions %}でカスタムのワークフローを書くことができます。
|
||||
|
||||
## 組み込みのワークフロー
|
||||
|
||||
{% data reusables.projects.about-workflows %}
|
||||
|
||||
プロジェクトでは、組み込みのワークフローを有効化あるいは無効化できます。
|
||||
|
||||
{% data reusables.projects.enable-basic-workflow %}
|
||||
|
||||
## {% data variables.product.prodname_actions %}のワークフロー
|
||||
|
||||
@@ -39,11 +24,13 @@ topics:
|
||||
|
||||
この記事は、{% data variables.product.prodname_actions %}を基本的に理解していることを前提としています。 {% data variables.product.prodname_actions %}に関する詳しい情報については「[{% data variables.product.prodname_actions %}](/actions) 」を参照してください。
|
||||
|
||||
APIを通じてプロジェクトに対して行える他の変更に関する情報については「[APIを使ったプロジェクトの管理](/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects)」を参照してください。
|
||||
APIを通じてプロジェクトに対して行える他の変更に関する情報については「[APIを使ったプロジェクトの管理](/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)」を参照してください。
|
||||
|
||||
You may also want to use the **actions/add-to-project** workflow, which is maintained by {% data variables.product.company_short %} and will add the current issue or pull request to the project specified. For more information, see the [actions/add-to-project](https://github.com/actions/add-to-project) repository and README.
|
||||
|
||||
{% note %}
|
||||
|
||||
**ノート:** `GITHUB_TOKEN`はリポジトリレベルをスコープとしており、プロジェクト（ベータ）にはアクセスできません。 プロジェクト（ベータ）にアクセスするには、{% data variables.product.prodname_github_app %}（Organizationプロジェクトの場合に推奨）もしくは個人アクセストークン（ユーザプロジェクトの場合に推奨）を作成できます。 以下には、どちらの方法のワークフローの例も示します。
|
||||
**Note:** `GITHUB_TOKEN` is scoped to the repository level and cannot access {% data variables.projects.projects_v2 %}. To access {% data variables.projects.projects_v2 %} you can either create a {% data variables.product.prodname_github_app %} (recommended for organization projects) or a personal access token (recommended for user projects). 以下には、どちらの方法のワークフローの例も示します。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -61,11 +48,13 @@ APIを通じてプロジェクトに対して行える他の変更に関する
|
||||
3. Organizationに{% data variables.product.prodname_github_app %}をインストールしてください。 プロジェクトがアクセスする必要があるすべてのリポジトリにインストールしてください。 詳しい情報については「[{% data variables.product.prodname_github_apps %}のインストール](/developers/apps/managing-github-apps/installing-github-apps#installing-your-private-github-app-on-your-repository)」を参照してください。
|
||||
4. {% data variables.product.prodname_github_app %}のIDを、リポジトリもしくはOrganizationのシークレットとして保存してください。 以下のワークフローでは、`APP_ID`をシークレット名に置き換えてください。 アプリケーションIDは、アプリケーションの設定ページで、あるいはアプリケーションのAPIを通じて確認できます。 詳しい情報については「[アプリケーション](/rest/reference/apps#get-an-app)」を参照してください。
|
||||
5. アプリケーションの秘密鍵を生成してください。 作成されたファイルの内容を、シークレットとしてリポジトリもしくはOrganizationに保存してください。 （ファイルの内容は、`-----BEGIN RSA PRIVATE KEY-----` and `-----END RSA PRIVATE KEY-----`という部分も含めて全体をほぞんしてください。） 以下のワークフローでは、`APP_PEM`をシークレットの名前に置き換えてください。 詳しい情報については「[{% data variables.product.prodname_github_apps %}での認証](/developers/apps/building-github-apps/authenticating-with-github-apps#generating-a-private-key)」を参照してください。
|
||||
6. 以下のワークフローでは、`YOUR_ORGANIZATION`をOrganizationの名前で置き換えてください。 たとえば`octo-org`というようにします。 `YOUR_PROJECT_NUMBER`は、プロジェクトの番号で置き換えてください。 プロジェクト番号を知るには、プロジェクトのURLを見てください。 たとえば`https://github.com/orgs/octo-org/projects/5`ではプロジェクト番号は5です。
|
||||
6. 以下のワークフローでは、`YOUR_ORGANIZATION`をOrganizationの名前で置き換えてください。 たとえば`octo-org`というようにします。 `YOUR_PROJECT_NUMBER`は、プロジェクトの番号で置き換えてください。 プロジェクト番号を見つけるには、プロジェクトのURLを見てください。 たとえば`https://github.com/orgs/octo-org/projects/5`ではプロジェクト番号は5です。
|
||||
|
||||
```yaml{:copy}
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
{% data reusables.actions.actions-use-sha-pinning-comment %}
|
||||
|
||||
name: Add PR to project
|
||||
on:
|
||||
pull_request:
|
||||
@@ -182,7 +171,7 @@ jobs:
|
||||
|
||||
1. `project`及び`repo`スコープを持つ個人アクセストークンを作成します。 詳しい情報については、「[個人アクセストークンを作成する](/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token)」を参照してください。
|
||||
2. この個人アクセストークンをシークレットとしてリポジトリもしくはOrganizationに保存します。
|
||||
3. 以下のワークフローでは、`YOUR_TOKEN`をそのシークレットの名前で置き換えてください。 `YOUR_ORGANIZATION`をOrganizationの名前で置き換えてください。 たとえば`octo-org`というようにします。 `YOUR_PROJECT_NUMBER`は、プロジェクトの番号で置き換えてください。 プロジェクト番号を知るには、プロジェクトのURLを見てください。 たとえば`https://github.com/orgs/octo-org/projects/5`ではプロジェクト番号は5です。
|
||||
3. 以下のワークフローでは、`YOUR_TOKEN`をそのシークレットの名前で置き換えてください。 `YOUR_ORGANIZATION`をOrganizationの名前で置き換えてください。 たとえば`octo-org`というようにします。 `YOUR_PROJECT_NUMBER`は、プロジェクトの番号で置き換えてください。 プロジェクト番号を見つけるには、プロジェクトのURLを見てください。 たとえば`https://github.com/orgs/octo-org/projects/5`ではプロジェクト番号は5です。
|
||||
|
||||
```yaml{:copy}
|
||||
name: Add PR to project
|
||||
@@ -370,7 +359,7 @@ env:
|
||||
<code>YOUR_ORGANIZATION</code>をOrganization名で置き換えてください。 たとえば<code>octo-org</code>というようにします。
|
||||
<br>
|
||||
<br>
|
||||
<code>YOUR_PROJECT_NUMBER</code>をプロジェクト番号で置き換えてください。 プロジェクト番号を知るには、プロジェクトのURLを見てください。 たとえば<code>https://github.com/orgs/octo-org/projects/5</code>ではプロジェクト番号は5です。
|
||||
<code>YOUR_PROJECT_NUMBER</code>をプロジェクト番号で置き換えてください。 プロジェクト番号を見つけるには、プロジェクトのURLを見てください。 たとえば<code>https://github.com/orgs/octo-org/projects/5</code>ではプロジェクト番号は5です。
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
@@ -0,0 +1,16 @@
|
||||
---
|
||||
title: 'Automating your {% data variables.projects.project_v2 %}'
|
||||
shortTitle: 'Automating {% data variables.projects.projects_v2 %}'
|
||||
intro: 'Learn how to use the built-in workflows, {% data variables.product.prodname_actions %}, and the API to automate your projects.'
|
||||
versions:
|
||||
feature: projects-v2
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
children:
|
||||
- /using-the-built-in-automations
|
||||
- /using-the-api-to-manage-projects
|
||||
- /automating-projects-using-actions
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
@@ -1,22 +1,22 @@
|
||||
---
|
||||
title: APIを使ったプロジェクト（ベータ）の管理
|
||||
intro: GraphQL APIを使って、プロジェクトに関する情報を見つけたり、プロジェクトを更新したりできます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
title: 'Using the API to manage {% data variables.product.prodname_projects_v2 %}'
|
||||
shortTitle: Automating with the API
|
||||
intro: You can use the GraphQL API to automate your projects.
|
||||
miniTocMaxHeadingLevel: 3
|
||||
allowTitleToDifferFromFilename: true
|
||||
type: how_to
|
||||
versions:
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
この記事では、GraphQL API を使用してプロジェクトを管理する方法を説明します。 For more information about how to use the API in a {% data variables.product.prodname_actions %} workflow, see "[Automating {% data variables.product.prodname_projects_v2 %} using Actions](/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions)." 利用可能なデータタイプの完全なリストについては「[リファレンス](/graphql/reference)」を参照してください。
|
||||
|
||||
{% data reusables.projects.graphql-deprecation %}
|
||||
|
||||
この記事では、GraphQL API を使用してプロジェクトを管理する方法を説明します。 {% data variables.product.prodname_actions %}ワークフローでのAPIの使用方法に関する詳しい情報については「[プロジェクト（ベータ）の自動化](/issues/trying-out-the-new-projects-experience/automating-projects)」を参照してください。 利用可能なデータタイプの完全なリストについては「[リファレンス](/graphql/reference)」を参照してください。
|
||||
|
||||
{% data reusables.projects.projects-beta %}
|
||||
|
||||
## 認証
|
||||
|
||||
{% curl %}
|
||||
@@ -64,7 +64,7 @@ gh api graphql -f query='
|
||||
|
||||
APIを通じてプロジェクトを更新するには、プロジェクトのノードIDを知る必要があります。
|
||||
|
||||
Organization名とプロジェクト番号が分かっていれば、OrganizationプロジェクトのノードIDを知ることができます。 `ORGANIZATION`をOrganization名で置き換えてください。 たとえば`octo-org`というようにします。 `NUMBER`をプロジェクト番号で置き換えてください。 プロジェクト番号を知るには、プロジェクトのURLを見てください。 たとえば`https://github.com/orgs/octo-org/projects/5`ではプロジェクト番号は5です。
|
||||
Organization名とプロジェクト番号が分かっていれば、OrganizationプロジェクトのノードIDを知ることができます。 `ORGANIZATION`をOrganization名で置き換えてください。 たとえば`octo-org`というようにします。 `NUMBER`をプロジェクト番号で置き換えてください。 プロジェクト番号を見つけるには、プロジェクトのURLを見てください。 たとえば`https://github.com/orgs/octo-org/projects/5`ではプロジェクト番号は5です。
|
||||
|
||||
{% curl %}
|
||||
```shell
|
||||
@@ -119,7 +119,7 @@ gh api graphql -f query='
|
||||
|
||||
APIを通じてプロジェクトを更新するには、プロジェクトのノードIDを知る必要があります。
|
||||
|
||||
ユーザプロジェクトのノードIDは、プロジェクト番号を知っていれば見つけることができます。 `USER`を自分のユーザ名で置き換えてください。 `octocat`などです。 `NUMBER`はプロジェクト番号で置き換えてください。 プロジェクト番号を知るには、プロジェクトのURLを見てください。 たとえば`https://github.com/users/octocat/projects/5`のプロジェクト番号は5です。
|
||||
ユーザプロジェクトのノードIDは、プロジェクト番号を知っていれば見つけることができます。 `USER`を自分のユーザ名で置き換えてください。 `octocat`などです。 `NUMBER`はプロジェクト番号で置き換えてください。 プロジェクト番号を見つけるには、プロジェクトのURLを見てください。 たとえば`https://github.com/users/octocat/projects/5`のプロジェクト番号は5です。
|
||||
|
||||
{% curl %}
|
||||
```shell
|
||||
@@ -714,3 +714,7 @@ gh api graphql -f query='
|
||||
}'
|
||||
```
|
||||
{% endcli %}
|
||||
|
||||
## Using webhooks
|
||||
|
||||
You can use webhooks to subscribe to events taking place in your project. For example, when an item is edited, {% data variables.product.product_name %} can send a HTTP POST payload to the webhook's configured URL which can trigger automation on your server. For more information about webhooks, see "[About webhooks](/developers/webhooks-and-events/webhooks/about-webhooks)." To learn more about the `projects_v2_item` webhook event, see "[Webhook events and payloads](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#projects_v2_item)."
|
||||
@@ -0,0 +1,23 @@
|
||||
---
|
||||
title: Using the built-in automations
|
||||
shortTitle: Using built-in automations
|
||||
intro: You can use built-in workflows to automate your projects.
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
---
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Built-in workflows are available as part of a limited beta.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.projects.about-workflows %}
|
||||
|
||||
プロジェクトでは、組み込みのワークフローを有効化あるいは無効化できます。
|
||||
|
||||
{% data reusables.projects.enable-basic-workflow %}
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: '{% data variables.projects.project_v2 %}の作成'
|
||||
intro: Learn how to create an organization or user project.
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/creating-a-project
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
{% data variables.product.prodname_projects_v2 %} are an adaptable collection of items that stay up-to-date with {% data variables.product.company_short %} data. Your projects can track issues, pull requests, and ideas that you note down. カスタムフィールドを追加して、特定の目的のためのビューを作成できます。
|
||||
|
||||
## プロジェクトの作成
|
||||
|
||||
### Organizationプロジェクトの作成
|
||||
|
||||
Organization projects can track issues and pull requests from the organization's repositories.
|
||||
|
||||
{% data reusables.projects.create-project %}
|
||||
|
||||
### ユーザプロジェクトの作成
|
||||
|
||||
User projects can track issues and pull requests from the repositories owned by your personal account.
|
||||
|
||||
{% data reusables.projects.create-user-project %}
|
||||
|
||||
## プロジェクトの説明とREADMEの更新
|
||||
|
||||
{% data reusables.projects.project-description %}
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- "[Adding your project to a repository](/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-repository)"
|
||||
- "[Adding items to your project](/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project)"
|
||||
- "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)"
|
||||
@@ -0,0 +1,15 @@
|
||||
---
|
||||
title: 'Creating {% data variables.projects.projects_v2 %}'
|
||||
shortTitle: 'Creating {% data variables.projects.projects_v2 %}'
|
||||
intro: 'Learn about creating projects and migrating your {% data variables.projects.projects_v1_boards %}.'
|
||||
versions:
|
||||
feature: projects-v2
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
children:
|
||||
- /creating-a-project
|
||||
- /migrating-from-projects-classic
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
@@ -1,23 +1,24 @@
|
||||
---
|
||||
title: プロジェクトのプロジェクト（ベータ）への移行
|
||||
intro: 古いプロジェクトの体験から、プロジェクトをプロジェクト（ベータ）へ移行できます。
|
||||
allowTitleToDifferFromFilename: true
|
||||
miniTocMaxHeadingLevel: 2
|
||||
title: 'Migrating from {% data variables.product.prodname_projects_v1 %}'
|
||||
intro: 'You can migrate your {% data variables.projects.projects_v1_board %} to the new {% data variables.product.prodname_projects_v2 %} experience.'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/migrating-your-project
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
- Organizations
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
**ノート:**
|
||||
|
||||
- プロジェクト（ベータ）は現在パブリックベータであり、変更されることがあります。
|
||||
- 移行しようとしているプロジェクトが1200以上のアイテムを含む場合、オープンなIssueが優先され、そのあとにオープンなPull Request、そしてノートが続きます。 残りの領域はクローズされたIssue、マージされたPull Request、クローズされたあPull Requestに使われます。 この制限のために移行できなかったアイテムは、アーカイブに移されます。 アーカイブの限度である10,000アイテムに達すると、それ以降のアイテムは移行されません。
|
||||
- カードはドラフトのIssueに変換され、その内容はドラフトのIssueの本文に保存されることに注意してください。 情報が欠落しているように見える場合は、非表示のフィールドを見えるようにしてください。 詳しい情報については「[非表示のフィールドの表示](/issues/trying-out-the-new-projects-experience/customizing-your-project-views#showing-and-hiding-fields)」を参照してください。
|
||||
- カードはドラフトのIssueに変換され、その内容はドラフトのIssueの本文に保存されることに注意してください。 情報が欠落しているように見える場合は、非表示のフィールドを見えるようにしてください。 詳しい情報については「[非表示のフィールドの表示](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view#showing-and-hiding-fields)」を参照してください。
|
||||
- オートメーションは移行されません。
|
||||
- トリアージ、アーカイブ、アクティビティは移行されません。
|
||||
- 移行のあと、移行された新しいプロジェクトと古いプロジェクトの同期は取られません。
|
||||
@@ -26,7 +27,7 @@ topics:
|
||||
|
||||
## プロジェクトの移行について
|
||||
|
||||
プロジェクトボードを、完全に新しいプロジェクト（ベータ）の体験に移行できます。テーブル、複数のビュー、新しい自動化のオプション、強力なフィールドタイプを試してみてください。 詳しい情報については「[プロジェクト（ベータ）](/issues/trying-out-the-new-projects-experience/about-projects)について」を参照してください。
|
||||
You can migrate your project boards to the new {% data variables.product.prodname_projects_v2 %} experience and try out tables, multiple views, new automation options, and powerful field types. For more information, see "[About projects](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)."
|
||||
|
||||
## Organizationのプロジェクトボードの移行
|
||||
|
||||
@@ -49,7 +50,7 @@ topics:
|
||||
|
||||
{% note %}
|
||||
|
||||
**ノート:** プロジェクト（ベータ）は、リポジトリレベルのプロジェクトをサポートしていません。 リポジトリプロジェクトボードを移行する場合、リポジトリプロジェクトを所有しているOrganizationもしくは個人アカウントに移行することになり、移行されたプロジェクトはオリジナルのリポジトリにピン止めされます。
|
||||
**Note:** {% data variables.projects.projects_v2_caps %} does not support repository level projects. リポジトリプロジェクトボードを移行する場合、リポジトリプロジェクトを所有しているOrganizationもしくは個人アカウントに移行することになり、移行されたプロジェクトはオリジナルのリポジトリにピン止めされます。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -0,0 +1,98 @@
|
||||
---
|
||||
title: Customizing a view
|
||||
intro: 'Display the information you need by changing the layout, grouping, sorting in your project.'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/customizing-your-project-views
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
---
|
||||
|
||||
|
||||
## プロジェクトレイアウトの変更
|
||||
|
||||
プロジェクトを、テーブルまたはボードとして見ることができます。
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Under "Layout", click either **Table** or **Board**. 
|
||||
|
||||
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Switch layout."
|
||||
|
||||
## フィールドの表示と非表示
|
||||
|
||||
特定のフィールドを表示または非表示にできます。
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Under "Configuration", click {% octicon "note" aria-label="the note icon" %} and the list of currently shown fields. 
|
||||
1. Select or deselect the fields you want to show or hide. 
|
||||
|
||||
You can also hide individual fields in table view.
|
||||
|
||||
1. Next to the field you want to hide, click {% octicon "kebab-horizontal" aria-label="the kebab icon" %}. 
|
||||
1. Click {% octicon "eye-closed" aria-label="the eye closed icon" %} **Hide field**. 
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "show", "hide", or the name of the field.
|
||||
|
||||
## フィールドの並び替え
|
||||
|
||||
In table layout, you can change the order of fields.
|
||||
|
||||
1. Click the field header. 
|
||||
2. While continuing to click, drag the field to the required location.
|
||||
|
||||
## 行の並び替え
|
||||
|
||||
テーブルレイアウトでは、行の順序を変更できます。
|
||||
|
||||
1. Click the number at the start of the row. 
|
||||
2. While continuing to click, drag the row to the required location.
|
||||
|
||||
## フィールドの値でソート
|
||||
|
||||
テーブルレイアウトでは、フィールドの値でアイテムをソートできます。
|
||||
|
||||
{% note %}
|
||||
|
||||
**ノート:** テーブルがソートされると、手動で行を並び替えることはできなくなります。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click **Sort**. 
|
||||
1. Click the field you want to sort by. 
|
||||
2. Optionally, to change the direction of the sort, click {% octicon "sort-desc" aria-label="the sort icon" %}. 
|
||||
3. Optionally, to remove a sort, click {% octicon "x" aria-label="the x icon" %} **No sorting** at the bottom of the list. 
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Sort by."
|
||||
|
||||
## テーブルレイアウト内のフィールドの値でグループ化
|
||||
|
||||
テーブルレイアウトでは、カスタムフィールドの値でアイテムをグループ化できます。 アイテムがグループ化されると、アイテムを新しいグループにドラッグした場合、そのグループの値が適用されます。 たとえば"Status"でグループ化して、ステータスが`In progress`のアイテムを`Done`グループにドラッグすると、そのアイテムのステータスは`Done`に切り替わります。 同様に、新しいアイテムをグループに追加すると、新しいアイテムにはそのグループの値が展開されます。
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** You cannot group by title, labels, reviewers, or linked pull requests.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click {% octicon "rows" aria-label="the rows icon" %} **Group**. 
|
||||
1. Click the field you want to group by. 
|
||||
2. Optionally, to disable grouping, click {% octicon "x" aria-label="the x icon" %} **No grouping** at the bottom of the list. 
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Group by."
|
||||
|
||||
## ボードレイアウトでの列フィールドの設定
|
||||
|
||||
ボードレイアウトでは、列に対して任意の単一選択あるいは繰り返しフィールドを選択します。 アイテムを新しい列にドラッグすると、その列の値がドラッグされたアイテムに適用されます。 たとえば、ボードの列に"Status"フィールドを使い、ステータスが`In progress`のアイテムを`Done`列にドラッグすると、そのアイテムのステータスは`Done`に切り替わります。
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click {% octicon "columns" aria-label="the columns icon" %} **Column field**. 
|
||||
1. Click the field you want to use. 
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Column field by."
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: 'Filtering {% data variables.projects.projects_v2 %}'
|
||||
intro: Use filters to choose which items appear in your project's views.
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/filtering-projects
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
Issueにアサインされた人やラベルといったアイテムのメタデータやプロジェクトのフィールドに対するフィルタを使って、ビューをカスタマイズできます。 フィルタを組み合わせて、ビューとして保存できます。 詳しい情報については「[プロジェクトのビューのカスタマイズ](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)」を参照してください。
|
||||
|
||||
プロジェクトをフィルタするには、{% octicon "filter" aria-label="The Filter icon" %}をクリックし、フィルタリングしたいフィールドとその値を入力していってください。 入力していくと、利用できる値が表示されます。 You can also open the project command palette, by pressing {% data variables.projects.command-palette-shortcut %}, and type "Filter by" to choose from the available filters.
|
||||
|
||||
Using multiple filters will act as a logical AND filter. For example, `label:bug status:"In progress"` will return items with the `bug` label with the "In progress" status. {% data variables.product.prodname_projects_v2 %} does not currently support logical OR filters across multiple fields.
|
||||
|
||||
The same filters are available for charts you create using insights for {% data variables.product.prodname_projects_v2 %}, allowing you to filter the data used to create your charts. 詳しい情報については「[プロジェクトでのインサイトの利用](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects)」を参照してください。
|
||||
|
||||
## アイテムのフィルタリング
|
||||
|
||||
テーブルの上部にある{% octicon "filter" aria-label="the filter icon" %}をクリックして、"Filter by keyword or by field（キーワードもしくはフィールドでフィルタ）"バーを表示させてください。 フィルタに使いたいフィールド名及び値を入力し始めてください。 入力していくと、利用できる値が表示されます。
|
||||
|
||||
{% data reusables.projects.projects-filters %}
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Filter by."
|
||||
|
||||
ボードレイアウトでは、アイテムデータをクリックして、その値を持つアイテムにフィルタリングできます。 たとえば、アサインされた人をクリックして、そのアサインされた人のアイテムだけを表示させられます。 このフィルタを削除するには、そのアイテムデータをもう一度クリックします。
|
||||
@@ -0,0 +1,16 @@
|
||||
---
|
||||
title: 'Customizing views in your {% data variables.projects.project_v2 %}'
|
||||
shortTitle: Customizing views
|
||||
intro: 'You can create multiple views to look at your project from different angles, deciding which items to show and how to present them.'
|
||||
versions:
|
||||
feature: projects-v2
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
children:
|
||||
- /customizing-a-view
|
||||
- /filtering-projects
|
||||
- /managing-your-views
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
@@ -0,0 +1,70 @@
|
||||
---
|
||||
title: Managing your views
|
||||
intro: 'Learn how to create, save, and manage your project views.'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
---
|
||||
|
||||
|
||||
## プロジェクトビューの作成
|
||||
|
||||
プロジェクトビューを使うと、プロジェクトの特定の側面を素早く見ることができます。 それぞれのビューは、プロジェクト内の個別のタブに表示されます。
|
||||
|
||||
たとえば、以下のようなビューを持つことができます:
|
||||
- まだ開始されていないすべてのアイテムを表示するビュー（"Status"でフィルタ）。
|
||||
- 各チームの作業負荷を表示するビュー（カスタムの"Team"フィールドでグループ化）。
|
||||
- 最短のターゲット出荷日を持つアイテムを表示するビュー（日付フィールドでソート）。
|
||||
|
||||
新しいビューは以下のように追加します:
|
||||
|
||||
{% data reusables.projects.new-view %}
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "New view."
|
||||
|
||||
新しいビューは自動的に保存されます。
|
||||
|
||||
## Duplicating a view
|
||||
|
||||
You can duplicate an existing view and use it as a base to make further changes.
|
||||
|
||||
1. Switch to the view you want to duplicate.
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click {% octicon "versions" aria-label="the versions icon" %} **Duplicate view**. 
|
||||
|
||||
## ビューへの変更の保存
|
||||
|
||||
ビューのデータのソート、並び替え、フィルタリング、グループ化など、ビューに変更を加えた場合、ビュー名の隣にはドットが表示され、保存されていない変更があることを示します。
|
||||
|
||||
|
||||
|
||||
変更を保存したくなければ、この表示は無視してかまいません。 この変更は他のユーザには見えません。
|
||||
|
||||
{% data reusables.projects.save-view %}
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Save view."
|
||||
|
||||
## 保存されたビューの並び替え
|
||||
|
||||
保存されたビューを含むタブの順序を変更するには、タブをクリックして新しい場所へドラッグします。 新しいタブの順序は自動的に保存されます。
|
||||
|
||||
## 保存されたビューの名前の変更
|
||||
|
||||
You can rename your saved views. 名前の変更は自動的に保存されます。
|
||||
|
||||
1. Switch to the view you want to rename.
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click {% octicon "pencil" aria-label="the pencil icon" %} **Rename view**. 
|
||||
1. Type the new name for your view.
|
||||
1. To save your changes, press <kbd>Return</kbd>.
|
||||
|
||||
## 保存されたビューの削除
|
||||
|
||||
1. Switch to the view you want to delete.
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click {% octicon "trash" aria-label="the trasj icon" %} **Delete view**. 
|
||||
|
||||
Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Delete view."
|
||||
@@ -0,0 +1,21 @@
|
||||
---
|
||||
title: 'Planning and tracking with {% data variables.product.prodname_projects_v2 %}'
|
||||
shortTitle: '{% data variables.product.prodname_projects_v2 %}'
|
||||
intro: 'Build adaptable projects to track your work on {% data variables.product.company_short %}.'
|
||||
versions:
|
||||
feature: projects-v2
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
children:
|
||||
- /learning-about-projects
|
||||
- /creating-projects
|
||||
- /managing-items-in-your-project
|
||||
- /understanding-field-types
|
||||
- /customizing-views-in-your-project
|
||||
- /automating-your-project
|
||||
- /viewing-insights-from-your-project
|
||||
- /managing-your-project
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
title: '{% data variables.product.prodname_projects_v2 %}について'
|
||||
intro: '{% data variables.product.prodname_projects_v2 %} is an adaptable, flexible tool for planning and tracking work on {% data variables.product.company_short %}.'
|
||||
allowTitleToDifferFromFilename: true
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/about-projects
|
||||
type: overview
|
||||
topics:
|
||||
- Projects
|
||||
---
|
||||
|
||||
## {% data variables.product.prodname_projects_v2 %}について
|
||||
|
||||
A project is an adaptable spreadsheet that integrates with your issues and pull requests on {% data variables.product.company_short %} to help you plan and track your work effectively. You can create and customize multiple views by filtering, sorting, grouping your issues and pull requests, adding custom fields to track metadata specific to your team, and visualize work with configurable charts. Rather than enforcing a specific methodology, a project provides flexible features you can customize to your team’s needs and processes.
|
||||
|
||||
### 最新の状態に保つ
|
||||
|
||||
Your projects are built from the issues and pull requests you add, creating direct references between your project and your work. Information is synced automatically to your project as you make changes, updating your views and charts. This integration works both ways, so that when you change information about a pull request or issue in your project, the pull request or issue reflects that information. For example, change an assignee in your project and that change is shown in your issue. You can take this integration even further, group your project by assignee, and make changes to issue assignment by dragging issues into the different groups.
|
||||
|
||||
### タスクへのメタデータの追加
|
||||
|
||||
You can use custom fields to add metadata to your tasks and build a richer view of item attributes. You’re not limited to the built-in metadata (assignee, milestone, labels, etc.) that currently exists for issues and pull requests. For example, you can add the following metadata as custom fields:
|
||||
|
||||
- A date field to track target ship dates.
|
||||
- A number field to track the complexity of a task.
|
||||
- A single select field to track whether a task is Low, Medium, or High priority.
|
||||
- A text field to add a quick note.
|
||||
- An iteration field to plan work week-by-week, including support for breaks.
|
||||
|
||||
### 様々な観点からプロジェクトを見る
|
||||
|
||||
Quickly answer your most pressing questions by tailoring your project view to give you the information you need. You can save these views, allowing you to quickly return to them as needed and make them available to your team. Views not only let you scope down the items listed but also offer two different layout options.
|
||||
|
||||
プロジェクトは、高密度のテーブルレイアウトで表示できます。
|
||||
|
||||
|
||||
|
||||
あるいはボードとして表示できます。
|
||||
|
||||
|
||||
|
||||
プロジェクトの特定の側面に注目しやすくするために、アイテムをグループ化、ソート、フィルタできます。
|
||||
|
||||
|
||||
|
||||
For more information, see "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)."
|
||||
@@ -1,11 +1,12 @@
|
||||
---
|
||||
title: プロジェクト（ベータ）の管理のベストプラクティス
|
||||
intro: '{% data variables.product.company_short %}でプロジェクトを管理するためのヒントを学びましょう。'
|
||||
title: 'Best practices for {% data variables.product.prodname_projects_v2 %}'
|
||||
intro: Learn tips for managing your projects.
|
||||
allowTitleToDifferFromFilename: true
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/best-practices-for-managing-projects
|
||||
type: overview
|
||||
topics:
|
||||
- Projects
|
||||
@@ -13,9 +14,7 @@ topics:
|
||||
- Project management
|
||||
---
|
||||
|
||||
{% data reusables.projects.projects-beta %}
|
||||
|
||||
プロジェクトを使って、IssueやPull Requestがある{% data variables.product.company_short %}上での作業を管理できます。 プロジェクトを効率的かつ効果的に管理するためのヒントを読んでください。 プロジェクトに関する詳しい情報については「[プロジェクトについて](/issues/trying-out-the-new-projects-experience/about-projects)」を参照してください。
|
||||
You can use {% data variables.product.prodname_projects_v2 %} to manage your work on {% data variables.product.company_short %}, where your issues and pull requests live. プロジェクトを効率的かつ効果的に管理するためのヒントを読んでください。 {% data variables.product.prodname_projects_v2 %} の詳細については、「[{% data variables.product.prodname_projects_v2 %} について](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)」を参照してください。
|
||||
|
||||
## 大きなIssueを小さなIssueに分割する
|
||||
|
||||
@@ -39,7 +38,7 @@ IssueとPull Requestには、コラボレータと容易にコミュニケーシ
|
||||
|
||||
プロジェクトのREADMEはMarkdownをサポートしており、画像や、リンク、リスト、ヘッダといった高度なフォーマットを使用できます。
|
||||
|
||||
詳しい情報については「[プロジェクト（ベータ）の作成](/issues/trying-out-the-new-projects-experience/creating-a-project#updating-your-project-description-and-readme)」を参照してください。
|
||||
詳しい情報については「[{% data variables.projects.project_v2 %}の作成](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)」を参照してください。
|
||||
|
||||
## ビューの利用
|
||||
|
||||
@@ -51,32 +50,32 @@ IssueとPull Requestには、コラボレータと容易にコミュニケーシ
|
||||
- カスタムの優先度フィールドでグループ化して、高優先度のアイテムの量をモニター
|
||||
- 最短の出荷ターゲット日でアイテムを見るために、カスタムの日付フィールドでソート
|
||||
|
||||
詳しい情報については「[プロジェクトのビューのカスタマイズ](/issues/trying-out-the-new-projects-experience/customizing-your-project-views)」を参照してください。
|
||||
For more information, see "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)."
|
||||
|
||||
## 信頼できる唯一の情報源を持つ
|
||||
|
||||
情報がずれてしまわないようにするために、信頼できる唯一の情報源を管理してください。 たとえば、ターゲットの出荷日は複数のフィールドに分散させず、一カ所で追跡してください。 そうすれば、ターゲットの出荷日が変更された場合、一カ所で日付を更新するだけでよくなります。
|
||||
|
||||
{% data variables.product.company_short %}のプロジェクトは、アサインされた人、マイルストーン、ラベルといった{% data variables.product.company_short %}のデータと、自動的に最新の状態に同期します。 これらのフィールドのいずれかがIssueあるいはPull Requestで変更されると、その変更は自動的にプロジェクトにも反映されます。
|
||||
{% data variables.product.prodname_projects_v2 %} automatically stay up to date with {% data variables.product.company_short %} data, such as assignees, milestones, and labels. これらのフィールドのいずれかがIssueあるいはPull Requestで変更されると、その変更は自動的にプロジェクトにも反映されます。
|
||||
|
||||
## 自動化の利用
|
||||
|
||||
意味の無い作業に費やす時間を減らし、プロジェクト自体にかける時間を増やすために、タスクを自動化できます。 手動でやることを覚えておく必要が減れば、それだけプロジェクトは最新の状態に保たれるようになります。
|
||||
|
||||
プロジェクト（ベータ）は、組み込みのワークフローを提供します。 たとえば、Issueがクローズされると自動的にステータスを「Done」に設定できます。
|
||||
{% data variables.product.prodname_projects_v2 %} offers built-in workflows. たとえば、Issueがクローズされると自動的にステータスを「Done」に設定できます。
|
||||
|
||||
加えて、{% data variables.product.prodname_actions %}とGraphQL APIでルーチンのプロジェクト管理タスクを自動化できます。 たとえば、レビュー待ちのPull Requestを追跡するために、Pull Requestをプロジェクトに追加し、そのステータスを"needs review"に設定するようなワークフローを作成できます。このプロセスは、Pull Requestが"ready for review"としてマークされたときに自動的にトリガーできます。
|
||||
|
||||
- ワークフローの例については「[プロジェクトの自動化](/issues/trying-out-the-new-projects-experience/automating-projects)」を参照してください。
|
||||
- APIに関する詳しい情報については「[プロジェクトを管理するためのAPIの利用](/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects)」を参照してください。
|
||||
- For an example workflow, see "[Automating {% data variables.product.prodname_projects_v2 %} using Actions](/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions)."
|
||||
- For more information about the API, see "[Using the API to manage {% data variables.product.prodname_projects_v2 %}](/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)."
|
||||
- {% data variables.product.prodname_actions %}に関する詳しい情報については「[{% data variables.product.prodname_actions %}](/actions)」を参照してください。
|
||||
|
||||
## 様々なフィールドタイプの利用
|
||||
|
||||
様々なフィールドタイプを活用して、要求を満たしてください。
|
||||
|
||||
繰り返しフィールドを使って、作業をスケジュールしたり、タイムラインを作成したりしてください。 繰り返しをグループ化して、アイテムが繰り返し間でバランスしているかを見たり、あるいは繰り返しの1つに焦点を当てるためにフィルタリングできます。 繰り返しフィールドを使えば、過去の繰り返しで完了した作業を見ることもでき、それを速度の計画とチームの成果への反映に役立てられます。 繰り返しフィールドは、あなたとあなたのチームが繰り返しから離れる時間を取っている時を示す休憩もサポートします。 詳しい情報については「[プロジェクトでの繰り返しの管理](/issues/trying-out-the-new-projects-experience/managing-iterations)」を参照してください。
|
||||
繰り返しフィールドを使って、作業をスケジュールしたり、タイムラインを作成したりしてください。 繰り返しをグループ化して、アイテムが繰り返し間でバランスしているかを見たり、あるいは繰り返しの1つに焦点を当てるためにフィルタリングできます。 繰り返しフィールドを使えば、過去の繰り返しで完了した作業を見ることもでき、それを速度の計画とチームの成果への反映に役立てられます。 繰り返しフィールドは、あなたとあなたのチームが繰り返しから離れる時間を取っている時を示す休憩もサポートします。 For more information, see "[About iteration fields](/issues/planning-and-tracking-with-projects/understanding-field-types/about-iteration-fields)."
|
||||
|
||||
単一の選択フィールドを利用して、事前設定された値のリストに基づき、タスクに関する情報を追跡してください。 たとえば、優先度やプロジェクトのフェーズを追跡してください。 値は事前設定されたリストから選択されるので、グループ化や特定の値のアイテムに集中するためのフィルタリングが容易です。
|
||||
|
||||
様々なフィールドタイプに関する詳しい情報については「[プロジェクト（ベータ）の作成](/issues/trying-out-the-new-projects-experience/creating-a-project#adding-custom-fields)」を参照してください。
|
||||
For more information about the different field types, see "[Understanding field types](/issues/planning-and-tracking-with-projects/understanding-field-types)."
|
||||
@@ -0,0 +1,15 @@
|
||||
---
|
||||
title: 'Learning about {% data variables.product.prodname_projects_v2 %}'
|
||||
intro: 'Learn about {% data variables.product.prodname_projects_v2 %} and how to make the very best of this powerful tool.'
|
||||
versions:
|
||||
feature: projects-v2
|
||||
topics:
|
||||
- Issues
|
||||
- Projects
|
||||
children:
|
||||
- /about-projects
|
||||
- /quickstart-for-projects
|
||||
- /best-practices-for-projects
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
@@ -0,0 +1,151 @@
|
||||
---
|
||||
title: 'Quickstart for {% data variables.product.prodname_projects_v2 %}'
|
||||
intro: 'Experience the speed, flexibility, and customization of {% data variables.product.prodname_projects_v2 %} by creating a project in this interactive guide.'
|
||||
allowTitleToDifferFromFilename: true
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/quickstart
|
||||
type: quick_start
|
||||
topics:
|
||||
- Projects
|
||||
---
|
||||
|
||||
## はじめに
|
||||
|
||||
This guide demonstrates how to use {% data variables.product.prodname_projects_v2 %} to plan and track work. このガイドでは、新しいプロジェクトを作成し、タスクの優先度を追跡するためにカスタムフィールドを追加します。 また、コラボレータと優先度や進捗について伝えるための役に立つ、保存されるビューも作成します。
|
||||
|
||||
## 必要な環境
|
||||
|
||||
Organizationプロジェクトもしくはユーザプロジェクトを作成できます。 Organizationプロジェクトを作成するには、{% data variables.product.prodname_dotcom %} Organizationが必要です。 Organizationの作成に関する詳しい情報については「[新しいOrganizationを最初から作成する](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch) 」を参照してください。
|
||||
|
||||
このガイドでは、新しいプロジェクトに対して自分のOrganizationが所有するリポジトリから既存のIssueを追加する（Organizationプロジェクトの場合）か、自分が所有するリポジトリから追加（ユーザプロジェクトの場合）します。 Issueの作成に関する詳しい情報については「[Issueの作成](/issues/tracking-your-work-with-issues/creating-an-issue)」を参照してください。
|
||||
|
||||
## プロジェクトの作成
|
||||
|
||||
まず、Organizationプロジェクトもしくはユーザプロジェクトを作成してください。
|
||||
|
||||
### Organizationプロジェクトの作成
|
||||
|
||||
{% data reusables.projects.create-project %}
|
||||
|
||||
### ユーザプロジェクトの作成
|
||||
|
||||
{% data reusables.projects.create-user-project %}
|
||||
|
||||
## プロジェクトの説明とREADMEの設定
|
||||
|
||||
{% data reusables.projects.project-description %}
|
||||
|
||||
## プロジェクトへのIssueの追加
|
||||
|
||||
次に、いくつかのIssueをプロジェクトに追加してください。
|
||||
|
||||
{% data reusables.projects.add-item-via-paste %}
|
||||
|
||||
上記のステップを何回か繰り返し、複数のIssueをプロジェクトに追加してください。
|
||||
|
||||
For more information and other ways to add issues to your project, or about other items you can add to your project, see "[Adding items to your project](/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project)."
|
||||
|
||||
## プロジェクトへのドラフトIssueの追加
|
||||
|
||||
次に、プロジェクトにドラフトIssueを追加してください。
|
||||
|
||||
{% data reusables.projects.add-draft-issue %}
|
||||
|
||||
## Adding an iteration field
|
||||
|
||||
Next, create an iteration field so you can plan and track your work over repeating blocks of time. Iterations can be configured to suit how you and your team works, with customizable lengths and the ability to insert breaks.
|
||||
|
||||
{% data reusables.projects.new-field %}
|
||||
1. Select **Iteration** 
|
||||
3. それぞれの繰り返しの期間を変更するには、新しい数値を入力し、ドロップダウンを選択して**days（日）**もしくは**weeks（週）**をクリックしてください。 
|
||||
4. [**Save**] をクリックします。 
|
||||
|
||||
## 優先度を追跡するためのフィールドの作成
|
||||
|
||||
Now, create a custom field named `Priority` and containing the values: `High`, `Medium`, or `Low`.
|
||||
|
||||
{% data reusables.projects.new-field %}
|
||||
1. Select **Single select** 
|
||||
1. Below "Options", type the first option, "High". 
|
||||
1. To add additional fields, for "Medium" and "Low", click **Add option**.
|
||||
1. [**Save**] をクリックします。 
|
||||
|
||||
プロジェクト中のすべてのIssueに優先度を指定してください。
|
||||
|
||||
|
||||
|
||||
## 優先度によるIssueのグループ化
|
||||
|
||||
次に、高優先度のアイテムに集中しやすくするために、プロジェクト中のすべてのアイテムを優先度でグループ化します。
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click {% octicon "rows" aria-label="the rows icon" %} **Group**. 
|
||||
1. Click **Priority**. 
|
||||
|
||||
さあ、優先度を変更するために、Issueをグループ間で移動させてください。
|
||||
|
||||
1. Issueを選択してください。
|
||||
2. Issueを様々な優先度のグループにドラッグアンドドロップしてください。 こうすると、Issueの優先度は新しいグループの優先度に変更されます。
|
||||
|
||||
|
||||
|
||||
## 優先度ビューの保存
|
||||
|
||||
前のステップにおいて優先度でIssueをグループ化すると、プロジェクトはビューが変更されたことを示すインジケーターを表示します。 コラボレータも優先度でグループ化されたタスクを見ることができるように、これらの変更を保存してください。
|
||||
|
||||
{% data reusables.projects.save-view %}
|
||||
|
||||
全員がプロジェクトの優先度に合わせていられるよう、TeamとこのURLを共有できます。
|
||||
|
||||
ビューが保存されると、プロジェクトをオープンした人は誰でもこの保存されたビューを見ることができます。 ここでは優先度でグループ化していますが、ソート、フィルタ、レイアウトなどの他の修飾子を追加することもできます。 次に、レイアウトを変更した新しいビューを作成しましょう。
|
||||
|
||||
## ボードレイアウトの追加
|
||||
|
||||
プロジェクトのIssueの進捗状況を見るには、ボードレイアウトに切り替えることができます。
|
||||
|
||||
ボードレイアウトはstatusフィールドに基づくので、プロジェクト中の各Issueのステータスを指定してください。
|
||||
|
||||
|
||||
|
||||
続いて、新しいビューを作成してください。
|
||||
|
||||
{% data reusables.projects.new-view %}
|
||||
|
||||
次に、ボードレイアウトに切り替えてください。
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Under "Layout", click **Board**. 
|
||||
|
||||
|
||||
|
||||
レイアウトを変更すると、プロジェクトはそのビューが変更されたことを示すインジケーターを表示します。 このビューを保存して、あなたやコラボレータが将来簡単にアクセスできるようにしてください。
|
||||
|
||||
{% data reusables.projects.save-view %}
|
||||
|
||||
ビューの目的を示すために、分かりやすい名前を付けてください。
|
||||
|
||||
{% data reusables.projects.open-view-menu %}
|
||||
1. Click {% octicon "pencil" aria-label="the pencil icon" %} **Rename view**. 
|
||||
1. Type the new name for your view.
|
||||
1. To save changes, press <kbd>Return</kbd>.
|
||||
|
||||
|
||||
|
||||
## 組み込みの自動化の設定
|
||||
|
||||
最後に、組み込みのワークフローを追加して、アイテムがプロジェクトに追加されたときにステータスが**Todo**に設定されるようにしてください。
|
||||
|
||||
1. In the top-right, click {% octicon "kebab-horizontal" aria-label="The menu icon" %} to open the menu. 
|
||||
1. In the menu, click {% octicon "workflow" aria-label="The workflow icon" %} **Workflows**. 
|
||||
1. **Default workflows（デフォルトのワークフロー）**の下で、**Item added to project（アイテムがプロジェクトに追加）**をクリックしてください。 
|
||||
1. **When（時期）**の隣で、`issues`と`pull requests`がどちらも選択されていることを確認してください。 
|
||||
1. **Set（設定）**の隣で、**Status:Todo**を選択してください。 
|
||||
1. **Disabled（無効）**トグルをクリックして、ワークフローを有効化してください。 
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- "[Adding items to your project](/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project)"
|
||||
- "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)"
|
||||
@@ -0,0 +1,75 @@
|
||||
---
|
||||
title: 'Adding items to your {% data variables.projects.project_v2 %}'
|
||||
shortTitle: Adding items
|
||||
intro: 'Learn how to add pull requests, issues, and draft issues to your projects individually or in bulk.'
|
||||
miniTocMaxHeadingLevel: 4
|
||||
versions:
|
||||
feature: projects-v2
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
プロジェクトは、ドラフトのIssue、Issue、Pull Requestを追跡できます。
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** A project can contain a maximum of 1,200 items and 10,000 archived items.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### Adding issues and pull requests to a project
|
||||
|
||||
#### Pasting the URL of an issue or pull request
|
||||
|
||||
{% data reusables.projects.add-item-via-paste %}
|
||||
|
||||
#### IssueあるいはPull Requestの検索
|
||||
|
||||
{% data reusables.projects.add-item-bottom-row %}
|
||||
2. <kbd>#</kbd>を入力してください。
|
||||
3. Pull RequestあるいはIssueがあるリポジトリを選択してください。 リポジトリ名の一部を入力して、選択肢を狭めることができます。 
|
||||
4. IssueあるいはPull Requestを選択してください。 タイトルの一部を入力して、選択肢を狭めることができます。 
|
||||
|
||||
#### Bulk adding issues and pull requests
|
||||
|
||||
1. In the bottom row of the project, click {% octicon "plus" aria-label="plus icon" %}. 
|
||||
1. Click **Add item from repository**. 
|
||||
{% data reusables.projects.bulk-add %}
|
||||
|
||||
#### リポジトリから複数のIssueあるいはPull Requestを追加する
|
||||
|
||||
1. {% data variables.product.product_location %}で、プロジェクトに追加したいIssueあるいはPull Requestが含まれているリポジトリにアクセスしてください。
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
1. それぞれのIssueのタイトルの左で、プロジェクトに追加したいIssueを選択してください。 
|
||||
1. あるいは、ページ上のすべてのIssueあるいはPull Requestを選択するには、IssueあるいはPull Requestのリストの上部で、すべてを選択してください。 
|
||||
1. Above the list of issues or pull requests, click **Projects**. 
|
||||
1. 選択されたIssueあるいはPull Requestを追加したいプロジェクトをクリックしてください。 
|
||||
|
||||
#### IssueあるいはPull Requestの中からプロジェクトをアサインする
|
||||
|
||||
1. プロジェクトに追加したいIssueあるいはPull Requestにアクセスしてください。
|
||||
2. サイドバーで**Projects（プロジェクト）**をクリックしてください。 
|
||||
3. Select the project that you want to add the issue or pull request to. 
|
||||
4. Optionally, populate the custom fields. 
|
||||
|
||||
#### Using the command palette to add an issue or pull request
|
||||
|
||||
1. {% data reusables.projects.open-command-palette %}
|
||||
1. Start typing "Add items" and press <kbd>Return</kbd>.
|
||||
{% data reusables.projects.bulk-add %}
|
||||
|
||||
### ドラフトIssueの作成
|
||||
|
||||
ドラフトIssueは、素早くアイデアを捕捉するのに役立ちます。 Unlike issues and pull requests that are referenced from your repositories, draft issues exist only in your project.
|
||||
|
||||
{% data reusables.projects.add-draft-issue %}
|
||||
|
||||
ドラフトIssueには、タイトル、テキストの本文、アサインされた人、プロジェクトからの任意のカスタムフィールドを持たせることができます。 ドラフトIssueのリポジトリ、ラベル、マイルストーンを展開するには、まずドラフトIssueをIssueに変換しなければなりません。 詳しい情報については「[ドラフトIssueのIssueへの変換](/issues/planning-and-tracking-with-projects/managing-items-in-your-project/converting-draft-issues-to-issues)」を参照してください。
|
||||
|
||||
{% note %}
|
||||
|
||||
**ノート**: ドラフトIssueがIssueに変換されなければ、ドラフトIssueにアサインされたりメンションされたりした人は、通知を受けません。
|
||||
|
||||
{% endnote %}
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: 'Archiving items from your {% data variables.projects.project_v2 %}'
|
||||
shortTitle: Archiving items
|
||||
intro: 'You can archive items, keeping them available to restore, or permanently delete them.'
|
||||
miniTocMaxHeadingLevel: 2
|
||||
versions:
|
||||
feature: projects-v2
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
|
||||
## Archiving items
|
||||
|
||||
アイテムをアーカイブして、そのアイテムに関するコンテキストをプロジェクト中に保持しながら、アイテムをプロジェクトのビューから削除できます。
|
||||
|
||||
{% data reusables.projects.select-an-item %}
|
||||
{% data reusables.projects.open-item-menu %}
|
||||
1. [**Archive**] をクリックします。 
|
||||
1. When prompted, confirm your choice by clicking **Archive**. 
|
||||
|
||||
## アーカイブされたアイテムの復元
|
||||
|
||||
1. プロジェクトにアクセスします。
|
||||
1. In the top-right, click {% octicon "kebab-horizontal" aria-label="The menu icon" %} to open the menu. 
|
||||
1. In the menu, click {% octicon "archive" aria-label="The archive icon" %} **Archived items**. 
|
||||
1. あるいは、表示されているアーカイブされたアイテムをフィルタリングするには、アイテムのリストの上にあるテキストボックスにフィルタを入力してください。 For more information about the available filters, see "[Filtering projects](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)." 
|
||||
1. To the left of each item title, select the items you would like to restore. 
|
||||
1. 選択されたアイテムを復元するには、アイテムのリストの上部で**Restore（復元）**をクリックしてください。 
|
||||
|
||||
## Deleting items
|
||||
|
||||
アイテムを削除すれば、それをプロジェクトから完全に取り除くことができます。
|
||||
|
||||
{% data reusables.projects.select-an-item %}
|
||||
{% data reusables.projects.open-item-menu %}
|
||||
1. Click **Delete from project**. 
|
||||
1. When prompted, confirm your choice by clicking **Delete**. 
|
||||
@@ -0,0 +1,27 @@
|
||||
---
|
||||
title: ドラフトIssueのIssueへの変換
|
||||
shortTitle: Converting draft issues
|
||||
intro: Learn how to convert draft issues into issues.
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
---
|
||||
|
||||
## Converting draft issues in table layout
|
||||
|
||||
1. Click the {% octicon "triangle-down" aria-label="the item menu" %} on the draft issue that you want to convert. 
|
||||
2. **Convert to issue（Issueに変換）**を選択してください。 
|
||||
3. Select the repository that you want to add the issue to. 
|
||||
|
||||
## Converting draft issues in board layout
|
||||
|
||||
1. Click the {% octicon "kebab-horizontal" aria-label="the item menu" %} on the draft issue that you want to convert. 
|
||||
2. **Convert to issue（Issueに変換）**を選択してください。 
|
||||
3. Select the repository that you want to add the issue to. 
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- "[Creating draft issues](/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#creating-draft-issues)"
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user