jekyll-docs 3.7.3 → 3.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (139) hide show
  1. checksums.yaml +5 -5
  2. data/lib/jekyll-docs.rb +1 -1
  3. data/site/404.html +6 -22
  4. data/site/docs/assets/index.html +9 -25
  5. data/site/docs/code_of_conduct/index.html +8 -24
  6. data/site/docs/collections/index.html +22 -24
  7. data/site/docs/conduct/index.html +8 -24
  8. data/site/docs/configuration/index.html +33 -39
  9. data/site/docs/continuous-integration/buddyworks/index.html +8 -24
  10. data/site/docs/continuous-integration/circleci/index.html +8 -24
  11. data/site/docs/continuous-integration/index.html +8 -24
  12. data/site/docs/continuous-integration/travis-ci/index.html +8 -24
  13. data/site/docs/contributing/index.html +8 -24
  14. data/site/docs/datafiles/index.html +8 -24
  15. data/site/docs/deployment-methods/index.html +8 -24
  16. data/site/docs/drafts/index.html +8 -24
  17. data/site/docs/extras/index.html +8 -24
  18. data/site/docs/frontmatter/index.html +8 -24
  19. data/site/docs/github-pages/index.html +8 -24
  20. data/site/docs/history/index.html +137 -40
  21. data/site/docs/home/index.html +32 -63
  22. data/site/docs/includes/index.html +8 -24
  23. data/site/docs/installation/index.html +120 -109
  24. data/site/docs/maintaining/affinity-team-captain/index.html +8 -24
  25. data/site/docs/maintaining/avoiding-burnout/index.html +10 -26
  26. data/site/docs/maintaining/becoming-a-maintainer/index.html +8 -24
  27. data/site/docs/maintaining/index.html +14 -29
  28. data/site/docs/maintaining/merging-a-pull-request/index.html +12 -28
  29. data/site/docs/maintaining/releasing-a-new-version/index.html +761 -0
  30. data/site/docs/maintaining/reviewing-a-pull-request/index.html +8 -24
  31. data/site/docs/maintaining/special-labels/index.html +8 -24
  32. data/site/docs/maintaining/triaging-an-issue/index.html +8 -24
  33. data/site/docs/migrations/index.html +8 -24
  34. data/site/docs/pages/index.html +8 -24
  35. data/site/docs/pagination/index.html +8 -24
  36. data/site/docs/permalinks/index.html +16 -32
  37. data/site/docs/plugins/index.html +27 -104
  38. data/site/docs/posts/index.html +34 -27
  39. data/site/docs/quickstart/index.html +8 -24
  40. data/site/docs/resources/index.html +14 -26
  41. data/site/docs/sites/index.html +8 -24
  42. data/site/docs/static-files/index.html +8 -24
  43. data/site/docs/structure/index.html +8 -24
  44. data/site/docs/support/index.html +8 -24
  45. data/site/docs/templates/index.html +36 -24
  46. data/site/docs/themes/index.html +50 -29
  47. data/site/docs/troubleshooting/index.html +68 -34
  48. data/site/docs/upgrading/0-to-2/index.html +8 -24
  49. data/site/docs/upgrading/2-to-3/index.html +8 -24
  50. data/site/docs/upgrading/index.html +8 -24
  51. data/site/docs/usage/index.html +8 -24
  52. data/site/docs/variables/index.html +9 -25
  53. data/site/docs/windows/index.html +14 -25
  54. data/site/feed.xml +49 -82
  55. data/site/help/index.html +7 -23
  56. data/site/index.html +7 -23
  57. data/site/jekyllconf/index.html +7 -23
  58. data/site/latest_version.txt +1 -1
  59. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +27 -30
  60. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +27 -30
  61. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +27 -30
  62. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +27 -30
  63. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +27 -30
  64. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +27 -30
  65. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +27 -30
  66. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +27 -30
  67. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +27 -30
  68. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +27 -30
  69. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +27 -30
  70. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +27 -30
  71. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +27 -30
  72. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +27 -30
  73. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +27 -30
  74. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +27 -30
  75. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +27 -30
  76. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +27 -30
  77. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +27 -30
  78. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +27 -30
  79. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +27 -30
  80. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +27 -30
  81. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +27 -30
  82. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +27 -30
  83. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +27 -30
  84. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +27 -30
  85. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +27 -30
  86. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +27 -30
  87. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +27 -30
  88. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +27 -30
  89. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +27 -30
  90. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +27 -30
  91. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +27 -30
  92. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +27 -30
  93. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +27 -30
  94. data/site/news/2015/10/26/jekyll-3-0-released/index.html +27 -30
  95. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +27 -30
  96. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +27 -30
  97. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +27 -30
  98. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +27 -30
  99. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +27 -30
  100. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +27 -30
  101. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +27 -30
  102. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +27 -30
  103. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +27 -30
  104. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +27 -30
  105. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +27 -30
  106. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +27 -30
  107. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +27 -30
  108. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +27 -30
  109. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +27 -30
  110. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +27 -30
  111. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +27 -30
  112. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +27 -30
  113. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +27 -30
  114. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +27 -30
  115. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -30
  116. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +27 -30
  117. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +27 -30
  118. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +27 -30
  119. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +27 -30
  120. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +27 -30
  121. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +27 -30
  122. data/site/news/2017/10/19/diversity-open-source/index.html +31 -34
  123. data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +27 -30
  124. data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +27 -30
  125. data/site/news/2018/01/25/{jekyll-3-7-1-released → jekyll-3-7-2-released}/index.html +35 -37
  126. data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +628 -0
  127. data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +604 -0
  128. data/site/news/index.html +265 -168
  129. data/site/news/releases/index.html +185 -150
  130. data/site/sitemap.xml +78 -59
  131. data/site/team/index.html +258 -0
  132. data/site/tutorials/convert-site-to-jekyll/index.html +19 -25
  133. data/site/tutorials/custom-404-page/index.html +16 -24
  134. data/site/tutorials/home/index.html +16 -24
  135. data/site/tutorials/navigation/index.html +23 -28
  136. data/site/tutorials/orderofinterpretation/index.html +16 -24
  137. data/site/tutorials/using-jekyll-with-bundler/index.html +424 -0
  138. data/site/tutorials/video-walkthroughs/index.html +16 -24
  139. metadata +11 -6
