Skip to content

Commit cb2415e

Browse files
authored
repo sync
2 parents bf2a85c + 871d886 commit cb2415e

91 files changed

Lines changed: 795 additions & 1144 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/triage-unallowed-contributions.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,7 @@ jobs:
104104
body: reviewMessage,
105105
event: 'REQUEST_CHANGES'
106106
})
107+
exit 1 # prevents further steps from running and fails workflow
107108
# When the most recent review was CHANGES_REQUESTED and the existing
108109
# PR no longer contains unallowed changes, dismiss the previous review
109110
- name: Dismiss pull request review

.github/workflows/workflow-lint.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@ name: Lint workflows
22

33
on:
44
workflow_dispatch:
5-
push:
6-
branches:
7-
- main
8-
pull_request:
9-
branches-ignore:
10-
- translations
5+
# push:
6+
# branches:
7+
# - main
8+
# pull_request:
9+
# branches-ignore:
10+
# - translations
1111

1212
jobs:
1313
lint:
9.52 KB
Loading
9.61 KB
Loading
2.98 KB
Loading

content/README.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ See the [contributing docs](/CONTRIBUTING.md) for general information about work
2424
- [Escaping single quotes](#escaping-single-quotes)
2525
- [Autogenerated mini TOCs](#autogenerated-mini-tocs)
2626
- [Versioning](#versioning)
27+
- [Free-pro-team vs. GitHub.com versioning](#free-pro-team-vs.-github.com-versioning)
2728
- [Filenames](#filenames)
2829
- [Whitespace control](#whitespace-control)
2930
- [Links and image paths](#links-and-image-paths)
@@ -213,6 +214,12 @@ A content file can have **two** types of versioning:
213214
* Liquid statements in content (**optional**)
214215
* Conditionally render content depending on the current version being viewed. See [contributing/liquid-helpers](../contributing/liquid-helpers.md) for more info. Note Liquid conditionals can also appear in `data` and `include` files.
215216

217+
### Free-pro-team vs. GitHub.com versioning
218+
219+
As of early 2021, the `free-pro-team@latest` version is **only** supported in content files (in both frontmatter and Liquid versioning) and throughout the docs site backend. It is **not** user facing. A helper function called `lib/remove-fpt-from-path.js` removes the version from URLs. Users now select `GitHub.com` in the Article Versions dropdown instead of `Free, Pro, Team`.
220+
221+
The convenience function allows us to continue supporting a consistent versioning structure under-the-hood while not displaying plan information to users that may be potentially confusing.
222+
216223
## Filenames
217224

218225
When adding a new article, make sure the filename is a [kebab-cased](https://en.wikipedia.org/wiki/Letter_case#Special_case_styles) version of the title you use in the article's [`title`](#title) frontmatter. This can get tricky when a title has punctuation (such as "GitHub's Billing Plans"). A test will flag any discrepancies between title and filename. To override this requirement for a given article, you can add [`allowTitleToDifferFromFilename`](#allowtitletodifferfromfilename) frontmatter.
@@ -224,7 +231,7 @@ When using Liquid conditionals in lists or tables, you can use [whitespace contr
224231
Just add a hyphen on either the left, right, or both sides to indicate that there should be no newline on that side. For example, this statement removes a newline on the left side:
225232

226233
```
227-
{%- if page.version == 'dotcom' %}
234+
{%- if currentVersion == 'free-pro-team@latest' %}
228235
```
229236

230237
These characters are especially important in [index pages](#index-pages) comprised of list items.
@@ -238,9 +245,9 @@ For example, if you include the following link in a content file:
238245
```
239246
/github/writing-on-github/creating-a-saved-reply
240247
```
241-
When viewed on GitHub.com docs, the link gets rendered with the language code and version:
248+
When viewed on GitHub.com docs, the link gets rendered with the language code:
242249
```
243-
/en/free-pro-team@latest/github/writing-on-github/creating-a-saved-reply
250+
/en/github/writing-on-github/creating-a-saved-reply
244251
```
245252
and when viewed on GitHub Enterprise Server docs, the version is included as well:
246253
```

content/developers/apps/creating-ci-tests-with-the-checks-api.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ A CI server hosts code that runs CI tests such as code linters (which check styl
2424

2525
The [Checks API](/rest/reference/checks) allows you to set up CI tests that are automatically run against each code commit in a repository. The Checks API reports detailed information about each check on GitHub in the pull request's **Checks** tab. With the Checks API, you can create annotations with additional details for specific lines of code. Annotations are visible in the **Checks** tab. When you create an annotation for a file that is part of the pull request, the annotations are also shown in the **Files changed** tab.
2626

27-
A _check suite_ is a group of _check runs_ (individual CI tests). Both the suite and the runs contain _statuses_ that are visible in a pull request on GitHub. You can use statuses to determine when a code commit introduces errors. Using these statuses with [protected branches](/rest/reference/repos#branches) can prevent people from merging pull requests prematurely. See "[Enabling required status checks](/articles/enabling-required-status-checks/)" for more details.
27+
A _check suite_ is a group of _check runs_ (individual CI tests). Both the suite and the runs contain _statuses_ that are visible in a pull request on GitHub. You can use statuses to determine when a code commit introduces errors. Using these statuses with [protected branches](/rest/reference/repos#branches) can prevent people from merging pull requests prematurely. See "[About protected branches](/github/administering-a-repository/about-protected-branches#require-status-checks-before-merging)" for more details.
2828

2929
The Checks API sends the [`check_suite` webhook event](/webhooks/event-payloads/#check_suite) to all GitHub Apps installed on a repository each time new code is pushed to the repository. To receive all Checks API event actions, the app must have the `checks:write` permission. GitHub automatically creates `check_suite` events for new code commits in a repository using the default flow, although [Update repository preferences for check suites](/rest/reference/checks#update-repository-preferences-for-check-suites) if you'd like. Here's how the default flow works:
3030

content/github/administering-a-repository/about-branch-restrictions.md

Lines changed: 0 additions & 30 deletions
This file was deleted.

content/github/administering-a-repository/about-merge-methods-on-github.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ versions:
1414
{% data reusables.pull_requests.default_merge_option %}
1515

1616
{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
17-
The default merge method creates a merge commit. You can prevent anyone from pushing merge commits to a protected branch by enforcing a linear commit history. For more information, see "[Requiring a linear commit history](/github/administering-a-repository/requiring-a-linear-commit-history)."{% endif %}
17+
The default merge method creates a merge commit. You can prevent anyone from pushing merge commits to a protected branch by enforcing a linear commit history. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches#require-linear-history)."{% endif %}
1818

1919
### Squashing your merge commits
2020

0 commit comments

Comments
 (0)