Finalize descriptions and annotations

zverok · zverok · commit 24eca1121aba · 2022-07-09T19:19:52.000+03:00
diff --git a/2.4.md b/2.4.md
@@ -1,6 +1,7 @@
 ---
 title: Ruby 2.4 changes
 prev: 2.5
+description: Ruby 2.4 full and annotated changelog
 ---
 
 # Ruby 2.4
@@ -15,9 +16,9 @@ prev: 2.5
  -->
 
 * **Released at:** Dec 25, 2016 (<a class="github" href="https://github.com/ruby/ruby/blob/trunk/doc/NEWS-2.4.0">NEWS</a> file)
-* **Status (as of Feb 16, 2022):** EOL, latest is 2.4.10
+* **Status (as of Jul 09, 2022):** EOL, latest is 2.4.10
 * **This document first published:** Oct 14, 2019
-* **Last change to this document:** Feb 16, 2022
+* **Last change to this document:** Jul 09, 2022
 
 ## Highlights[](#highlights)
 
diff --git a/2.5.md b/2.5.md
@@ -1,6 +1,7 @@
 ---
 title: Ruby 2.5 changes
 prev: 2.6
+description: Ruby 2.5 full and annotated changelog
 ---
 
 # Ruby 2.5
diff --git a/2.6.md b/2.6.md
@@ -2,12 +2,13 @@
 title: Ruby 2.6 changes
 prev: 2.7
 next: 2.5
+description: Ruby 2.6 full and annotated changelog
 ---
 
 # Ruby 2.6
 
 * **Released at:** Dec 25, 2018 (<a class="github" href="https://github.com/ruby/ruby/blob/ruby_2_6/NEWS">NEWS</a> file)
-* **Status (as of Jul 09, 2022):** Security maintenance, latest is 2.6.9
+* **Status (as of Jul 09, 2022):** EOL, latest is 2.6.10
 * **This document first published:** Dec 29, 2018
 * **Last change to this document:** Jul 09, 2022
 
diff --git a/2.7.md b/2.7.md
@@ -2,14 +2,15 @@
 title: Ruby 2.7 changes
 prev: 3.0
 next: 2.6
+description: Ruby 2.7 full and annotated changelog
 ---
 
 # Ruby 2.7
 
 * **Released at:** Dec 25, 2019 (<a class="github" href="https://github.com/ruby/ruby/blob/ruby_2_7/NEWS">NEWS</a> file)
-* **Status (as of Feb 16, 2022):** 2.7.5 is current _stable_
+* **Status (as of Jul 09, 2022):** 2.7.6 is current _stable_
 * **This document first published:** Dec 27, 2019
-* **Last change to this document:** Feb 16, 2022
+* **Last change to this document:** Jul 09, 2022
 
 <!-- TODO: all links to docs should be replaced with /2.7.0/ suffix instead of /master/ when 2.7.0 would be published -->
 
@@ -72,7 +73,7 @@ In block without explicitly specified parameters, variables `_1` through `_9` ca
   * <a class="tracker feature" href="https://bugs.ruby-lang.org/issues/4475">Feature #4475</a> (initial discussion, started 9 years ago, and finished with accepting of `@0`—`@9`),
   * <a class="tracker misc" href="https://bugs.ruby-lang.org/issues/15723">Misc #15723</a> (change to `_0`—`_9`),
   * <a class="tracker bug" href="https://bugs.ruby-lang.org/issues/16178">Bug #16178</a> (dropping of `_0`, and changing semantics of `_1`)