@@ -4,16 +4,17 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.7.3">
7
+ <meta name="generator" content="Jekyll v3.8.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
- <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
10
+ <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
11
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
12
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
12
13
  <link rel="stylesheet" href="/css/screen.css">
13
14
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
15
  <!-- Begin Jekyll SEO tag v2.4.0 -->
15
16
  <title>Affinity Team Captains | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.7.3">
17
+ <meta name="generator" content="Jekyll v3.8.0">
17
18
  <meta property="og:title" content="Affinity Team Captains">
18
19
  <meta property="og:locale" content="en_US">
19
20
  <meta name="description" content="This guide is for affinity team captains. These special people are team maintainers of one of our affinity teams and help triage and evaluate the issues and contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.">
@@ -22,12 +23,12 @@
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/affinity-team-captain/">
23
24
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
24
25
  <meta property="og:type" content="article">
25
- <meta property="article:published_time" content="2018-03-27T03:44:17-07:00">
26
+ <meta property="article:published_time" content="2018-05-01T13:26:35-07:00">
26
27
  <meta name="twitter:card" content="summary">
27
28
  <meta name="twitter:site" content="@jekyllrb">
28
29
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
29
30
  <script type="application/ld+json">
30
- {"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Affinity Team Captains","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-07:00","description":"This guide is for affinity team captains. These special people are team maintainers of one of our affinity teams and help triage and evaluate the issues and contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/affinity-team-captain/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/affinity-team-captain/","@context":"http://schema.org"}</script>
31
+ {"description":"This guide is for affinity team captains. These special people are team maintainers of one of our affinity teams and help triage and evaluate the issues and contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/affinity-team-captain/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Affinity Team Captains","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/affinity-team-captain/"},"@context":"http://schema.org"}</script>
31
32
  <!-- End Jekyll SEO tag -->
32
33
 
33
34
  <!--[if lt IE 9]>
@@ -72,7 +73,7 @@
72
73
  <div class="meta hide-on-mobiles">
73
74
  <ul>
74
75
  <li>
75
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
76
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
76
77
  </li>
77
78
  <li>
78
79
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -678,28 +679,11 @@
678
679
  </script>
679
680
 
680
681
 
