Skip to content

Commit 7d55775

Browse files
authored
Actions landing page top bits (#16266)
* Add changelog frontmatter * Reorganize some properties * Move sections to product-landing * Add more items * Changing heading design * Redesign hero * Remove "GitHub Actions:" * Popular ~articles~ * Use proper date formatting * Quick start => Quickstart * Add a comment * Add to content/README
1 parent 5d09adb commit 7d55775

File tree

5 files changed

+90
-46
lines changed

5 files changed

+90
-46
lines changed

content/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,12 @@ featuredLinks:
166166
- Type: `Boolean`. Default is `false`.
167167
- Optional.
168168

169+
### `changelog`
170+
171+
- Purpose: Render a list of changelog items with timestamps on product pages (ex: `layouts/product-landing.html`)
172+
- Type: `Array`, items are objects `{ href: string, title: string, date: 'YYYY-MM-DD' }`
173+
- Optional.
174+
169175
### Escaping single quotes
170176

171177
If you see two single quotes in a row (`''`) in YML frontmatter where you might expect to see one (`'`), this is the YML-preferred way to escape a single quote. From [the YAML spec](https://yaml.org/spec/history/2001-12-10.html):

content/actions/index.md

Lines changed: 17 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -4,17 +4,30 @@ shortTitle: GitHub Actions
44
intro: 'Automate, customize, and execute your software development workflows right in your repository with {% data variables.product.prodname_actions %}. You can discover, create, and share actions to perform any job you''d like, including CI/CD, and combine actions in a completely customized workflow.'
55
introLinks:
66
quickstart: /actions/quickstart
7-
learn: /actions/learn-github-actions
7+
reference: /actions/reference
88
featuredLinks:
9+
guides:
10+
- /actions/guides/setting-up-continuous-integration-using-workflow-templates
11+
- /actions/guides/about-packaging-with-github-actions
912
gettingStarted:
1013
- /actions/managing-workflow-runs
1114
- /actions/hosting-your-own-runners
12-
guide:
13-
- /actions/guides/setting-up-continuous-integration-using-workflow-templates
14-
- /actions/guides/about-packaging-with-github-actions
1515
popular:
1616
- /actions/reference/workflow-syntax-for-github-actions
1717
- /actions/reference/events-that-trigger-workflows
18+
changelog:
19+
- title: Self-Hosted Runner Group Access Changes
20+
date: '2020-10-16'
21+
href: https://github.blog/changelog/2020-10-16-github-actions-self-hosted-runner-group-access-changes/
22+
- title: Ability to change retention days for artifacts and logs
23+
date: '2020-10-08'
24+
href: https://github.blog/changelog/2020-10-08-github-actions-ability-to-change-retention-days-for-artifacts-and-logs
25+
- title: Deprecating set-env and add-path commands
26+
date: '2020-10-01'
27+
href: https://github.blog/changelog/2020-10-01-github-actions-deprecating-set-env-and-add-path-commands
28+
- title: Fine-tune access to external actions
29+
date: '2020-10-01'
30+
href: https://github.blog/changelog/2020-10-01-github-actions-fine-tune-access-to-external-actions
1831
redirect_from:
1932
- /articles/automating-your-workflow-with-github-actions/
2033
- /articles/customizing-your-project-with-github-actions/
@@ -36,42 +49,6 @@ versions:
3649
<!-- {% link_with_intro /hosting-your-own-runners %} -->
3750
<!-- {% link_with_intro /reference %} -->
3851

39-
<!-- Article links -->
40-
<div class="d-lg-flex gutter my-6 py-6">
41-
<div class="col-12 col-lg-4 mb-4 mb-lg-0">
42-
<div class="featured-links-heading pb-4">
43-
<h3 class="f5 text-normal text-mono underline-dashed color-gray-5">{% data ui.toc.guides %}</h3>
44-
</div>
45-
<ul class="list-style-none">
46-
{% for link in featuredLinks.guide %}
47-
<li>{% include featured-link %}</li>
48-
{% endfor %}
49-
</ul>
50-
</div>
51-
52-
<div class="col-12 col-lg-4 mb-4 mb-lg-0">
53-
<div class="featured-links-heading pb-4">
54-
<h3 class="f5 text-normal text-mono underline-dashed color-gray-5">{% data ui.toc.popular_articles %}</h3>
55-
</div>
56-
<ul class="list-style-none">
57-
{% for link in featuredLinks.popular %}
58-
<li>{% include featured-link %}</li>
59-
{% endfor %}
60-
</ul>
61-
</div>
62-
63-
<div class="col-12 col-lg-4 mb-4 mb-lg-0">
64-
<div class="featured-links-heading pb-4">
65-
<h3 class="f5 text-normal text-mono underline-dashed color-gray-5">Manage workflows</h3>
66-
</div>
67-
<ul class="list-style-none">
68-
{% for link in featuredLinks.gettingStarted %}
69-
<li>{% include featured-link %}</li>
70-
{% endfor %}
71-
</ul>
72-
</div>
73-
</div>
74-
7552
<!-- Code examples -->
7653
<div class="my-6 pt-6">
7754
<h2 class="mb-2">More guides</h2>

data/ui.yml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,9 @@ homepage:
2626
version_picker: Version
2727
toc:
2828
getting_started: Getting started
29-
popular_articles: Popular articles
29+
popular_articles: Popular
3030
guides: Guides
31+
whats_new: What's new
3132
pages:
3233
article_version: "Article version:"
3334
miniToc: In this article
@@ -129,3 +130,6 @@ footer:
129130
careers: Careers
130131
press: Press
131132
shop: Shop
133+
product_landing:
134+
quick_start: Quickstart
135+
reference_guides: Reference guides

layouts/product-landing.html

Lines changed: 49 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,16 +15,61 @@
1515
<h1 class="mb-3 font-mktg">{{ page.shortTitle }}</h1>
1616
<div class="lead-mktg text-gray">{{ page.intro }}</div>
1717

18-
<a href="{{ page.introLinks.quickstart }}" class="btn btn-large f4 btn-blue mt-3">
19-
Quickstart
18+
<a href="{{ page.introLinks.quickstart }}" class="btn-mktg btn-large f4 mt-3">
19+
{% data ui.product_landing.quick_start %}
2020
</a>
2121

22-
<a href="{{ page.introLinks.learn }}" class="ml-3 btn btn-large f4 btn-outline mt-3">
23-
Learn {% data variables.product.prodname_actions %}
22+
<a href="{{ page.introLinks.reference }}" class="ml-3 btn-mktg btn-outline-mktg btn-large f4 mt-3">
23+
{% data ui.product_landing.reference_guides %}
2424
</a>
2525
</div>
2626
</header>
2727

28+
<!-- Article links -->
29+
<div class="d-lg-flex gutter my-6 py-6">
30+
<div class="col-12 col-lg-4 mb-4 mb-lg-0">
31+
<div class="featured-links-heading pb-3 mb-4 border-bottom">
32+
<h3 class="f5 text-normal text-mono text-uppercase color-gray-5">{% data ui.toc.guides %}</h3>
33+
</div>
34+
<ul class="list-style-none">
35+
{% for link in featuredLinks.guides %}
36+
<li class="Box px-3 py-1 mb-2">
37+
{% include featured-link %}
38+
</li>
39+
{% endfor %}
40+
</ul>
41+
</div>
42+
43+
<div class="col-12 col-lg-4 mb-4 mb-lg-0">
44+
<div class="featured-links-heading pb-3 mb-4 border-bottom">
45+
<h3 class="f5 text-normal text-mono text-uppercase color-gray-5">{% data ui.toc.popular_articles %}</h3>
46+
</div>
47+
<ul class="list-style-none">
48+
{% for link in featuredLinks.popular %}
49+
<li class="Box px-3 py-1 mb-2">
50+
{% include featured-link %}
51+
</li>
52+
{% endfor %}
53+
</ul>
54+
</div>
55+
56+
<div class="col-12 col-lg-4 mb-4 mb-lg-0">
57+
<div class="featured-links-heading pb-3 mb-4 border-bottom">
58+
<h3 class="f5 text-normal text-mono text-uppercase color-gray-5">{% data ui.toc.whats_new %}</h3>
59+
</div>
60+
<ul class="list-style-none">
61+
{% for link in page.changelog %}
62+
<li class="mb-2">
63+
<a href="{{ link.href }}" class="Box text-gray-dark Bump-link--hover p-3 d-flex flex-justify-between flex-items-center no-underline">
64+
<h4>{{ link.title }} <span class="Bump-link-symbol"></span></h4>
65+
<span class="text-gray-light text-mono ml-2" style="white-space: nowrap">{{ link.date | date: "%B %d, %Y" }}</span>
66+
</a>
67+
</li>
68+
{% endfor %}
69+
</ul>
70+
</div>
71+
</div>
72+
2873
{{ renderedPage }}
2974
</div>
3075

lib/frontmatter.js

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ const schema = {
5959
type: 'object',
6060
properties: {
6161
quickstart: { type: 'string' },
62-
learn: { type: 'string' }
62+
reference: { type: 'string' }
6363
}
6464
},
6565
featuredLinks: {
@@ -71,6 +71,18 @@ const schema = {
7171
items: { type: 'string' }
7272
}
7373
}
74+
},
75+
// Shown in `product-landing.html` "What's new" section
76+
changelog: {
77+
type: 'array',
78+
items: {
79+
type: 'object',
80+
properties: {
81+
title: { type: 'string' },
82+
date: { type: 'string', format: 'date' },
83+
href: { type: 'string' }
84+
}
85+
}
7486
}
7587
}
7688
}

0 commit comments

Comments
 (0)