Skip to content

Commit

Permalink
Remove task-lists-v1 because it's always true (#50524)
Browse files Browse the repository at this point in the history
  • Loading branch information
peterbe authored May 15, 2024
1 parent 0a9eae3 commit 6d1b696
Show file tree
Hide file tree
Showing 6 changed files with 9 additions and 16 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -73,14 +73,14 @@ Use `git status` to list all new or modified files that haven't yet been committ

To format code or text into its own distinct block, use triple backticks.

<pre>
````text
Some basic Git commands are:
```
git status
git add
git commit
```
</pre>
````

![Screenshot of rendered GitHub Markdown showing a code block. The words "git status," "git add," and "git commit" appear in a fixed-width typeface, highlighted in light gray.](/assets/images/help/writing/code-block-rendered.png)

Expand Down Expand Up @@ -250,8 +250,6 @@ You can create multiple levels of nested lists using the same method. For exampl

For more examples, see the [GitHub Flavored Markdown Spec](https://github.github.com/gfm/#example-265).

{% ifversion task-lists-v1 %}

## Task lists

{% data reusables.repositories.task-list-markdown %}
Expand All @@ -261,7 +259,6 @@ If a task list item description begins with a parenthesis, you'll need to escape
`- [ ] \(Optional) Open a followup issue`

For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)."
{% endif %}

## Mentioning people and teams

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,9 @@ redirect_from:
- /issues/tracking-your-work-with-issues/creating-issues/about-task-lists
- /issues/tracking-your-work-with-issues/about-task-lists
versions:
feature: task-lists-v1
fpt: '*'
ghes: '*'
ghec: '*'
topics:
- Pull requests
- Issues
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ You can use {% data variables.product.prodname_projects_v2 %} to manage your wor

Breaking a large issue into smaller issues makes the work more manageable and enables team members to work in parallel. It also leads to smaller pull requests, which are easier to review.

To track how smaller issues fit into the larger goal, use {% ifversion task-lists-v1 %}task lists, milestones, or labels.{% else %} milestones or labels.{% endif %} For more information, see {% ifversion projects-v2-tasklists %}"[AUTOTITLE](/issues/tracking-your-work-with-issues/about-tasklists)"{% endif %}{% ifversion ghes %}"[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)"{% endif %}, "[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/about-milestones)", and "[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels)."
To track how smaller issues fit into the larger goal, use task lists, milestones, or labels. For more information, see {% ifversion projects-v2-tasklists %}"[AUTOTITLE](/issues/tracking-your-work-with-issues/about-tasklists)"{% endif %}{% ifversion ghes %}"[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)"{% endif %}, "[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/about-milestones)", and "[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels)."

## Communicate

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -74,16 +74,13 @@ Here is an example of an issue created for a large initiative, front-end work, i

![Screenshot of an issue called "Front-end work for Project Octocat." The issue body includes a list of tasks to complete.](/assets/images/help/issues/quickstart-create-large-initiative-issue.png)

{% ifversion task-lists-v1 %}

### Task list example

You can use task lists to break larger issues down into smaller tasks and to track issues as part of a larger goal. {% ifversion fpt or ghec %} Task lists have additional functionality when added to the body of an issue. You can see the number of tasks completed out of the total at the top of the issue, and if someone closes an issue linked in the task list, the checkbox will automatically be marked as complete.{% endif %} For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)."

Below we have added a task list to our Project Octocat issue, breaking it down into smaller issues.

![Screenshot of an issue called "Front-end work for Project Octocat." The issue body contains a task list, with a checkbox preceding each issue link.](/assets/images/help/issues/quickstart-add-task-list-to-issue.png)
{% endif %}

## Making decisions as a team

Expand Down Expand Up @@ -147,8 +144,8 @@ You have now learned about the tools {% data variables.product.prodname_dotcom %
- "[AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories)" for learning more about creating repositories
- "[AUTOTITLE](/issues/tracking-your-work-with-issues)" for learning more about different ways to create and manage issues
- "[AUTOTITLE](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)" for learning more about issue templates
- "[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels)" for learning how to create, edit and delete labels{% ifversion task-lists-v1 %}
- "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)" for learning more about task lists{% endif %}
- "[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels)" for learning how to create, edit and delete labels
- "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)" for learning more about task lists
{% ifversion projects-v2 %} - "[AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)" for learning more about projects
- "[AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view)" for learning how to customize views for projects{% endif %}
{% ifversion projects-v1 %}- "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards)" for learning how to manage {% data variables.projects.projects_v1_boards %}{% endif %}
3 changes: 0 additions & 3 deletions content/issues/tracking-your-work-with-issues/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,14 +39,11 @@ You can use markdown to add formatting, links, emojis, and more. For more inform

![Screenshot of the new issue form, with a title and body filled in.](/assets/images/help/issues/issue-title-body.png)

{% ifversion task-lists-v1 %}

## Adding a task list

It can be helpful to break large issues into smaller tasks, or to track multiple related issues in a single larger issue. Add a task list to your issue by prefacing list items with `[ ]`. Reference existing issues by issue number or URL. You can use plain text to track tasks that don't have a corresponding issue and convert them to issues later. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)."

![Screenshot of the new issue form, with the title and body filled in. The body includes the Markdown for a task list.](/assets/images/help/issues/issue-task-list-raw.png)
{% endif %}

## Adding labels

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ If you are a repository maintainer, take these steps to manage and standardize t

Pull request templates let you customize and standardize the information you'd like to be included when someone creates a pull request in your repository. When you add a pull request template to your repository, project contributors will automatically see the template's contents in the pull request body. For more information, see "[AUTOTITLE](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository)."

{% ifversion task-lists-v1 %} You can use pull request templates to standardize the review process for your repository. For example, you can include a list of tasks that you would like authors to complete before merging their pull requests, by adding a task list to the template. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)."{% endif %}
You can use pull request templates to standardize the review process for your repository. For example, you can include a list of tasks that you would like authors to complete before merging their pull requests, by adding a task list to the template. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)."

You can request that contributors include an issue reference in their pull request body, so that merging the pull request will automatically close the issue. For more information, see "[AUTOTITLE](/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)."

Expand Down

0 comments on commit 6d1b696

Please sign in to comment.