681
- <!-- Gauges (http://get.gaug.es/) -->
682
- <script>
683
- var _gauges = _gauges || [];
684
- (function() {
685
- var t = document.createElement('script');
686
- t.type = 'text/javascript';
687
- t.async = true;
688
- t.id = 'gauges-tracker';
689
- t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
690
- t.src = '//secure.gaug.es/track.js';
691
- var s = document.getElementsByTagName('script')[0];
692
- s.parentNode.insertBefore(t, s);
693
- })();
694
- </script>
695
-
696
-
697
-
698
682
  <!-- Google Analytics (https://www.google.com/analytics) -->
699
683
  <script>
700
684
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
701
685
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
702
- L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
686
+ L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
703
687
  L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
704
688
 
705
689
  ga('create', 'UA-50755011-1', 'jekyllrb.com');
@@ -3,16 +3,17 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <meta name="generator" content="Jekyll v3.7.3">
6
+ <meta name="generator" content="Jekyll v3.8.0">
7
7
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
8
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
9
- <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
9
+ <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
10
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
10
11
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
11
12
  <link rel="stylesheet" href="/css/screen.css">
12
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
14
  <!-- Begin Jekyll SEO tag v2.4.0 -->
14
15
  <title>Avoiding Burnout | Jekyll • Simple, blog-aware, static sites</title>
15
- <meta name="generator" content="Jekyll v3.7.3" />
16
+ <meta name="generator" content="Jekyll v3.8.0" />
16
17
  <meta property="og:title" content="Avoiding Burnout" />
17
18
  <meta property="og:locale" content="en_US" />
18
19
  <meta name="description" content="This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone." />
@@ -21,12 +22,12 @@
21
22
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/avoiding-burnout/" />
22
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
23
24
  <meta property="og:type" content="article" />
24
- <meta property="article:published_time" content="2018-03-27T03:44:17-07:00" />
25
+ <meta property="article:published_time" content="2018-05-01T13:26:35-07:00" />
25
26
  <meta name="twitter:card" content="summary" />
26
27
  <meta name="twitter:site" content="@jekyllrb" />
27
28
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
28
29
  <script type="application/ld+json">
29
- {"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Avoiding Burnout","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-07:00","description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/avoiding-burnout/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/avoiding-burnout/","@context":"http://schema.org"}</script>
30
+ {"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/avoiding-burnout/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Avoiding Burnout","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/avoiding-burnout/"},"@context":"http://schema.org"}</script>
30
31
  <!-- End Jekyll SEO tag -->
31
32
 
32
33
  <!--[if lt IE 9]>
@@ -71,7 +72,7 @@
71
72
  <div class="meta hide-on-mobiles">
72
73
  <ul>
73
74
  <li>
74
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
75
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
75
76
  </li>
76
77
  <li>
77
78
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -297,11 +298,11 @@
297
298
 
298
299
  <h1 id="1-use-jekyll">1. Use Jekyll</h1>
299
300
 
300
- <p>Maintainers of Jekyll should be using it regularly. This is partly because you won’t be a good maintainer unless you can put yourself in the shoes of our users but also because you may decide to stop using Jekyll and at that point you should also decide not to be a maintainer and find other things to work on.</p>
301
+ <p>Maintainers of Jekyll should be using it regularly. This is partly because you won’t be a good maintainer unless you can put yourself in the shoes of our users, but also because you may at some point decide to stop using Jekyll, and at that point you should also decide to stop being a maintainer and find other things to work on.</p>
301
302
 
302
303
  <h1 id="2-no-guilt-about-leaving">2. No Guilt About Leaving</h1>
303
304
 
304
- <p>All maintainers can stop working on Jekyll at any time without any guilt or explanation (like a job). We may still ask for your help with questions after you leave but you are under no obligation to answer them. Like a job, if you create a big mess and then leave you still have no obligations but we may think less of you (or, realistically, probably just revert the problematic work). Like a job, you should probably take a break from Jekyll at least a few times a year.</p>
305
+ <p>All maintainers can stop working on Jekyll at any time without any guilt or explanation (like at a job). We may still ask for your help with questions after you leave but you are under no obligation to answer them. If you create a big mess and then leave you still have no obligations but we may think less of you (or, realistically, probably just revert the problematic work). Also, you should probably take a break from Jekyll at least a few times a year.</p>
305
306
 
306
307
  <p>This also means contributors should be consumers. If a maintainer finds they are not using a project in the real-world, they should reconsider their involvement with the project.</p>
307
308
 
@@ -680,28 +681,11 @@
680
681
  </script>
681
682
 
682
683
 
683
- <!-- Gauges (http://get.gaug.es/) -->
684
- <script>
685
- var _gauges = _gauges || [];
686
- (function() {
687
- var t = document.createElement('script');
688
- t.type = 'text/javascript';
689
- t.async = true;
690
- t.id = 'gauges-tracker';
691
- t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
692
- t.src = '//secure.gaug.es/track.js';
693
- var s = document.getElementsByTagName('script')[0];
694
- s.parentNode.insertBefore(t, s);
695
- })();
696
- </script>
697
-
698
-
699
-
700
684
  <!-- Google Analytics (https://www.google.com/analytics) -->
701
685
  <script>
702
686
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
703
687
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
704
- L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
688
+ L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
705
689
  L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
706
690
 
707
691
  ga('create', 'UA-50755011-1', 'jekyllrb.com');
@@ -4,16 +4,17 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.7.3">
7
+ <meta name="generator" content="Jekyll v3.8.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
- <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
10
+ <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
11
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
12
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
12
13
  <link rel="stylesheet" href="/css/screen.css">
13
14
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
15
  <!-- Begin Jekyll SEO tag v2.4.0 -->
15
16
  <title>Becoming a Maintainer | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.7.3">
17
+ <meta name="generator" content="Jekyll v3.8.0">
17
18
  <meta property="og:title" content="Becoming a Maintainer">
18
19
  <meta property="og:locale" content="en_US">
19
20
  <meta name="description" content="This guide is for contributors. These special people have contributed to one or more of Jekyll’s repositories, but do not yet have write access to any. You may find what is written here interesting, but it’s definitely not for everyone.">
@@ -22,12 +23,12 @@
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/becoming-a-maintainer/">
23
24
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
24
25
  <meta property="og:type" content="article">
25
- <meta property="article:published_time" content="2018-03-27T03:44:17-07:00">
26
+ <meta property="article:published_time" content="2018-05-01T13:26:35-07:00">
26
27
  <meta name="twitter:card" content="summary">
27
28
  <meta name="twitter:site" content="@jekyllrb">
28
29
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
29
30
  <script type="application/ld+json">
30
- {"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Becoming a Maintainer","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-07:00","description":"This guide is for contributors. These special people have contributed to one or more of Jekyll’s repositories, but do not yet have write access to any. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/becoming-a-maintainer/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/becoming-a-maintainer/","@context":"http://schema.org"}</script>
31
+ {"description":"This guide is for contributors. These special people have contributed to one or more of Jekyll’s repositories, but do not yet have write access to any. You may find what is written here interesting, but it’s definitely not for everyone.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/becoming-a-maintainer/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Becoming a Maintainer","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/becoming-a-maintainer/"},"@context":"http://schema.org"}</script>
31
32
  <!-- End Jekyll SEO tag -->
32
33
 
33
34
  <!--[if lt IE 9]>
@@ -72,7 +73,7 @@
72
73
  <div class="meta hide-on-mobiles">
73
74
  <ul>
74
75
  <li>
75
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
76
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
76
77
  </li>
77
78
  <li>
78
79
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -689,28 +690,11 @@
689
690
  </script>
690
691
 
691
692
 
692
- <!-- Gauges (http://get.gaug.es/) -->
693
- <script>
694
- var _gauges = _gauges || [];
695
- (function() {
696
- var t = document.createElement('script');
697
- t.type = 'text/javascript';
698
- t.async = true;
699
- t.id = 'gauges-tracker';
700
- t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
701
- t.src = '//secure.gaug.es/track.js';
702
- var s = document.getElementsByTagName('script')[0];
703
- s.parentNode.insertBefore(t, s);
704
- })();
705
- </script>
706
-
707
-
708
-
709
693
  <!-- Google Analytics (https://www.google.com/analytics) -->
710
694
  <script>
711
695
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
712
696
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
713
- L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
697
+ L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
714
698
  L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
715
699
 
716
700
  ga('create', 'UA-50755011-1', 'jekyllrb.com');
@@ -3,16 +3,17 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <meta name="generator" content="Jekyll v3.7.3">
6
+ <meta name="generator" content="Jekyll v3.8.0">
7
7
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
8
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
9
- <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
9
+ <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
10
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
10
11
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
11
12
  <link rel="stylesheet" href="/css/screen.css">
12
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
14
  <!-- Begin Jekyll SEO tag v2.4.0 -->
14
15
  <title>Maintaining Jekyll | Jekyll • Simple, blog-aware, static sites</title>
15
- <meta name="generator" content="Jekyll v3.7.3" />
16
+ <meta name="generator" content="Jekyll v3.8.0" />
16
17
  <meta property="og:title" content="Maintaining Jekyll" />
17
18
  <meta property="og:locale" content="en_US" />
18
19
  <meta name="description" content="This guide is for Jekyll contributors and maintainers. These special people contribute to one or more of Jekyll’s repositories or help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone." />
@@ -21,12 +22,12 @@
21
22
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/" />
22
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
23
24
  <meta property="og:type" content="article" />
24
- <meta property="article:published_time" content="2018-03-27T03:44:17-07:00" />
25
+ <meta property="article:published_time" content="2018-05-01T13:26:35-07:00" />
25
26
  <meta name="twitter:card" content="summary" />
26
27
  <meta name="twitter:site" content="@jekyllrb" />
27
28
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
28
29
  <script type="application/ld+json">
29
- {"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Maintaining Jekyll","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-07:00","description":"This guide is for Jekyll contributors and maintainers. These special people contribute to one or more of Jekyll’s repositories or help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/","@context":"http://schema.org"}</script>
30
+ {"description":"This guide is for Jekyll contributors and maintainers. These special people contribute to one or more of Jekyll’s repositories or help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Maintaining Jekyll","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/"},"@context":"http://schema.org"}</script>
30
31
  <!-- End Jekyll SEO tag -->
31
32
 
32
33
  <!--[if lt IE 9]>
@@ -71,7 +72,7 @@
71
72
  <div class="meta hide-on-mobiles">
72
73
  <ul>
73
74
  <li>
74
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
75
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
75
76
  </li>
76
77
  <li>
77
78
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -297,20 +298,21 @@
297
298
 
298
299
  <p>Hello! This is where we document various processes for maintaining Jekyll. Being a maintainer for any Jekyll project is a big responsibility, so we put together some helpful documentation for various tasks you might do as a maintainer.</p>
299
300
 
300
- <ol>
301
+ <ul>
301
302
  <li><a href="affinity-team-captain/">Affinity teams &amp; their captains</a></li>
302
- <li><a href="triaging-an-issue/">Triaging and issue</a></li>
303
+ <li><a href="triaging-an-issue/">Triaging an issue</a></li>
303
304
  <li><a href="reviewing-a-pull-request/">Reviewing a pull request</a></li>
304
305
  <li><a href="merging-a-pull-request/">Merging a pull request</a></li>
305
306
  <li><a href="avoiding-burnout/">Avoiding burnout</a></li>
306
307
  <li><a href="special-labels/">Special Labels</a></li>
307
- </ol>
308
+ <li><a href="releasing-a-new-version/">Releasing a new version</a></li>
309
+ </ul>
308
310
 
309
311
  <p>Interested in becoming a maintainer? Here is some documentation for <strong>contributors</strong>:</p>
310
312
 
311
- <ol>
313
+ <ul>
312
314
  <li><a href="becoming-a-maintainer/">Becoming a maintainer</a></li>
313
- </ol>
315
+ </ul>
314
316
 
315
317
 
316
318
 
@@ -684,28 +686,11 @@
684
686
  </script>
685
687
 
686
688
 
687
- <!-- Gauges (http://get.gaug.es/) -->
688
- <script>
689
- var _gauges = _gauges || [];
690
- (function() {
691
- var t = document.createElement('script');
692
- t.type = 'text/javascript';
693
- t.async = true;
694
- t.id = 'gauges-tracker';
695
- t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
696
- t.src = '//secure.gaug.es/track.js';
697
- var s = document.getElementsByTagName('script')[0];
698
- s.parentNode.insertBefore(t, s);
699
- })();
700
- </script>
701
-
702
-
703
-
704
689
  <!-- Google Analytics (https://www.google.com/analytics) -->
705
690
  <script>
706
691
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
707
692
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
708
- L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
693
+ L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
709
694
  L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
710
695
 
711
696
  ga('create', 'UA-50755011-1', 'jekyllrb.com');
@@ -4,16 +4,17 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.7.3">
7
+ <meta name="generator" content="Jekyll v3.8.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
- <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
10
+ <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
11
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
12
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
12
13
  <link rel="stylesheet" href="/css/screen.css">
13
14
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
15
  <!-- Begin Jekyll SEO tag v2.4.0 -->
15
16
  <title>Merging a Pull Request | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.7.3">
17
+ <meta name="generator" content="Jekyll v3.8.0">
17
18
  <meta property="og:title" content="Merging a Pull Request">
18
19
  <meta property="og:locale" content="en_US">
19
20
  <meta name="description" content="This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.">
@@ -22,12 +23,12 @@
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/merging-a-pull-request/">
23
24
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
24
25
  <meta property="og:type" content="article">
25
- <meta property="article:published_time" content="2018-03-27T03:44:17-07:00">
26
+ <meta property="article:published_time" content="2018-05-01T13:26:35-07:00">
26
27
  <meta name="twitter:card" content="summary">
27
28
  <meta name="twitter:site" content="@jekyllrb">
28
29
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
29
30
  <script type="application/ld+json">
30
- {"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Merging a Pull Request","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-07:00","description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/","@context":"http://schema.org"}</script>
31
+ {"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Merging a Pull Request","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/"},"@context":"http://schema.org"}</script>
31
32
  <!-- End Jekyll SEO tag -->
32
33
 
33
34
  <!--[if lt IE 9]>
@@ -72,7 +73,7 @@
72
73
  <div class="meta hide-on-mobiles">
73
74
  <ul>
74
75
  <li>
75
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
76
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
76
77
  </li>
77
78
  <li>
78
79
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -308,7 +309,7 @@
308
309
 
309
310
  <ol>
310
311
  <li>You can’t modify anything on mobile (e.g. titles, labels)</li>
311
- <li>Provide a consistent paper trail in the <code class="highlighter-rouge">History.markdown</code> file for each release</li>
312
+ <li>We like to provide a consistent paper trail in the <code class="highlighter-rouge">History.markdown</code> file for each release</li>
312
313
  </ol>
313
314
 
314
315
  <p>To merge a pull request, leave a comment thanking the contributor, then add the special merge request:</p>
@@ -326,14 +327,14 @@
326
327
  <li>
327
328
  <code class="highlighter-rouge">merge</code> – the command</li>
328
329
  <li>
329
- <code class="highlighter-rouge">+dev</code> – the category to which the changes belong</li>
330
+ <code class="highlighter-rouge">+dev</code> – the category to which the changes belong.</li>
330
331
  </ol>
331
332
 
332
- <p>The categories match the H3’s in the history/changelog file, and they are:</p>
333
+ <p>The categories match the headings in the <code class="highlighter-rouge">History.markdown</code> file, and they are:</p>
333
334
 
334
335
  <ol>
335
336
  <li>Major Enhancements (<code class="highlighter-rouge">+major</code>) – major updates or breaking changes to the code which necessitate a major version bump (v3 ~&gt; v4)</li>
336
- <li>Minor Enhancements (<code class="highlighter-rouge">+minor</code>) – minor updates (feature, enhancement) which necessitate a minor version bump (v3.1 ~&gt; v3.2)</li>
337
+ <li>Minor Enhancements (<code class="highlighter-rouge">+minor</code>) – minor updates (with the labels <code class="highlighter-rouge">feature</code> or <code class="highlighter-rouge">enhancement</code>) which necessitate a minor version bump (v3.1 ~&gt; v3.2)</li>
337
338
  <li>Bug Fixes (<code class="highlighter-rouge">+bug</code>) – corrections to code which do not change or add functionality, which necessitate a patch version bump (v3.1.0 ~&gt; v3.1.1)</li>
338
339
  <li>Documentation (<code class="highlighter-rouge">+doc</code>) - changes to the documentation found in <code class="highlighter-rouge">docs/_docs/</code>
339
340
  </li>
@@ -719,28 +720,11 @@
719
720
  </script>
720
721
 
721
722
 
722
- <!-- Gauges (http://get.gaug.es/) -->
723
- <script>
724
- var _gauges = _gauges || [];
725
- (function() {
726
- var t = document.createElement('script');
727
- t.type = 'text/javascript';
728
- t.async = true;
729
- t.id = 'gauges-tracker';
730
- t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
731
- t.src = '//secure.gaug.es/track.js';
732
- var s = document.getElementsByTagName('script')[0];
733
- s.parentNode.insertBefore(t, s);
734
- })();
735
- </script>
736
-
737
-
738
-
739
723
  <!-- Google Analytics (https://www.google.com/analytics) -->
740
724
  <script>
741
725
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
742
726
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
743
- L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
727
+ L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
744
728
  L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
745
729
 
746
730
  ga('create', 'UA-50755011-1', 'jekyllrb.com');
@@ -0,0 +1,761 @@
1
+ <!DOCTYPE HTML>
2
+ <html lang="en-US">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <meta charset="UTF-8">
6
+ <meta name="viewport" content="width=device-width,initial-scale=1">
7
+ <meta name="generator" content="Jekyll v3.8.0">
8
+ <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
+ <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
+ <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
11
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
12
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
13
+ <link rel="stylesheet" href="/css/screen.css">
14
+ <link rel="icon" type="image/x-icon" href="/favicon.ico">
15
+ <!-- Begin Jekyll SEO tag v2.4.0 -->
16
+ <title>Releasing a new version | Jekyll • Simple, blog-aware, static sites</title>
17
+ <meta name="generator" content="Jekyll v3.8.0">
18
+ <meta property="og:title" content="Releasing a new version">
19
+ <meta property="og:locale" content="en_US">
20
+ <meta name="description" content="This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.">
21
+ <meta property="og:description" content="This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.">
22
+ <link rel="canonical" href="https://jekyllrb.com/docs/maintaining/releasing-a-new-version/">
23
+ <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/releasing-a-new-version/">
24
+ <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
25
+ <meta property="og:type" content="article">
26
+ <meta property="article:published_time" content="2018-05-01T13:26:35-07:00">
27
+ <meta name="twitter:card" content="summary">
28
+ <meta name="twitter:site" content="@jekyllrb">
29
+ <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
30
+ <script type="application/ld+json">
31
+ {"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/maintaining/releasing-a-new-version/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Releasing a new version","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/releasing-a-new-version/"},"@context":"http://schema.org"}</script>
32
+ <!-- End Jekyll SEO tag -->
33
+
34
+ <!--[if lt IE 9]>
35
+ <script src="/js/html5shiv.min.js"></script>
36
+ <script src="/js/respond.min.js"></script>
37
+ <![endif]-->
38
+ </head>
39
+
40
+
41
+ <body class="wrap">
42
+ <header>
43
+ <div class="flexbox">
44
+ <div class="center-on-mobiles">
45
+ <h1>
46
+ <a href="/" class="logo">
47
+ <span class="sr-only">Jekyll</span>
48
+ <img src="/img/logo-2x.png" width="140" height="65" alt="Jekyll Logo">
49
+ </a>
50
+ </h1>
51
+ </div>
52
+ <nav class="main-nav hide-on-mobiles">
53
+ <ul>
54
+ <li class="">
55
+ <a href="/">Home</a>
56
+ </li>
57
+ <li class="current">
58
+ <a href="/docs/home/">Docs</a>
59
+ </li>
60
+ <li class="">
61
+ <a href="/news/">News</a>
62
+ </li>
63
+ <li class="">
64
+ <a href="/help/">Help</a>
65
+ </li>
66
+ </ul>
67
+
68
+ </nav>
69
+ <div class="search hide-on-mobiles">
70
+ <input type="text" id="docsearch-input" placeholder="Search the docs…">
71
+
72
+ </div>
73
+ <div class="meta hide-on-mobiles">
74
+ <ul>
75
+ <li>
76
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
77
+ </li>
78
+ <li>
79
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
80
+ </li>
81
+ </ul>
82
+ </div>
83
+ </div>
84
+ <nav class="mobile-nav show-on-mobiles">
85
+ <ul>
86
+ <li class="">
87
+ <a href="/">Home</a>
88
+ </li>
89
+ <li class="current">
90
+ <a href="/docs/home/">Docs</a>
91
+ </li>
92
+ <li class="">
93
+ <a href="/news/">News</a>
94
+ </li>
95
+ <li class="">
96
+ <a href="/help/">Help</a>
97
+ </li>
98
+ <li>
99
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
100
+ </li>
101
+ </ul>
102
+
103
+ </nav>
104
+ </header>
105
+
106
+
107
+ <section class="docs">
108
+ <div class="grid">
109
+
110
+ <div class="docs-nav-mobile unit whole show-on-mobiles">
111
+ <select onchange="if (this.value) window.location.href=this.value">
112
+ <option value="">Navigate the docs…</option>
113
+
114
+ <optgroup label="Getting Started">
115
+
116
+
117
+
118
+ <option value="/docs/home/">Welcome</option>
119
+
120
+
121
+
122
+ <option value="/docs/quickstart/">Quick-start guide</option>
123
+
124
+
125
+
126
+ <option value="/docs/installation/">Installation</option>
127
+
128
+
129
+
130
+ <option value="/docs/windows/">Jekyll on Windows</option>
131
+
132
+
133
+
134
+ <option value="/docs/usage/">Basic Usage</option>
135
+
136
+
137
+
138
+ <option value="/docs/structure/">Directory structure</option>
139
+
140
+
141
+
142
+ <option value="/docs/configuration/">Configuration</option>
143
+
144
+
145
+ </optgroup>
146
+
147
+ <optgroup label="Your Content">
148
+
149
+
150
+
151
+ <option value="/docs/frontmatter/">Front Matter</option>
152
+
153
+
154
+
155
+ <option value="/docs/posts/">Writing posts</option>
156
+
157
+
158
+
159
+ <option value="/docs/drafts/">Working with drafts</option>
160
+
161
+
162
+
163
+ <option value="/docs/pages/">Creating pages</option>
164
+
165
+
166
+
167
+ <option value="/docs/static-files/">Static Files</option>
168
+
169
+
170
+
171
+ <option value="/docs/variables/">Variables</option>
172
+
173
+
174
+
175
+ <option value="/docs/collections/">Collections</option>
176
+
177
+
178
+
179
+ <option value="/docs/datafiles/">Data Files</option>
180
+
181
+
182
+
183
+ <option value="/docs/assets/">Assets</option>
184
+
185
+
186
+
187
+ <option value="/docs/migrations/">Blog migrations</option>
188
+
189
+
190
+ </optgroup>
191
+
192
+ <optgroup label="Customization">
193
+
194
+
195
+
196
+ <option value="/docs/templates/">Templates</option>
197
+
198
+
199
+
200
+ <option value="/docs/includes/">Includes</option>
201
+
202
+
203
+
204
+ <option value="/docs/permalinks/">Permalinks</option>
205
+
206
+
207
+
208
+ <option value="/docs/pagination/">Pagination</option>
209
+
210
+
211
+
212
+ <option value="/docs/plugins/">Plugins</option>
213
+
214
+
215
+
216
+ <option value="/docs/themes/">Themes</option>
217
+
218
+
219
+
220
+ <option value="/docs/extras/">Extras</option>
221
+
222
+
223
+ </optgroup>
224
+
225
+ <optgroup label="Deployment">
226
+
227
+
228
+
229
+ <option value="/docs/github-pages/">GitHub Pages</option>
230
+
231
+
232
+
233
+ <option value="/docs/deployment-methods/">Deployment methods</option>
234
+
235
+
236
+
237
+ <option value="/docs/continuous-integration/">Continuous Integration</option>
238
+
239
+
240
+ </optgroup>
241
+
242
+ <optgroup label="Miscellaneous">
243
+
244
+
245
+
246
+ <option value="/docs/troubleshooting/">Troubleshooting</option>
247
+
248
+
249
+
250
+ <option value="/docs/sites/">Sites using Jekyll</option>
251
+
252
+
253
+
254
+ <option value="/docs/resources/">Resources</option>
255
+
256
+
257
+
258
+ <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
259
+
260
+
261
+
262
+ <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
263
+
264
+
265
+ </optgroup>
266
+
267
+ <optgroup label="Meta">
268
+
269
+
270
+
271
+ <option value="/docs/contributing/">Contributing</option>
272
+
273
+
274
+
275
+ <option value="/docs/maintaining/">Maintaining Jekyll</option>
276
+
277
+
278
+
279
+ <option value="/docs/conduct/">Code of Conduct</option>
280
+
281
+
282
+
283
+ <option value="/docs/history/">History</option>
284
+
285
+
286
+ </optgroup>
287
+
288
+ </select>
289
+ </div>
290
+
291
+
292
+ <div class="unit four-fifths">
293
+ <article>
294
+ <div class="improve right hide-on-mobiles">
295
+ <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/maintaining/releasing-a-new-version.md"><i class="fa fa-pencil"></i>  Improve this page</a>
296
+ </div>
297
+ <h1>Releasing a new version</h1>
298
+ <p class="note info"><strong>This guide is for maintainers.</strong> These special people have <strong>write access</strong> to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.</p>
299
+
300
+ <p>The most important thing to understand before making a release is that there’s no need to feel nervous. Most things are revertable, and even if you do publish an incomplete gem version, we can always skip that one. Don’t hestitate to contact the other maintainers if you feel unsure or don’t know what to do next.</p>
301
+
302
+ <h3 id="bump-the-version">Bump the version</h3>
303
+
304
+ <p>The only important place you need to manually bump the version is in <code class="highlighter-rouge">lib/jekyll/version.rb</code>. Adjust that, and everything else should work fine.</p>
305
+
306
+ <h3 id="update-the-history-document">Update the history document</h3>
307
+
308
+ <p>Replace the first header of the history document with a version milestone. This looks like the following:</p>
309
+
310
+ <div class="language-diff highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="gd">-## HEAD
311
+ </span><span class="gi">+## 3.7.1 / 2018-01-25
312
+ </span></code></pre></div></div>
313
+
314
+ <p>Adjust the version number and the date. The <code class="highlighter-rouge">## HEAD</code> heading will be regenerated next time a pull request is merged.</p>
315
+
316
+ <p>Once you’ve done this, update the website by running the following command:</p>
317
+
318
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bundle <span class="nb">exec </span>rake site:generate
319
+ </code></pre></div></div>
320
+
321
+ <p>This updates the website’s changelog, and pushes the versions in various other places.</p>
322
+
323
+ <p>It’s recommended that you go over the <code class="highlighter-rouge">History.markdown</code> file manually one more time, in case there are any spelling errors or such. Feel free to fix those manually, and after you’re done generating the website changelog, commit your changes.</p>
324
+
325
+ <h2 id="write-a-release-post">Write a release post</h2>
326
+
327
+ <p>In case this isn’t done already, you can generate a new release post using the included <code class="highlighter-rouge">rake</code> command:</p>
328
+
329
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bundle <span class="nb">exec </span>rake site:releases:new[3.8.0]
330
+ </code></pre></div></div>
331
+
332
+ <p>where <code class="highlighter-rouge">3.8.0</code> should be replaced with the new version. Then, write the post. Be sure to thank all of the collaborators and maintainers who have contributed since the last release. You can generate a log of their names using the following command:</p>
333
+
334
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git shortlog <span class="nt">-sn</span> master...v3.7.2
335
+ </code></pre></div></div>
336
+
337
+ <p>where, again <code class="highlighter-rouge">v3.7.2</code> is the last release. Be sure to open a pull request for your release post.</p>
338
+
339
+ <h3 id="push-the-version">Push the version</h3>
340
+
341
+ <p>Before you do this step, make sure the following things are done:</p>
342
+
343
+ <ul>
344
+ <li>You have permission to push a new gem version to RubyGems</li>
345
+ <li>You’re logged into RubyGems on your command line</li>
346
+ <li>A release post has been prepared, and is ideally already live</li>
347
+ <li>All of the prior steps are done, committed, and pushed to <code class="highlighter-rouge">master</code>
348
+ </li>
349
+ </ul>
350
+
351
+ <p>Really the only thing left to do is to run this command:</p>
352
+
353
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bundle <span class="nb">exec </span>rake release
354
+ </code></pre></div></div>
355
+
356
+ <p>This will automatically build the new gem, make a release commit and tag and then push the new gem to RubyGems. Don’t worry about creating a GitHub release, <a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> should take care of that.</p>
357
+
358
+ <p>And then, you’re done! <img class="emoji" title=":tada:" alt=":tada:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"> Feel free to celebrate!</p>
359
+
360
+ <p>If you have access to the <a href="https://twitter.com/jekyllrb">@jekyllrb</a> Twitter account, you should tweet the release post from there. If not, just ask another maintainer to do it or to give you access.</p>
361
+
362
+ <h2 id="for-non-core-gems">For non-core gems</h2>
363
+
364
+ <p>If you’re not a maintainer for <code class="highlighter-rouge">jekyll/jekyll</code>, the procedure is much simpler in a lot of cases. Generally, the procedure still looks like this:</p>
365
+
366
+ <ul>
367
+ <li>Bump the gem version manually, usually in <code class="highlighter-rouge">lib/&lt;plugin_name&gt;/version.rb</code>
368
+ </li>
369
+ <li>Adjust the history file</li>
370
+ <li>Run <code class="highlighter-rouge">bundle exec rake release</code> or <code class="highlighter-rouge">script/release</code>, depending on which of the two exists</li>
371
+ <li>Rejoice</li>
372
+ </ul>
373
+
374
+ <p>Be sure to ask your project’s maintainers if you’re unsure!</p>
375
+
376
+
377
+
378
+
379
+
380
+
381
+
382
+
383
+
384
+
385
+
386
+
387
+
388
+
389
+
390
+
391
+
392
+
393
+
394
+
395
+
396
+
397
+
398
+
399
+
400
+
401
+
402
+
403
+
404
+
405
+
406
+
407
+
408
+
409
+
410
+
411
+
412
+
413
+
414
+
415
+
416
+
417
+
418
+
419
+
420
+
421
+
422
+
423
+
424
+
425
+
426
+
427
+
428
+
429
+
430
+
431
+
432
+
433
+
434
+
435
+
436
+
437
+
438
+
439
+
440
+
441
+
442
+
443
+
444
+
445
+
446
+
447
+
448
+
449
+
450
+
451
+
452
+
453
+
454
+
455
+
456
+
457
+
458
+
459
+
460
+
461
+
462
+
463
+
464
+
465
+
466
+
467
+
468
+
469
+
470
+
471
+
472
+
473
+
474
+
475
+
476
+
477
+
478
+
479
+
480
+
481
+
482
+
483
+
484
+
485
+
486
+
487
+
488
+
489
+
490
+ </article>
491
+ </div>
492
+
493
+ <div class="unit one-fifth hide-on-mobiles">
494
+ <aside>
495
+
496
+ <h4>Getting Started</h4>
497
+ <ul>
498
+
499
+
500
+
501
+ <li class=""><a href="/docs/home/">Welcome</a></li>
502
+
503
+
504
+
505
+ <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
506
+
507
+
508
+
509
+ <li class=""><a href="/docs/installation/">Installation</a></li>
510
+
511
+
512
+
513
+ <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
514
+
515
+
516
+
517
+ <li class=""><a href="/docs/usage/">Basic Usage</a></li>
518
+
519
+
520
+
521
+ <li class=""><a href="/docs/structure/">Directory structure</a></li>
522
+
523
+
524
+
525
+ <li class=""><a href="/docs/configuration/">Configuration</a></li>
526
+
527
+ </ul>
528
+
529
+
530
+ <h4>Your Content</h4>
531
+ <ul>
532
+
533
+
534
+
535
+ <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
536
+
537
+
538
+
539
+ <li class=""><a href="/docs/posts/">Writing posts</a></li>
540
+
541
+
542
+
543
+ <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
544
+
545
+
546
+
547
+ <li class=""><a href="/docs/pages/">Creating pages</a></li>
548
+
549
+
550
+
551
+ <li class=""><a href="/docs/static-files/">Static Files</a></li>
552
+
553
+
554
+
555
+ <li class=""><a href="/docs/variables/">Variables</a></li>
556
+
557
+
558
+
559
+ <li class=""><a href="/docs/collections/">Collections</a></li>
560
+
561
+
562
+
563
+ <li class=""><a href="/docs/datafiles/">Data Files</a></li>
564
+
565
+
566
+
567
+ <li class=""><a href="/docs/assets/">Assets</a></li>
568
+
569
+
570
+
571
+ <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
572
+
573
+ </ul>
574
+
575
+
576
+ <h4>Customization</h4>
577
+ <ul>
578
+
579
+
580
+
581
+ <li class=""><a href="/docs/templates/">Templates</a></li>
582
+
583
+
584
+
585
+ <li class=""><a href="/docs/includes/">Includes</a></li>
586
+
587
+
588
+
589
+ <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
590
+
591
+
592
+
593
+ <li class=""><a href="/docs/pagination/">Pagination</a></li>
594
+
595
+
596
+
597
+ <li class=""><a href="/docs/plugins/">Plugins</a></li>
598
+
599
+
600
+
601
+ <li class=""><a href="/docs/themes/">Themes</a></li>
602
+
603
+
604
+
605
+ <li class=""><a href="/docs/extras/">Extras</a></li>
606
+
607
+ </ul>
608
+
609
+
610
+ <h4>Deployment</h4>
611
+ <ul>
612
+
613
+
614
+
615
+ <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
616
+
617
+
618
+
619
+ <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
620
+
621
+
622
+
623
+ <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
624
+
625
+ </ul>
626
+
627
+
628
+ <h4>Miscellaneous</h4>
629
+ <ul>
630
+
631
+
632
+
633
+ <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
634
+
635
+
636
+
637
+ <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
638
+
639
+
640
+
641
+ <li class=""><a href="/docs/resources/">Resources</a></li>
642
+
643
+
644
+
645
+ <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
646
+
647
+
648
+
649
+ <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
650
+
651
+ </ul>
652
+
653
+
654
+ <h4>Meta</h4>
655
+ <ul>
656
+
657
+
658
+
659
+ <li class=""><a href="/docs/contributing/">Contributing</a></li>
660
+
661
+
662
+
663
+ <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
664
+
665
+
666
+
667
+ <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
668
+
669
+
670
+
671
+ <li class=""><a href="/docs/history/">History</a></li>
672
+
673
+ </ul>
674
+
675
+
676
+ </aside>
677
+ </div>
678
+
679
+
680
+ <div class="clear"></div>
681
+
682
+ </div>
683
+ </section>
684
+
685
+
686
+ <footer>
687
+ <div class="grid">
688
+ <div class="unit one-third center-on-mobiles">
689
+ <p>The contents of this website are <br>© 2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
690
+ </div>
691
+ <div class="unit two-thirds align-right center-on-mobiles">
692
+ <p>
693
+ Proudly hosted by
694
+ <a href="https://github.com">
695
+ <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
696
+ </a>
697
+ </p>
698
+ </div>
699
+ </div>
700
+ </footer>
701
+
702
+ <script>
703
+ var anchorForId = function (id) {
704
+ var anchor = document.createElement("a");
705
+ anchor.className = "header-link";
706
+ anchor.href = "#" + id;
707
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
708
+ anchor.title = "Permalink";
709
+ return anchor;
710
+ };
711
+
712
+ var linkifyAnchors = function (level, containingElement) {
713
+ var headers = containingElement.getElementsByTagName("h" + level);
714
+ for (var h = 0; h < headers.length; h++) {
715
+ var header = headers[h];
716
+
717
+ if (typeof header.id !== "undefined" && header.id !== "") {
718
+ header.appendChild(anchorForId(header.id));
719
+ }
720
+ }
721
+ };
722
+
723
+ document.onreadystatechange = function () {
724
+ if (this.readyState === "complete") {
725
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
726
+ if (!contentBlock) {
727
+ return;
728
+ }
729
+ for (var level = 1; level <= 6; level++) {
730
+ linkifyAnchors(level, contentBlock);
731
+ }
732
+ }
733
+ };
734
+ </script>
735
+
736
+
737
+ <!-- Google Analytics (https://www.google.com/analytics) -->
738
+ <script>
739
+ !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
740
+ (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
741
+ L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
742
+ L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
743
+
744
+ ga('create', 'UA-50755011-1', 'jekyllrb.com');
745
+ ga('send', 'pageview');
746
+
747
+ </script>
748
+
749
+
750
+ <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
751
+ <script type="text/javascript"> docsearch({
752
+ apiKey: '50fe39c839958dfad797000f33e2ec17',
753
+ indexName: 'jekyllrb',
754
+ inputSelector: '#docsearch-input',
755
+ enhancedSearchInput: true,
756
+ debug: false // Set debug to true if you want to inspect the dropdown
757
+ });
758
+ </script>
759
+
760
+ </body>
761
+ </html>