Jekyll v4.0 release (#7782)

Merge pull request 7782

History.markdown

@@ -1,4 +1,4 @@
-## HEAD
+## 4.0.0 / 2019-08-19
 
 ### Major Enhancements
 

docs/_config.yml

@@ -1,5 +1,5 @@
 ---
-version: 3.8.6
+version: 4.0.0
 name: Jekyll • Simple, blog-aware, static sites
 description: Transform your plain text into static websites and blogs
 url: https://jekyllrb.com
@@ -10,7 +10,6 @@ twitter:
 logo: "/img/logo-2x.png"
 google_analytics_id: UA-50755011-1
 google_site_verification: onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY
-
 collections:
   docs:
     permalink: "/:collection/:path/"
@@ -20,7 +19,6 @@ collections:
     output: true
   tutorials:
     output: true
-
 defaults:
 - scope:
     path: _docs
@@ -33,10 +31,10 @@ defaults:
   values:
     layout: news_item
 - scope:
-    path: ""
+    path: ''
   values:
     image: "/img/jekyll-og.png"
-
+future: true
 plugins:
 - jekyll-avatar
 - jekyll-feed
@@ -45,19 +43,15 @@ plugins:
 - jekyll-seo-tag
 - jekyll-sitemap
 - jemoji
-
 feed:
   categories:
-    - release
-
+  - release
 sass:
   style: compressed
-
 strict_front_matter: true
-
 exclude:
-- .gitignore
-- .jekyll-cache
+- ".gitignore"
+- ".jekyll-cache"
 - CNAME
 - icomoon-selection.json
 - readme.md

docs/_docs/history.md

@@ -4,6 +4,305 @@ permalink: "/docs/history/"
 note: This file is autogenerated. Edit /History.markdown instead.
 ---
 
+## 4.0.0 / 2019-08-19
+{: #v4-0-0}
+
+### Major Enhancements
+{: #major-enhancements-v4-0-0}
+
+- Drop ruby 2.3 ([#7454]({{ site.repository }}/issues/7454))
+- Drop support for Ruby 2.1 and 2.2 ([#6560]({{ site.repository }}/issues/6560))
+- Drop support for older versions of Rouge ([#6978]({{ site.repository }}/issues/6978))
+- Drop support for pygments as syntax-highlighter ([#7118]({{ site.repository }}/issues/7118))
+- Drop support for Redcarpet ([#6987]({{ site.repository }}/issues/6987))
+- Drop support for rdiscount ([#6988]({{ site.repository }}/issues/6988))
+- Drop support for `jekyll-watch-1.4.0` and older ([#7287]({{ site.repository }}/issues/7287))
+- Incorporate `relative_url` filter in `link` tag ([#6727]({{ site.repository }}/issues/6727))
+- Upgrade kramdown dependency to v2.x ([#7492]({{ site.repository }}/issues/7492))
+- Upgrade jekyll-sass-converter to v2.x - Sassc + sourcemaps ([#7778]({{ site.repository }}/issues/7778))
+- Upgrade i18n to v1.x ([#6931]({{ site.repository }}/issues/6931))
+- Add `Jekyll::Cache` class to handle caching on disk ([#7169]({{ site.repository }}/issues/7169))
+- Cache converted markdown ([#7159]({{ site.repository }}/issues/7159))
+- Cache: Do not dump undumpable objects ([#7190]({{ site.repository }}/issues/7190))
+- Cache matched defaults sets for given parameters ([#6888]({{ site.repository }}/issues/6888))
+- Ignore cache directory ([#7184]({{ site.repository }}/issues/7184))
+- Add `Site#in_cache_dir` helper method ([#7160]({{ site.repository }}/issues/7160))
+- Remove 'cache_dir' during `jekyll clean` ([#7158]({{ site.repository }}/issues/7158))
+- Cache parsed Liquid templates in memory ([#7136]({{ site.repository }}/issues/7136))
+- Only read layouts from source_dir or theme_dir ([#6788]({{ site.repository }}/issues/6788))
+- Allow custom sorting of collection documents ([#7427]({{ site.repository }}/issues/7427))
+- Always exclude certain paths from being processed ([#7188]({{ site.repository }}/issues/7188))
+- Remove Jekyll::Utils#strip_heredoc in favor of a Ruby > 2.3 built in ([#7584]({{ site.repository }}/issues/7584))
+- Incorporate `relative_url` within `post_url` tag ([#7589]({{ site.repository }}/issues/7589))
+- Remove patch to modify config for kramdown ([#7699]({{ site.repository }}/issues/7699))
+
+### Minor Enhancements
+{: #minor-enhancements-v4-0-0}
+
+- Enhance `--blank` scaffolding ([#7310]({{ site.repository }}/issues/7310))
+- Use `jekyll-compose` if installed ([#6932]({{ site.repository }}/issues/6932))
+- Disable Liquid via front matter ([#6824]({{ site.repository }}/issues/6824))
+- Configure cache_dir ([#7232]({{ site.repository }}/issues/7232))
+- ISO week date drops ([#5981]({{ site.repository }}/issues/5981))
+- Fix custom 404 page for GitHub pages ([#7132]({{ site.repository }}/issues/7132))
+- Load config file from within current theme-gem ([#7304]({{ site.repository }}/issues/7304))
+- Suggest re-running command with `--trace` on fail ([#6551]({{ site.repository }}/issues/6551))
+- Support for binary operators in where_exp filter ([#6998]({{ site.repository }}/issues/6998))
+- Automatically load `_config.toml` ([#7299]({{ site.repository }}/issues/7299))
+- Add vendor folder to a newly installed site's .gitignore ([#6968]({{ site.repository }}/issues/6968))
+- Output Jekyll Version while debugging ([#7173]({{ site.repository }}/issues/7173))
+- Memoize computing excerpt's relative_path ([#6951]({{ site.repository }}/issues/6951))
+- Skip processing posts that can not be read ([#7302]({{ site.repository }}/issues/7302))
+- Memoize the return value of Site#documents ([#7273]({{ site.repository }}/issues/7273))
+- Cache globbed paths in front matter defaults ([#7345]({{ site.repository }}/issues/7345))
+- Cache computed item property ([#7301]({{ site.repository }}/issues/7301))
+- Cleanup Markdown converter ([#7519]({{ site.repository }}/issues/7519))
+- Do not process Liquid in post excerpt when disabled in front matter ([#7146]({{ site.repository }}/issues/7146))
+- Liquefied link tag ([#6269]({{ site.repository }}/issues/6269))
+- Update item_property to return numbers as numbers instead of strings ([#6608]({{ site.repository }}/issues/6608))
+- Use `.markdown` extension for page templates ([#7126]({{ site.repository }}/issues/7126))
+- Add support for `*.xhtml` files ([#6854]({{ site.repository }}/issues/6854))
+- Allow i18n v0.9.5 and higher ([#7044]({{ site.repository }}/issues/7044))
+- Ignore permission error of /proc/version ([#7267]({{ site.repository }}/issues/7267))
+- Strip extra slashes via `Jekyll.sanitized_path` ([#7182]({{ site.repository }}/issues/7182))
+- Site template: remove default config for markdown ([#7285]({{ site.repository }}/issues/7285))
+- Add a custom inspect string for StaticFile objects ([#7422]({{ site.repository }}/issues/7422))
+- Remind user to include gem in the Gemfile on error ([#7476]({{ site.repository }}/issues/7476))
+- Search Front matter defaults for Page objects with relative_path ([#7261]({{ site.repository }}/issues/7261))
+- Lock use of `tzinfo` gem to v1.x ([#7521]({{ site.repository }}/issues/7521), [#7562]({{ site.repository }}/issues/7562))
+- Utilize absolute paths of user-provided file paths ([#7450]({{ site.repository }}/issues/7450))
+- Detect `nil` and empty values in objects with `where` filter ([#7580]({{ site.repository }}/issues/7580))
+- Initialize mutations for Drops only if necessary ([#7657]({{ site.repository }}/issues/7657))
+- Reduce Array allocations via Jekyll::Cleaner ([#7659]({{ site.repository }}/issues/7659))
+- Encode and unencode urls only as required ([#7654]({{ site.repository }}/issues/7654))
+- Reduce string allocations with better alternatives ([#7643]({{ site.repository }}/issues/7643))
+- Reduce allocations from Jekyll::Document instances ([#7625]({{ site.repository }}/issues/7625))
+- Add `type` attribute to Document instances ([#7406]({{ site.repository }}/issues/7406))
+- Reduce allocations from where-filter ([#7653]({{ site.repository }}/issues/7653))
+- Memoize SiteDrop#documents to reduce allocations ([#7697]({{ site.repository }}/issues/7697))
+- Add PathManager class to cache interim paths ([#7732]({{ site.repository }}/issues/7732))
+- Remove warnings and fixes for deprecated config ([#7440]({{ site.repository }}/issues/7440))
+- Delegate --profile tabulation to `terminal-table` ([#7627]({{ site.repository }}/issues/7627))
+
+### Bug Fixes
+{: #bug-fixes-v4-0-0}
+
+- Security: fix `include` bypass of `EntryFilter#filter` symlink check ([#7226]({{ site.repository }}/issues/7226))
+- Theme gems: ensure directories aren't symlinks ([#7419]({{ site.repository }}/issues/7419))
+- Add call to unused method `validate_options` in `commands/serve.rb` ([#7122]({{ site.repository }}/issues/7122))
+- Check if scope applies to type before given path ([#7263]({{ site.repository }}/issues/7263))
+- Document two methods, simplify one of the methods ([#7270]({{ site.repository }}/issues/7270))
+- Check key in collections only if it isn't "posts" ([#7277]({{ site.repository }}/issues/7277))
+- Interpolate Jekyll::Page subclass on inspection ([#7203]({{ site.repository }}/issues/7203))
+- Measure the no. of times a template gets rendered ([#7316]({{ site.repository }}/issues/7316))
+- Reduce array traversal in Jekyll::Reader ([#7157]({{ site.repository }}/issues/7157))
+- Re-implement handling Liquid blocks in excerpts ([#7250]({{ site.repository }}/issues/7250))
+- Documents should be able to render their date ([#7404]({{ site.repository }}/issues/7404))
+- Fix Interpreter warning from Jekyll::Renderer ([#7448]({{ site.repository }}/issues/7448))
+- Loggers should accept both numbers and symbols ([#6967]({{ site.repository }}/issues/6967))
+- Replace regex arg to :gsub with a string arg ([#7189]({{ site.repository }}/issues/7189))
+- Dont write static files from unrendered collection ([#7410]({{ site.repository }}/issues/7410))
+- Excerpt handling of custom and intermediate tags ([#7382]({{ site.repository }}/issues/7382))
+- Change future post loglevel to warn to help user narrow down issues ([#7527]({{ site.repository }}/issues/7527))
+- Handle files with trailing dots in their basename ([#7315]({{ site.repository }}/issues/7315))
+- Fix unnecessary allocations via StaticFileReader ([#7572]({{ site.repository }}/issues/7572))
+- Don't check if site URL is absolute if it is nil ([#7498]({{ site.repository }}/issues/7498))
+- Avoid unnecessary duplication of pages array ([#7272]({{ site.repository }}/issues/7272))
+- Memoize Site#post_attr_hash ([#7276]({{ site.repository }}/issues/7276))
+- Memoize Document#excerpt_separator ([#7569]({{ site.repository }}/issues/7569))
+- Optimize Document::DATE_FILENAME_MATCHER to match valid filenames ([#7292]({{ site.repository }}/issues/7292))
+- Escape valid special chars in a site's path name ([#7568]({{ site.repository }}/issues/7568))
+- Replace `name` in Page#inspect with relative_path ([#7434]({{ site.repository }}/issues/7434))
+- Log a warning when the slug is empty ([#7357]({{ site.repository }}/issues/7357))
+- Push Markdown link refs to excerpt only as required ([#7577]({{ site.repository }}/issues/7577))
+- Fix broken include_relative usage in excerpt ([#7633]({{ site.repository }}/issues/7633))
+- Initialize and reset glob_cache only as necessary ([#7658]({{ site.repository }}/issues/7658))
+- Revert memoizing Site#docs_to_write and #documents ([#7684]({{ site.repository }}/issues/7684))
+- Backport [#7684]({{ site.repository }}/issues/7684) for v3.8.x: Revert memoizing Site#docs_to_write and refactor #documents ([#7689]({{ site.repository }}/issues/7689))
+- Backport [#7213]({{ site.repository }}/issues/7213) and [#7633]({{ site.repository }}/issues/7633) for v3.8.x: Fix broken include_relative usage in excerpt ([#7690]({{ site.repository }}/issues/7690))
+- Don't read symlinks in site.include in safe mode ([#7711]({{ site.repository }}/issues/7711))
+- Replace `String#=~` with `String#match?` ([#7723]({{ site.repository }}/issues/7723))
+- Update log output for an invalid theme directory ([#7679]({{ site.repository }}/issues/7679))
+- Remove configuration of theme sass files from Core ([#7290]({{ site.repository }}/issues/7290))
+- Actually conditionally include liquid-c ([#7792]({{ site.repository }}/issues/7792))
+- Test number_like regex on stringified property ([#7788]({{ site.repository }}/issues/7788))
+
+### Development Fixes
+{: #development-fixes-v4-0-0}
+
+- Upgrade liquid-c to v4.0 ([#7375]({{ site.repository }}/issues/7375))
+- Bump RuboCop to v0.71.0 ([#7687]({{ site.repository }}/issues/7687))
+- Target Ruby 2.4 syntax ([#7583]({{ site.repository }}/issues/7583))
+- Fix: RuboCop offenses ([#7769]({{ site.repository }}/issues/7769))
+- Use communicative method parameters ([#7566]({{ site.repository }}/issues/7566))
+- Scan `assert_equal` methods and rectify any offenses with a custom RuboCop cop ([#7130]({{ site.repository }}/issues/7130))
+- CI: Test with Ruby 2.6 ([#7438]({{ site.repository }}/issues/7438))
+- CI: Test with Ruby 2.6 on AppVeyor ([#7518]({{ site.repository }}/issues/7518))
+- CI: Update RuboCop config ([#7050]({{ site.repository }}/issues/7050))
+- CI: Add a script to profile docs ([#7540]({{ site.repository }}/issues/7540))
+- CI(Appveyor): shallow clone with 5 last commits ([#7312]({{ site.repository }}/issues/7312))
+- CI: Test with oldest and latest Ruby only ([#7412]({{ site.repository }}/issues/7412))
+- CI: Update excludes for CodeClimate Analyses ([#7365]({{ site.repository }}/issues/7365))
+- CI: Lock Travis to Bundler-1.16.2 ([#7144]({{ site.repository }}/issues/7144))
+- CI: Bump tested version of JRuby to 9.2.7.0 ([#7612]({{ site.repository }}/issues/7612))
+- CI: Do not install docs on updating gems on Travis ([#7706]({{ site.repository }}/issues/7706))
+- Update gemspec ([#7425]({{ site.repository }}/issues/7425))
+- deps: relax version constraint on classifier-reborn gem ([#7471]({{ site.repository }}/issues/7471))
+- deps: update yajl-ruby ([#7278]({{ site.repository }}/issues/7278))
+- deps: bump yajl-ruby to v1.4.0 ([#6976]({{ site.repository }}/issues/6976))
+- Create symlink only if target is accessible ([#7429]({{ site.repository }}/issues/7429))
+- Switch to `:install_if` for wdm gem ([#7372]({{ site.repository }}/issues/7372))
+- Add cucumber feature to test include_relative tag ([#7213]({{ site.repository }}/issues/7213))
+- Small benchmark refactoring ([#7211]({{ site.repository }}/issues/7211))
+- Fix incorrectly passed arguments to assert_equal ([#7134]({{ site.repository }}/issues/7134))
+- fix up refute_equal call ([#7133]({{ site.repository }}/issues/7133))
+- Fix RuboCop offences in test files ([#7128]({{ site.repository }}/issues/7128))
+- Use assert_include ([#7093]({{ site.repository }}/issues/7093))
+- Remember to release docs gem ([#7066]({{ site.repository }}/issues/7066))
+- Useless privates removed ([#6768]({{ site.repository }}/issues/6768))
+- Load Rouge for TestKramdown ([#7007]({{ site.repository }}/issues/7007))
+- Update instructions for releasing docs Gem ([#6975]({{ site.repository }}/issues/6975))
+- We are not using Ruby 2.2 anymore ([#6977]({{ site.repository }}/issues/6977))
+- Remove unnecessary Jekyll::Page constant ([#6770]({{ site.repository }}/issues/6770))
+- Remove unused error class ([#6511]({{ site.repository }}/issues/6511))
+- Add a Cucumber feature for post_url tag ([#7586]({{ site.repository }}/issues/7586))
+- Generate a "TOTAL" row for build-profile table ([#7614]({{ site.repository }}/issues/7614))
+- Refactor Jekyll::Cache ([#7532]({{ site.repository }}/issues/7532))
+- Store list of expected extnames in a constant ([#7638]({{ site.repository }}/issues/7638))
+- Profile allocations from a build session ([#7646]({{ site.repository }}/issues/7646))
+- Update small typo in contributing.md ([#7671]({{ site.repository }}/issues/7671))
+- Remove override to Jekyll::Document#respond_to? ([#7695]({{ site.repository }}/issues/7695))
+- Update TestTags in sync with Rouge v3.4 ([#7709]({{ site.repository }}/issues/7709))
+- Use regexp to filter special entries ([#7702]({{ site.repository }}/issues/7702))
+- Reduce Array objects generated from utility method ([#7749]({{ site.repository }}/issues/7749))
+- Update mime.types ([#7756]({{ site.repository }}/issues/7756))
+- Replace redundant Array#map with Array#each ([#7761]({{ site.repository }}/issues/7761))
+- Reduce allocations by using #each_with_object ([#7758]({{ site.repository }}/issues/7758))
+- Memoize fallback_data for Drop ([#7728]({{ site.repository }}/issues/7728))
+- Use String#end_with? to check if entry is a backup ([#7701]({{ site.repository }}/issues/7701))
+
+### Documentation
+
+- Refactor docs ([#7205]({{ site.repository }}/issues/7205))
+- Add a link to Giraffe Academy's tutorial ([#7325]({{ site.repository }}/issues/7325))
+- Do not advise users to install Jekyll outside of Bundler ([#6927]({{ site.repository }}/issues/6927))
+- Remove documentation for using Redcarpet ([#6990]({{ site.repository }}/issues/6990))
+- Install Docs that Work on MacOS 10.14 ([#7561]({{ site.repository }}/issues/7561))
+- Add Installation Instructions for Ubuntu ([#6925]({{ site.repository }}/issues/6925))
+- Don't prompt for sudo when installing with Ubuntu WSL ([#6781]({{ site.repository }}/issues/6781))
+- Installation instructions for Fedora ([#7198]({{ site.repository }}/issues/7198))
+- Update Windows install docs ([#6926]({{ site.repository }}/issues/6926))
+- List all standard liquid filters ([#7333]({{ site.repository }}/issues/7333))
+- List all static files variables ([#7002]({{ site.repository }}/issues/7002))
+- Improve how to include Rouge stylesheets ([#7752]({{ site.repository }}/issues/7752))
+- Mention CommonMark plugins ([#7418]({{ site.repository }}/issues/7418))
+- Add TSV to list of supported _data files. ([#7168]({{ site.repository }}/issues/7168))
+- How to deploy using pre-push git hook ([#7179]({{ site.repository }}/issues/7179))
+- Hosting with AWS Amplify ([#7510]({{ site.repository }}/issues/7510))
+- CircleCI deployment through CircleCI v2 ([#7024]({{ site.repository }}/issues/7024))
+- GitHub Pages: use themes from other repos ([#7112]({{ site.repository }}/issues/7112))
+- Document page.dir and page.name ([#7373]({{ site.repository }}/issues/7373))
+- Document custom tag blocks ([#7359]({{ site.repository }}/issues/7359))
+- Document converter methods ([#7289]({{ site.repository }}/issues/7289))
+- Document {% raw %}`{{ page.collection }}`{% endraw %} ([#7430]({{ site.repository }}/issues/7430))
+- Document Jekyll Filters with YAML data ([#7335]({{ site.repository }}/issues/7335))
+- Document where Jekyll looks for layouts in a site ([#7564]({{ site.repository }}/issues/7564))
+- plugin: liquid tag jekyll-flickr ([#6946]({{ site.repository }}/issues/6946))
+- plugin: jekyll-target-blank ([#7046]({{ site.repository }}/issues/7046))
+- plugin: json-get. ([#7086]({{ site.repository }}/issues/7086))
+- plugin: `jekyll-info` ([#7091]({{ site.repository }}/issues/7091))
+- plugin: jekyll-xml-source ([#7114]({{ site.repository }}/issues/7114))
+- plugin: jekyll-firstimage filter ([#7127]({{ site.repository }}/issues/7127))
+- plugin: CAT ([#7011]({{ site.repository }}/issues/7011))
+- Resources: Statictastic ([#7593]({{ site.repository }}/issues/7593))
+- Resources: Bonsai Search ([#7543]({{ site.repository }}/issues/7543))
+- Resources: Formspark ([#7601]({{ site.repository }}/issues/7601))
+- Resources: Jekpack([#7598]({{ site.repository }}/issues/7598))
+- Resources: formX ([#7536]({{ site.repository }}/issues/7536))
+- Resources: 99inbound's Jekyll post ([#7348]({{ site.repository }}/issues/7348))
+- Resources: CloudSh ([#7497]({{ site.repository }}/issues/7497))
+- Community:  DEV Community's Jekyll tag ([#7139]({{ site.repository }}/issues/7139))
+- Showcase: developer.spotify.com ([#7217]({{ site.repository }}/issues/7217))
+- Showcase: Isomer ([#7300]({{ site.repository }}/issues/7300))
+- Add version number for group_by_exp doc ([#6956]({{ site.repository }}/issues/6956))
+- Updated nginx configuration for custom-404-page documentation ([#6994]({{ site.repository }}/issues/6994))
+- Clarify definition of 'draft' ([#7037]({{ site.repository }}/issues/7037))
+- _drafts need to be contained within the custom collection directory ([#6985]({{ site.repository }}/issues/6985))
+- Updated to supported version ([#7031]({{ site.repository }}/issues/7031))
+- Add Hints for some Improved Travis Config in Doc ([#7049]({{ site.repository }}/issues/7049))
+- Update travis-ci.md to point out "this is an example Gemfile" ([#7089]({{ site.repository }}/issues/7089))
+- Instructions to view theme’s files under Linux ([#7095]({{ site.repository }}/issues/7095))
+- Use a real theme in the example ([#7125]({{ site.repository }}/issues/7125))
+- Update docs about post creation ([#7138]({{ site.repository }}/issues/7138))
+- Initialize upgrading doc for v4.0 ([#7140]({{ site.repository }}/issues/7140))
+- Add version badge for date filters with ordinal ([#7162]({{ site.repository }}/issues/7162))
+- Corrected sample usage of postfiles ([#7181]({{ site.repository }}/issues/7181))
+- Resolve "Unable to locate package ruby2.4" error ([#7196]({{ site.repository }}/issues/7196))
+- Correct stylesheet url in tutorial step 7 ([#7210]({{ site.repository }}/issues/7210))
+- Removes quotes from markdown for assets ([#7223]({{ site.repository }}/issues/7223))
+- Clarified front matter requirement ([#7234]({{ site.repository }}/issues/7234))
+- Explicit location of where to create blog.html ([#7241]({{ site.repository }}/issues/7241))
+- Reference the build command options that allows multiple config files ([#7266]({{ site.repository }}/issues/7266))
+- Add more issue template(s) and pull request template ([#7269]({{ site.repository }}/issues/7269))
+- Suggest sites use OpenSSL instead of GnuTLS for their site's CI ([#7010]({{ site.repository }}/issues/7010))
+- Fix broken Contributors link in README.markdown ([#7200]({{ site.repository }}/issues/7200))
+- Add title tag to item in RSS template ([#7282]({{ site.repository }}/issues/7282))
+- Add link tag to item in RSS template ([#7291]({{ site.repository }}/issues/7291))
+- Remove redundant instruction comment ([#7342]({{ site.repository }}/issues/7342))
+- Textile is only supported through a converter plugin ([#7003]({{ site.repository }}/issues/7003))
+- Add recursive navigation tutorial ([#7720]({{ site.repository }}/issues/7720))
+- Remove installation instructions with Homebrew ([#7381]({{ site.repository }}/issues/7381))
+- Fix dead link and misleading prose ([#7383]({{ site.repository }}/issues/7383))
+- Fix content management section ([#7385]({{ site.repository }}/issues/7385))
+- Apply ruby official guide documents ([#7393]({{ site.repository }}/issues/7393))
+- Fix group_by_exp filter example ([#7394]({{ site.repository }}/issues/7394))
+- Remove alt attribute from a tags ([#7407]({{ site.repository }}/issues/7407))
+- Fix BASH code-block in ubuntu.md ([#7420]({{ site.repository }}/issues/7420))
+- zlib is missing ([#7428]({{ site.repository }}/issues/7428))
+- Fixed unnecessary aticles and pronouns ([#7466]({{ site.repository }}/issues/7466))
+- Store SSL key and cert in site source ([#7473]({{ site.repository }}/issues/7473))
+- Fix typo in tutorial for converting existing site ([#7524]({{ site.repository }}/issues/7524))
+- Check if var exists before include tag ([#7530]({{ site.repository }}/issues/7530))
+- Clarify docs on collections regarding the need for front matter ([#7538]({{ site.repository }}/issues/7538))
+- Fix incorrect Windows path in themes.md ([#7525]({{ site.repository }}/issues/7525))
+- Addresses bundle not found. ([#7351]({{ site.repository }}/issues/7351))
+- Update the contribution docs for draft pull requests ([#7619]({{ site.repository }}/issues/7619))
+- Data file section adds TSV ([#7640]({{ site.repository }}/issues/7640))
+- Indicate where the _sass folder is by default ([#7644]({{ site.repository }}/issues/7644))
+- Docs: add version tags to new placeholders ([#5981]({{ site.repository }}/issues/5981)) for permalinks ([#7647]({{ site.repository }}/issues/7647))
+- Solve "GitHub Page build failure" in 10-deployment.md ([#7648]({{ site.repository }}/issues/7648))
+- fix link to Site Source config ([#7708]({{ site.repository }}/issues/7708))
+- Introduce frontmatter in step 2 ([#7704]({{ site.repository }}/issues/7704))
+- Add @ashmaroli to Core Team listing ([#7398]({{ site.repository }}/issues/7398))
+- Lnk to Tidelift in site's footer ([#7377]({{ site.repository }}/issues/7377))
+- Link to OpenCollective backing ([#7378]({{ site.repository }}/issues/7378)
+- Link to sponsor listing in README ([#7405]({{ site.repository }}/issues/7405))
+- Adjust team page listings ([#7395]({{ site.repository }}/issues/7395))
+- Updates to CODE OF CONDUCT (v1.4.0) ([#7105]({{ site.repository }}/issues/7105))
+- More inclusive writing ([#7283]({{ site.repository }}/issues/7283))
+- Update Ruby version used in Travis-CI example ([#7783]({{ site.repository }}/issues/7783))
+- Documentation for binary operators in where_exp ([#7786]({{ site.repository }}/issues/7786))
+- Adding SmartForms as Forms service ([#7794]({{ site.repository }}/issues/7794))
+
+### Site Enhancements
+{: #site-enhancements-v4-0-0}
+
+- Better Performance ([#7388]({{ site.repository }}/issues/7388))
+- Add some minor improvements to image loading in Showcase page ([#7214]({{ site.repository }}/issues/7214))
+- Simplify assigning classname to docs' aside-links ([#7609]({{ site.repository }}/issues/7609))
+- Simplify couple of includes in the docs site ([#7607]({{ site.repository }}/issues/7607))
+- Avoid generating empty classnames ([#7610]({{ site.repository }}/issues/7610))
+- Minimize rendering count ([#7343]({{ site.repository }}/issues/7343))
+
+### Release
+
+- Release post for v4.0.0 beta1 ([#7716]({{ site.repository }}/issues/7716))
+- Release post for v4.0.0.pre.alpha1 ([#7574]({{ site.repository }}/issues/7574))
+- Release post for v3.8.0 ([#6849]({{ site.repository }}/issues/6849))
+- Release post for v3.6.3, v3.7.4 and v3.8.4 ([#7259]({{ site.repository }}/issues/7259))
+- Post: v4.0 development ([#6934]({{ site.repository }}/issues/6934))
+
+
 ## 3.8.6 / 2019-07-02
 {: #v3-8-6}
 

docs/_posts/2019-08-19-jekyll-4-0-0-released.markdown

@@ -0,0 +1,139 @@
+---
+title: 'Jekyll 4.0.0 Released'
+date: 2019-08-20 10:00:00 -0500
+author: mattr-
+version: 4.0.0
+category: release
+---
+
+Hi! 👋 I bring some good news! Jekyll 4.0.0 is finally here! 🎉
+
+There's quite a bit in this release to unpack, so let me hit the high points quickly:
+ - Ruby 2.4.0 or greater is now required.
+ - Rouge 3.0 or greater is now required for syntax highlighting.
+ - Jekyll builds should be much faster.
+ - Kramdown 2.1 is now the default markdown engine.
+ - Sass processing should be faster.
+ - We dropped support for a lot of stuff, specifically:
+   - Pygments
+   - RedCarpet
+   - RDiscount
+
+
+Alright, so with the high points out of the way, let's get into the details a little bit.
+
+### Cache all the things! 💰
+
+While some optimizations first made an appearance with Jekyll 3.8.0, Jekyll 4.0 takes
+it to another level altogether.
+
+Jekyll 4.0 caches the processing done by Liquid in memory. So every Liquid
+template is processed only as required. If you have 10 pages depending on a
+single layout, the layout is cached and that data is then rendered as per the
+10 different contexts of the individual files.
+
+There's also a disk cache! Jekyll can now cache data to disk to avoid repeated
+processing of content that doesn't change between build sessions. Currently,
+this is limited to markdown. So while the very first build will take a certain
+amount of time, consequent builds for content that hasn't changed will take
+much less time due to the disk-cache. Disk caching is disabled for `safe` mode,
+however. 
+
+### Super-powered content transformations 💪
+
+We've upgraded Sass support so it should be faster and support. There's also
+support for sourcemaps now! Under the hood, our Sass support uses the `SassC`
+library now, which is supported directly by the Sass team, which should mean
+better support for everybody in the long run.
+
+Kramdown is updated to version 2.1. This also brings with it a bunch of changes
+to the Kramdown configuration, as the Kramdown team have extracted a fair
+number of features into separate gems. Support for GitHub Flavored Markdown is
+enabled by default, but if you're using another Kramdown extension in your
+site, you'll likely need to update your plugin configuration. See the [upgrade
+guide](/docs/upgrading/3-to-4/) for more details.
+
+The `link` and `post_url` tags no longer need `site.baseurl` prepended every
+time they're used. Those tags now use our `relative_url` filter to take care of
+this for you. Existing uses of the prepending pattern will break though!
+Sorry! :sweat_smile: 
+
+A few other smaller features when it comes to content:
+ - The `link` tag understands Liquid variables in the same fashion our
+ `include` tag does now.
+ - Disable Liquid processing for a particular page / document by adding
+ `render_with_liquid: false` to it's front matter.
+ - Liquid's binary `and` and `or` operations can be used in the `where_exp`
+ filter for more powerful filtering
+
+There's some goodies for theme community as well. Developers may now bundle a
+`config.yml` into their theme-gem to provide some boilerplate configurations for
+the theme. Like other resources in the theme, these configuration values can also
+be customized at the user's end.
+
+
+Check out the [full history](/docs/history/#v4-0-0) and the various pull requests
+for more details on all the enhancements and bug-fixes.
+
+### Upgrading 📈
+
+First, read the [upgrade guide](/docs/upgrading/3-to-4/)!
+
+Next, Edit your project's `Gemfile` to test Jekyll v4.x:
+
+```ruby
+gem "jekyll", "~> 4.0"
+```
+
+Then run `bundle update` to update all dependencies. Unless you're using
+third-party plugins that haven't yet added support for Jekyll 4.0, you should be
+good to go.
+
+Plugins and themes authors must relax the jekyll dependency in their `gemspec` file
+to allow for Jekyll v4.0:
+
+`spec.add_runtime_dependency "jekyll", ">= 3.6", "< 5.0"`
+
+If your favorite plugin hasn't relaxed that dependency yet, please gently
+encourage them to do so. :slightly_smiling_face:
+
+### Have questions❓
+
+Please reach out on our [community forum](https://talk.jekyllrb.com)
+
+
+### Thank you!! 🙇
+
+Jekyll would not be possible without the many people who have taken the time to write issues, submit pull requests, create themes, answer questions for other users, or make their own sites using our project. Thanks to all of you who contribute, no matter how small you think your contribution might have been.
+
+In addition, special thanks to the 139 contributors who made this
+release possible via a pull request submission (in alphabetical order): Aidan
+Fitzgerald, Akshat Kedia, Ale Muñoz, Alex Wood,
+Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez,
+Ananthakumar, Andreas Möller, Andrew Lyndem, Andrew Marcuse, Andy Alt, Anne
+Gentle, Anny, Anuj Bhatnagar, argv-minus-one, Arjun Thakur, Arthur Attwell,
+Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed,
+Bjorn Krols, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Chris
+Oliver, chrisfinazzo, Christian Oliff, Christoph Päper, Damien Solodow, Dan
+Allen, Dan Friedman, Daniel Höpfl, David J. Malan, David Kennell, David Zhang,
+Denis McDonald, Derek Smart, Derpy, Dusty Candland, Edgar Tinajero, Elvio
+Vicosa, ExE Boss, Fons van der Plas, Frank Taillandier, Gareth Cooper, Grzegorz
+Kaczorek, Haris Bjelic, Hodong Kim, ikeji, Isaac Goodman, Jacob Byers, Jakob
+Krigovsky, James Rhea, Jan Pobořil, jess, jingze_lu, Joe Shannon, Jordan Morgan,
+Jörg Steinsträter, Jorie Tappa, Josue Caraballo, jpasholk, Justin Vallelonga,
+Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, krissy,
+Kyle Barbour, Lars Kanis, Leandro Facchinetti, Liam Rosenfeld, Luis Enrique
+Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, makmm, Manu Mathew, Mario,
+Martin Scharm, Matt Kraai, Matt Massicotte, Matt Rogers, Matthew Rathbone,
+Maxwell Gerber, Mertcan Yücel, Michael Bishop, Michael Hiiva, Michelle Greer,
+Mike Kasberg, Mike Neumegen, mo khan, Monica Powell, Nicolas Hoizey, Nikhil
+Benesch, Nikhil Swaminathan, Nikita Skalkin, Niklas Eicker, ninevra, Olivia
+Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, penguinpet,
+Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes,
+Sadik Kuzu, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer,
+Stephen Weiss, Steven Westmoreland, strangehill, Sundaram Kalyan Vedala, Thanos
+Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev,
+Vinicius Flores, Vitor Oliveira, Wouter Schoot, XhmikosR, Yi Feng Xie, Zhang
+Xiangze, 김정환, 104fps.
+
+Happy Jekylling everyone!

docs/latest_version.txt

@@ -1 +1 @@
-3.8.6
+4.0.0

lib/jekyll/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jekyll
-  VERSION = "4.0.0.pre.beta1"
+  VERSION = "4.0.0"
 end