-* **Documentation:** [Proc#Numbered parameters](https://docs.rubocop.org/en/stable/cops_layout/)
+* **Documentation:** <a class="ruby-doc" href="https://docs.ruby-lang.org/en/2.7.0/Proc.html#class-Proc-label-Numbered+parameters">Proc#Numbered parameters</a>
 * **Code:**
   ```ruby
   # Simplest usage:
@@ -1041,7 +1042,7 @@ Allows to emit/suppress separate categories of warnings.
 
 ## Standard library[](#standard-library)
 
-* `Date` supports [new Japanese era](https://en.wikipedia.org/wiki/Reiwa) in parsing and rendering dates (generic <a class="ruby-doc" href="https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/Date.html#method-c-parse"><code>Date.parse</code></a> and <a class="ruby-doc" href="https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/Date.html#method-i-jisx0301"><code>.jisx0301](https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/Date.html#method-c-jisx0301)/[#jisx0301</code></a>). Discussion: <a class="tracker feature" href="https://bugs.ruby-lang.org/issues/15742">Feature #15742</a>
+* `Date` supports [new Japanese era](https://en.wikipedia.org/wiki/Reiwa) in parsing and rendering dates (generic <a class="ruby-doc" href="https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/Date.html#method-c-parse"><code>Date.parse</code></a> and <a class="ruby-doc" href="https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/Date.html#method-c-jisx0301"><code>.jisx0301</code></a>/<a class="ruby-doc" href="https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/Date.html#method-i-jisx0301"><code>#jisx0301</code></a>). Discussion: <a class="tracker feature" href="https://bugs.ruby-lang.org/issues/15742">Feature #15742</a>
 * <a class="ruby-doc" href="https://docs.ruby-lang.org/en/master/Object.html#method-i-DelegateClass"><code>DelegateClass()</code></a> accepts a block to define delegates behavior on-the-fly.
 * <a class="ruby-doc" href="https://ruby-doc.org/stdlib-2.7.0/libdoc/pathname/rdoc/Pathname.html#method-c-glob"><code>Pathname.glob</code></a> passes third argument, if provided, to `Dir.glob`, allowing to specify `base:` for globbing.
 * <a class="ruby-doc" href="https://ruby-doc.org/stdlib-2.7.0/libdoc/pathname/rdoc/Kernel.html#method-i-Pathname"><code>Pathname()</code></a> method doesn't duplicates argument, if it was already a `Pathname`
diff --git a/3.0.md b/3.0.md
@@ -2,14 +2,15 @@
 title: Ruby 3.0 changes
 prev: /
 next: 2.7
+description: Ruby 3.0 full and annotated changelog
 ---
 
 # Ruby 3.0
 
 * **Released at:** Dec 25, 2020 (<a class="github" href="https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md">NEWS.md</a> file)
-* **Status (as of Jun 19, 2022):** 3.0.3 is current _stable_
+* **Status (as of Jul 09, 2022):** 3.0.4 is current _stable_
 * **This document first published:** Dec 25, 2020
-* **Last change to this document:** Jun 19, 2022
+* **Last change to this document:** Jul 09, 2022
 
 ## Highlights[](#highlights)
 
diff --git a/3.1.md b/3.1.md
@@ -2,14 +2,15 @@
 title: Ruby 3.1 changes
 prev: /
 next: 3.0
+description: Ruby 3.1 full and annotated changelog
 ---
 
 # Ruby 3.1
 
 * **Released at:** Dec 25, 2021 (<a class="github" href="https://github.com/ruby/ruby/blob/ruby_3_1/NEWS.md">NEWS.md</a> file)
-* **Status (as of Jun 19, 2022):** 3.1.0 is current _stable_
+* **Status (as of Jul 09, 2022):** 3.1.2 is current _stable_
 * **This document first published:** Jan 5, 2022
-* **Last change to this document:** Jun 19, 2022
+* **Last change to this document:** Jul 09, 2022
 
 > **Note:** As already explained in [Introduction](README.md), this site is dedicated to changes in the **language**, not the **implementation**, therefore the list below lacks mentions of lots of important optimization introduced in 3.1, including a new JIT named YJIT. That's not because they are not important, just because this site's goals are different.
 
diff --git a/History.md b/History.md
@@ -2,6 +2,10 @@
 
 (Only outstanding content changes listed, the texts and code are constantly updated and fixed thanks to awesome contributors.)
 
+## 2022-06-09
+
+* **[Ruby Evolution](evolution.html)** bird-eye view added.
+
 ## 2022-01-05
 
 * **[3.1](3.1.html)** changelog added. Better late than never, right?..
diff --git a/README.md b/README.md
@@ -27,4 +27,4 @@ The main things to do, currently:
 
 * The source of information is NEWS files from Ruby repository.
 * Book theme is initially borrowed from [mdBook](https://github.com/rust-lang-nursery/mdBook) project.
-* The work in this repository (text, scripts and custom additions to design) is made by [Victor Shepelev](https://zverok.github.io) and should be considered **Public Domain**.
+* The work in this repository (text, scripts and custom additions to design) is made by [Victor Shepelev](https://zverok.space) and should be considered **Public Domain**.
diff --git a/_data/book.yml b/_data/book.yml
@@ -6,8 +6,8 @@ chapters:
   path: "/evolution.html"
   is_version: true
   children:
-  - title: Generic
-    path: "/evolution.html#generic"
+  - title: General changes
+    path: "/evolution.html#general-changes"
   - title: Expressions
     path: "/evolution.html#expressions"
     children:
@@ -86,6 +86,8 @@ chapters:
       path: "/evolution.html#refinements"
     - title: Freezing
       path: "/evolution.html#freezing"
+  - title: 'Appendix: Covered Ruby versions release dates'
+    path: "/evolution.html#appendix-covered-ruby-versions-release-dates"
 - title: Ruby 3.1
   path: "/3.1.html"
   is_version: true
diff --git a/_layouts/default.html b/_layouts/default.html
@@ -9,6 +9,15 @@
     <meta charset="UTF-8">
     <title>{{ page.title }} - {{ site.title }}</title>
     <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="description" content="{{ page.description | escape_once }}" />
+
+    <meta property="og:url" content="{{ page.url | replace:'index.html','' | prepend: site.baseurl | prepend: site.url }}" />
+    <meta property="og:type" content="article" />
+    <meta property="twitter:card" content="summary" />
+    <meta property="og:title" content="{{ page.title | escape_once }}" />
+    <meta property="og:description" content="{{ page.description | escape_once }}" />
+    <meta property="twitter:title" content="{{ page.title | escape_once }}" />
+    <meta property="twitter:description" content="{{ page.description | escape_once }}" />
 
     <!-- CSS stolen from mdBook -->
     <link rel="stylesheet" href="{{ site.baseurl }}/css/book.css">
diff --git a/_src/2.4.md b/_src/2.4.md
@@ -1,6 +1,7 @@
 ---
 title: Ruby 2.4 changes
 prev: 2.5
+description: Ruby 2.4 full and annotated changelog
 ---
 
 # Ruby 2.4
diff --git a/_src/2.5.md b/_src/2.5.md
@@ -1,6 +1,7 @@
 ---
 title: Ruby 2.5 changes
 prev: 2.6
+description: Ruby 2.5 full and annotated changelog
 ---
 
 # Ruby 2.5
diff --git a/_src/2.6.md b/_src/2.6.md
@@ -2,12 +2,13 @@
 title: Ruby 2.6 changes
 prev: 2.7
 next: 2.5
+description: Ruby 2.6 full and annotated changelog
 ---
 
 # Ruby 2.6
 
 * **Released at:** Dec 25, 2018 ([NEWS](https://github.com/ruby/ruby/blob/ruby_2_6/NEWS) file)
-* **Status (as of <<date>>):** Security maintenance, latest is 2.6.9
+* **Status (as of <<date>>):** EOL, latest is 2.6.10
 * **This document first published:** Dec 29, 2018
 * **Last change to this document:** <<date>>
 
diff --git a/_src/2.7.md b/_src/2.7.md
@@ -2,12 +2,13 @@
 title: Ruby 2.7 changes
 prev: 3.0
 next: 2.6
+description: Ruby 2.7 full and annotated changelog
 ---
 
 # Ruby 2.7
 
 * **Released at:** Dec 25, 2019 ([NEWS](https://github.com/ruby/ruby/blob/ruby_2_7/NEWS) file)
-* **Status (as of <<date>>):** 2.7.5 is current _stable_
+* **Status (as of <<date>>):** 2.7.6 is current _stable_
 * **This document first published:** Dec 27, 2019
 * **Last change to this document:** <<date>>
 
diff --git a/_src/3.0.md b/_src/3.0.md
@@ -2,12 +2,13 @@
 title: Ruby 3.0 changes
 prev: /
 next: 2.7
+description: Ruby 3.0 full and annotated changelog
 ---
 
 # Ruby 3.0
 
 * **Released at:** Dec 25, 2020 ([NEWS.md](https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md) file)
-* **Status (as of <<date>>):** 3.0.3 is current _stable_
+* **Status (as of <<date>>):** 3.0.4 is current _stable_
 * **This document first published:** Dec 25, 2020
 * **Last change to this document:** <<date>>
 
diff --git a/_src/3.1.md b/_src/3.1.md
@@ -2,12 +2,13 @@
 title: Ruby 3.1 changes
 prev: /
 next: 3.0
+description: Ruby 3.1 full and annotated changelog
 ---
 
 # Ruby 3.1
 
 * **Released at:** Dec 25, 2021 ([NEWS.md](https://github.com/ruby/ruby/blob/ruby_3_1/NEWS.md) file)
-* **Status (as of <<date>>):** 3.1.0 is current _stable_
+* **Status (as of <<date>>):** 3.1.2 is current _stable_
 * **This document first published:** Jan 5, 2022
 * **Last change to this document:** <<date>>
 
diff --git a/_src/evolution.md b/_src/evolution.md
@@ -2,11 +2,14 @@
 title: Ruby Evolution
 prev: /
 next: 3.1
+description: A very brief list of new significant features that emerged in Ruby programming language since version 2.0 (2013).
 ---
 
 # Ruby Evolution
 
-The text/list below is very brief list of new significant features that emerged in Ruby programming language since version 2.0 (2013). It is intended as a "bird eye view" that might be of interest for Ruby novices and experts alike, as well as for curious users of other technologies.
+**A very brief list of new significant features that emerged in Ruby programming language since version 2.0 (2013).**
+
+It is intended as a "bird eye view" that might be of interest for Ruby novices and experts alike, as well as for curious users of other technologies.
 
 It is part of a bigger [Ruby Changes](/) effort, which provides a detailed explanations and justifications on what happens to the language, version by version. The detailed changelog currently covers versions since 2.4, and the brief changelog links to more detailed explanations for those versions (links are under version numbers at the beginning of the list items).
 
@@ -960,3 +963,18 @@ Freezing of object makes its state immutable. The important thing about freezing
 * [3.0](3.0.md#interpolated-string-literals-are-no-longer-frozen-when--frozen-string-literal-true-is-used) Interpolated String literals are no longer frozen when  [`# frozen-string-literal: true` pragma](https://docs.ruby-lang.org/en/3.0.0/syntax/comments_rdoc.html#label-frozen_string_literal+Directive) is used
 * [3.0](3.0.md#regexp-and-range-objects-are-frozen) `Regexp` and `Range` objects are frozen
 * [3.0](3.0.md#symbolname) [Symbol#name](https://docs.ruby-lang.org/en/3.0.0/Symbol.html#method-i-name) method that returns a frozen string equivalent of the symbol (`Symbol#to_s` returns mutable one, and changing it to be frozen would cause too much incompatibilities)
+
+## Appendix: Covered Ruby versions release dates
+
+* **2.0** — 2013, Feb 24
+* **2.1** — 2013, Dec 25 (the same as every version after this)
+* **2.2** — 2014
+* **2.3** — 2015
+* [2.4](/2.4.html) — 2016
+* [2.5](/2.5.html) — 2017
+* [2.6](/2.6.html) — 2018
+* [2.7](/2.7.html) — 2019
+* [3.0](/3.0.html) — 2020
+* [3.1](/3.1.html) — 2021
+
+
diff --git a/evolution.md b/evolution.md
diff --git a/index.md b/index.md
