diff --git a/content/admin/all-releases.md b/content/admin/all-releases.md index 9ce60076b2..4ddb6d3d31 100644 --- a/content/admin/all-releases.md +++ b/content/admin/all-releases.md @@ -1,38 +1,50 @@ --- title: GitHub Enterprise Server releases -intro: 'Documentation for the currently supported and previously deprecated versions of {{ site.data.variables.product.prodname_ghe_server }}.' +intro: "{% data variables.product.company_short %} releases new versions of {% data variables.product.product_name %} regularly. You can review supported versions, see deprecation dates, and browse documentation for the release you've deployed." allowTitleToDifferFromFilename: true versions: ghes: '*' topics: - Enterprise + - Upgrades shortTitle: Releases --- -## Currently supported +## About releases of {% data variables.product.product_name %} -See [{% data variables.product.prodname_enterprise %}](https://github.com/enterprise) for information about the latest release. +{% data reusables.enterprise.constantly-improving %} {% data variables.product.company_short %} supports the four most recent feature releases. For more information, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." -{% for supportedRelease in enterpriseServerReleases.supported %} -- [{% data variables.product.prodname_ghe_server %} {{supportedRelease}}](/enterprise-server@{{supportedRelease}}) -{% endfor %} +You can see what's new for each release in the [release notes](/admin/release-notes), and you can view administrator and user documentation for all releases here on {% data variables.product.prodname_docs %}. When you read the documentation, make sure to select the version that reflects your product. For more information, see "[About versions of {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)." -## Deprecated +## Currently supported releases -Documentation for deprecated versions remains available but is no longer maintained. +{% data variables.product.company_short %} supports the following releases of {% data variables.product.product_name %}. For more information about the latest release, see the [{% data variables.product.prodname_enterprise %}](https://github.com/enterprise) website. -{% for deprecatedRelease in enterpriseServerReleases.deprecatedReleasesWithNewFormat %} -- [Enterprise Server {{deprecatedRelease}}](/enterprise-server@{{deprecatedRelease}}) -{% endfor %} +| Version | Release | Deprecation | Release notes | Documentation | +| :- | :- | :- | :- | :- | +{%- for version in enterpriseServerReleases.supported %} +| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} release notes](/enterprise-server@{{version}}/admin/release-notes) | [{{version}} documentation](/enterprise-server@{{version}}) | +{%- endfor %} -{% for deprecatedReleaseLegacyFormat in enterpriseServerReleases.deprecatedReleasesWithLegacyFormat %} -- [Enterprise Server {{deprecatedReleaseLegacyFormat}}](/enterprise/{{deprecatedReleaseLegacyFormat}}) -{% endfor %} +## Deprecated releases -## Deprecated developer documentation +{% data variables.product.company_short %} provides documentation for deprecated versions, but does not maintain or update the documentation. -Developer documentation for deprecated versions remains available but is no longer maintained. +| Version | Release | Deprecation | Release notes | Documentation | +| :- | :- | :- | :- | :- | +{%- for version in enterpriseServerReleases.deprecatedReleasesWithNewFormat %} +| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} release notes](/enterprise-server@{{version}}/admin/release-notes) | [{{version}} documentation](/enterprise-server@{{version}}) | +{%- endfor %} +{%- for version in enterpriseServerReleases.deprecatedReleasesWithLegacyFormat %} +| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} release notes](https://enterprise.github.com/releases/series/{{version}}) | [{{version}} documentation](/enterprise/{{version}}) | +{%- endfor %} -{% for deprecatedDevRelease in enterpriseServerReleases.deprecatedReleasesOnDeveloperSite %} -- [Enterprise Server {{deprecatedDevRelease}}](https://developer.github.com/enterprise/{{deprecatedDevRelease}}) -{% endfor %} +### Deprecated developer documentation + +{% data variables.product.company_short %} hosted developer documentation for {% data variables.product.product_name %} on a separate site until the 2.17 release. {% data variables.product.company_short %} continues to provide developer documentation for version 2.16 and earlier, but does not maintain or update the documentation. + +| Version | Release | Deprecation | Developer documentation | +| :- | :- | :- | :- | +{%- for version in enterpriseServerReleases.deprecatedReleasesOnDeveloperSite %} +| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} developer documentation](https://developer.github.com/enterprise/{{version}}) | +{%- endfor %} diff --git a/content/admin/index.md b/content/admin/index.md index db889b0de8..ae2d06af75 100644 --- a/content/admin/index.md +++ b/content/admin/index.md @@ -65,6 +65,7 @@ redirect_from: - /admin/configuration/configuring-your-enterprise/configuring-data-encryption-for-your-enterprise introLinks: overview: '{% ifversion ghes %}/admin/overview/system-overview{% elsif ghae %}/admin/overview/about-github-ae{% elsif ghec %}/admin/overview/about-enterprise-accounts{% endif %}' + Releases: '{% ifversion ghes %}/admin/all-releases{% endif %}' changelog: label: enterprise featuredLinks: diff --git a/content/admin/overview/about-upgrades-to-new-releases.md b/content/admin/overview/about-upgrades-to-new-releases.md index 4e4de2165b..ed9a0c36a7 100644 --- a/content/admin/overview/about-upgrades-to-new-releases.md +++ b/content/admin/overview/about-upgrades-to-new-releases.md @@ -12,7 +12,7 @@ topics: --- {% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} -{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through feature and patch releases. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %} +{% data reusables.enterprise.constantly-improving %}{% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %} Feature releases include new functionality and feature upgrades and typically occur quarterly. {% ifversion ghae %}{% data variables.product.company_short %} will upgrade your enterprise to the latest feature release. You will be given advance notice of any planned downtime for your enterprise.{% endif %} diff --git a/data/reusables/enterprise/constantly-improving.md b/data/reusables/enterprise/constantly-improving.md new file mode 100644 index 0000000000..fcb8b05588 --- /dev/null +++ b/data/reusables/enterprise/constantly-improving.md @@ -0,0 +1 @@ +{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through {% ifversion ghes %}feature and patch releases{% elsif ghae %}regular updates{% endif %}.