Skip to content

Commit 6d714b3

Browse files
committed
Date Facets from 2004 and tell its origin story
Facets took its name in version 0.5.0 on 2004-12-23 (see work/HISTORY-0.rdoc), and the old .index metadata recorded 2004-12-16; 1.0 followed in December 2005. The README, site and LICENSE said 2005. They now say 2004. The news page's archive section gains the short origin story from work/HISTORY-0.rdoc: TomsLib (2002), Succ (2003), A.B.C. and Raspberry (2004), then Ruby Facets (December 2004). The README and the contribute page mention the 2002 roots in a phrase. Also from the #337 review: - docs/build.rb sets UTF-8 as the default external encoding, so it no longer crashes outside a UTF-8 locale. - news.html links the 2.4 release post, which was built but not linked. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E2Njj4j1r9twkVcXsMySLW
1 parent 134cc5c commit 6d714b3

9 files changed

Lines changed: 13 additions & 10 deletions

File tree

‎LICENSE.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
Ruby Facets
2-
Copyright (c) 2005, Thomas Sawyer
2+
Copyright (c) 2004, Thomas Sawyer
33
All rights reserved.
44

55
(BSD-2 LICENSE)

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
**More of Ruby, one method at a time.** Facets is a collection of extensions to Ruby's core classes and standard library, plus a few small, reusable classes and modules. Most methods live in their own files, so you can load one extension, a class's extensions, or the core collection.
77

8-
Facets began in 2005 and is still maintained. The current release is **3.2.2**, which requires **Ruby 3.1 or newer**. See the [release history](HISTORY.md) for changes and migration notes from earlier versions. The `main` branch also contains changes awaiting the next release.
8+
Facets took its name in 2004, growing out of a small methods library started in 2002, and is still maintained. The current release is **3.2.2**, which requires **Ruby 3.1 or newer**. See the [release history](HISTORY.md) for changes and migration notes from earlier versions. The `main` branch also contains changes awaiting the next release.
99

1010
## Install
1111

‎docs/_src/index.erb‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<section class="hero">
22
<div class="shell hero-grid">
33
<div class="hero-copy">
4-
<p class="eyebrow"><span class="eyebrow-line"></span> A Ruby library since 2005</p>
4+
<p class="eyebrow"><span class="eyebrow-line"></span> A Ruby library since 2004</p>
55
<h1>More of Ruby,<br><em>one method</em><br>at a time.</h1>
66
<p class="hero-lede">A thoughtfully collected set of extensions for Ruby's core classes and standard library. Load the whole core collection or pick just the methods you need.</p>
77
<div class="hero-actions">

‎docs/_src/news.erb‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
<section class="page-hero"><div class="shell"><p class="eyebrow"><span class="eyebrow-line"></span> RELEASES & HISTORY</p><h1>A living Ruby<br><em>collection.</em></h1><p>Facets has been growing since 2005. Here are the recent releases and a path back through its story.</p></div></section>
1+
<section class="page-hero"><div class="shell"><p class="eyebrow"><span class="eyebrow-line"></span> RELEASES & HISTORY</p><h1>A living Ruby<br><em>collection.</em></h1><p>Facets has been growing since 2004. Here are the recent releases and a path back through its story.</p></div></section>
22
<section class="section section-light"><div class="shell"><div class="section-heading narrow"><p class="kicker">LATEST RELEASES</p><h2>Facets 3.2</h2><p>The 3.2 series brings the library forward for Ruby 3.1 and newer. Work merged since 3.2.2 is listed under <a href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#unreleased">Unreleased</a> in the release history.</p></div><div class="timeline">
33
<article class="timeline-item" id="facets-3-2-2"><div class="timeline-date"><strong>3.2.2</strong><span>15 JUN 2026</span></div><div><p class="tag">LATEST</p><h3>Compatibility, polished</h3><p>Fixes range intersection on Ruby 3.1 and 3.2, restores <code>Range#overlap?</code> where Ruby does not provide it, and corrects <code>Binding#caller_locations</code> argument handling.</p><a class="text-link" href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#322--2026-06-15">Read changes <span aria-hidden="true">↗</span></a></div></article>
44
<article class="timeline-item" id="facets-3-2-1"><div class="timeline-date"><strong>3.2.1</strong><span>14 JUN 2026</span></div><div><h3>Core loading restored</h3><p>Repairs stale require paths that affected <code>require 'facets'</code> in 3.2.0, and adds a load-path regression check. Also adds OpenDSL and PIC.</p><a class="text-link" href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#321--2026-06-14">Read changes <span aria-hidden="true">↗</span></a></div></article>
55
<article class="timeline-item" id="facets-3-2-0"><div class="timeline-date"><strong>3.2.0</strong><span>APR 2026</span></div><div><h3>Modern Ruby foundation</h3><p>Moves the minimum Ruby version to 3.1, adds methods such as <code>Array#to_ranges</code> and <code>String#dashcase</code>, and retires extensions now built into Ruby.</p><a class="text-link" href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#320--2026-04-01">Read migration notes <span aria-hidden="true">↗</span></a></div></article>
66
</div></div></section>
7-
<section class="section section-cream"><div class="shell archive-grid"><div><p class="kicker">FROM THE ARCHIVE</p><h2>Twenty years<br><em>of ideas.</em></h2><p>These posts are preserved as published. Their install advice and API links describe older Facets releases; use the current guide for 3.x.</p></div><div class="archive-list"><a href="posts/2010-09-01-release-2-9.html"><span>2010</span> Facets 2.9 release <b aria-hidden="true">↗</b></a><a href="posts/2009-11-09-release-2-8.html"><span>2009</span> Facets 2.8 release <b aria-hidden="true">↗</b></a><a href="posts/2009-08-22-release-2-7.html"><span>2009</span> Facets 2.7 release <b aria-hidden="true">↗</b></a><a href="posts/2009-07-21-new-website.html"><span>2009</span> A new website <b aria-hidden="true">↗</b></a><a href="posts/2008-01-01-how-facets-was-born.html"><span>2008</span> How Facets was born <b aria-hidden="true">↗</b></a></div></div></section>
7+
<section class="section section-cream"><div class="shell archive-grid"><div><p class="kicker">FROM THE ARCHIVE</p><h2>Over twenty years<br><em>of ideas.</em></h2><p>Facets grew out of TomsLib, a handful of useful methods started in July 2002. It was renamed Succ (2003), A.B.C. (2004) and Raspberry (2004) before becoming Ruby Facets in December 2004, with 1.0 following a year later.</p><p>These posts are preserved as published. Their install advice and API links describe older Facets releases; use the current guide for 3.x.</p></div><div class="archive-list"><a href="posts/2010-09-01-release-2-9.html"><span>2010</span> Facets 2.9 release <b aria-hidden="true">↗</b></a><a href="posts/2009-11-09-release-2-8.html"><span>2009</span> Facets 2.8 release <b aria-hidden="true">↗</b></a><a href="posts/2009-08-22-release-2-7.html"><span>2009</span> Facets 2.7 release <b aria-hidden="true">↗</b></a><a href="posts/2009-07-21-new-website.html"><span>2009</span> A new website <b aria-hidden="true">↗</b></a><a href="posts/2008-03-24-release-2-4.html"><span>2008</span> Facets 2.4 release <b aria-hidden="true">↗</b></a><a href="posts/2008-01-01-how-facets-was-born.html"><span>2008</span> How Facets was born <b aria-hidden="true">↗</b></a></div></div></section>

‎docs/_src/source.erb‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,4 @@
44
cd facets
55
bundle install
66
bundle exec rake test</code></pre></div></div></section>
7-
<section class="section source-credit"><div class="shell credit-grid"><p class="kicker kicker-light">PEOPLE & LICENSE</p><div><h2>Built together.</h2><p>Thomas Sawyer began Facets in 2005. Many contributors have shaped its methods, tests, and documentation since then. Credits for individual pieces appear in the source, and the collection is distributed under the BSD 2-Clause License.</p><a class="button button-light" href="https://github.com/rubyworks/facets/blob/main/LICENSE.txt">Read the license <span aria-hidden="true">↗</span></a></div></div></section>
7+
<section class="section source-credit"><div class="shell credit-grid"><p class="kicker kicker-light">PEOPLE & LICENSE</p><div><h2>Built together.</h2><p>Thomas Sawyer began Facets in 2004, building on a methods library he started in 2002. Many contributors have shaped its methods, tests, and documentation since then. Credits for individual pieces appear in the source, and the collection is distributed under the BSD 2-Clause License.</p><a class="button button-light" href="https://github.com/rubyworks/facets/blob/main/LICENSE.txt">Read the license <span aria-hidden="true">↗</span></a></div></div></section>

‎docs/build.rb‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,9 @@
55
# in _src. Run from anywhere with: ruby docs/build.rb
66
require 'erb'
77

8+
# The templates contain non-ASCII characters; don't depend on the locale.
9+
Encoding.default_external = Encoding::UTF_8
10+
811
site_dir = __dir__
912
source_dir = File.join(site_dir, '_src')
1013
layout = ERB.new(File.read(File.join(source_dir, 'layout.erb')), trim_mode: '-')

‎docs/index.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
<main id="main"><section class="hero">
2929
<div class="shell hero-grid">
3030
<div class="hero-copy">
31-
<p class="eyebrow"><span class="eyebrow-line"></span> A Ruby library since 2005</p>
31+
<p class="eyebrow"><span class="eyebrow-line"></span> A Ruby library since 2004</p>
3232
<h1>More of Ruby,<br><em>one method</em><br>at a time.</h1>
3333
<p class="hero-lede">A thoughtfully collected set of extensions for Ruby's core classes and standard library. Load the whole core collection or pick just the methods you need.</p>
3434
<div class="hero-actions">

‎docs/news.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,13 @@
2525
</div>
2626
</header>
2727

28-
<main id="main"><section class="page-hero"><div class="shell"><p class="eyebrow"><span class="eyebrow-line"></span> RELEASES & HISTORY</p><h1>A living Ruby<br><em>collection.</em></h1><p>Facets has been growing since 2005. Here are the recent releases and a path back through its story.</p></div></section>
28+
<main id="main"><section class="page-hero"><div class="shell"><p class="eyebrow"><span class="eyebrow-line"></span> RELEASES & HISTORY</p><h1>A living Ruby<br><em>collection.</em></h1><p>Facets has been growing since 2004. Here are the recent releases and a path back through its story.</p></div></section>
2929
<section class="section section-light"><div class="shell"><div class="section-heading narrow"><p class="kicker">LATEST RELEASES</p><h2>Facets 3.2</h2><p>The 3.2 series brings the library forward for Ruby 3.1 and newer. Work merged since 3.2.2 is listed under <a href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#unreleased">Unreleased</a> in the release history.</p></div><div class="timeline">
3030
<article class="timeline-item" id="facets-3-2-2"><div class="timeline-date"><strong>3.2.2</strong><span>15 JUN 2026</span></div><div><p class="tag">LATEST</p><h3>Compatibility, polished</h3><p>Fixes range intersection on Ruby 3.1 and 3.2, restores <code>Range#overlap?</code> where Ruby does not provide it, and corrects <code>Binding#caller_locations</code> argument handling.</p><a class="text-link" href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#322--2026-06-15">Read changes <span aria-hidden="true">↗</span></a></div></article>
3131
<article class="timeline-item" id="facets-3-2-1"><div class="timeline-date"><strong>3.2.1</strong><span>14 JUN 2026</span></div><div><h3>Core loading restored</h3><p>Repairs stale require paths that affected <code>require 'facets'</code> in 3.2.0, and adds a load-path regression check. Also adds OpenDSL and PIC.</p><a class="text-link" href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#321--2026-06-14">Read changes <span aria-hidden="true">↗</span></a></div></article>
3232
<article class="timeline-item" id="facets-3-2-0"><div class="timeline-date"><strong>3.2.0</strong><span>APR 2026</span></div><div><h3>Modern Ruby foundation</h3><p>Moves the minimum Ruby version to 3.1, adds methods such as <code>Array#to_ranges</code> and <code>String#dashcase</code>, and retires extensions now built into Ruby.</p><a class="text-link" href="https://github.com/rubyworks/facets/blob/main/HISTORY.md#320--2026-04-01">Read migration notes <span aria-hidden="true">↗</span></a></div></article>
3333
</div></div></section>
34-
<section class="section section-cream"><div class="shell archive-grid"><div><p class="kicker">FROM THE ARCHIVE</p><h2>Twenty years<br><em>of ideas.</em></h2><p>These posts are preserved as published. Their install advice and API links describe older Facets releases; use the current guide for 3.x.</p></div><div class="archive-list"><a href="posts/2010-09-01-release-2-9.html"><span>2010</span> Facets 2.9 release <b aria-hidden="true">↗</b></a><a href="posts/2009-11-09-release-2-8.html"><span>2009</span> Facets 2.8 release <b aria-hidden="true">↗</b></a><a href="posts/2009-08-22-release-2-7.html"><span>2009</span> Facets 2.7 release <b aria-hidden="true">↗</b></a><a href="posts/2009-07-21-new-website.html"><span>2009</span> A new website <b aria-hidden="true">↗</b></a><a href="posts/2008-01-01-how-facets-was-born.html"><span>2008</span> How Facets was born <b aria-hidden="true">↗</b></a></div></div></section>
34+
<section class="section section-cream"><div class="shell archive-grid"><div><p class="kicker">FROM THE ARCHIVE</p><h2>Over twenty years<br><em>of ideas.</em></h2><p>Facets grew out of TomsLib, a handful of useful methods started in July 2002. It was renamed Succ (2003), A.B.C. (2004) and Raspberry (2004) before becoming Ruby Facets in December 2004, with 1.0 following a year later.</p><p>These posts are preserved as published. Their install advice and API links describe older Facets releases; use the current guide for 3.x.</p></div><div class="archive-list"><a href="posts/2010-09-01-release-2-9.html"><span>2010</span> Facets 2.9 release <b aria-hidden="true">↗</b></a><a href="posts/2009-11-09-release-2-8.html"><span>2009</span> Facets 2.8 release <b aria-hidden="true">↗</b></a><a href="posts/2009-08-22-release-2-7.html"><span>2009</span> Facets 2.7 release <b aria-hidden="true">↗</b></a><a href="posts/2009-07-21-new-website.html"><span>2009</span> A new website <b aria-hidden="true">↗</b></a><a href="posts/2008-03-24-release-2-4.html"><span>2008</span> Facets 2.4 release <b aria-hidden="true">↗</b></a><a href="posts/2008-01-01-how-facets-was-born.html"><span>2008</span> How Facets was born <b aria-hidden="true">↗</b></a></div></div></section>
3535
</main>
3636

3737
<footer class="site-footer">

‎docs/source.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@
3131
cd facets
3232
bundle install
3333
bundle exec rake test</code></pre></div></div></section>
34-
<section class="section source-credit"><div class="shell credit-grid"><p class="kicker kicker-light">PEOPLE & LICENSE</p><div><h2>Built together.</h2><p>Thomas Sawyer began Facets in 2005. Many contributors have shaped its methods, tests, and documentation since then. Credits for individual pieces appear in the source, and the collection is distributed under the BSD 2-Clause License.</p><a class="button button-light" href="https://github.com/rubyworks/facets/blob/main/LICENSE.txt">Read the license <span aria-hidden="true">↗</span></a></div></div></section>
34+
<section class="section source-credit"><div class="shell credit-grid"><p class="kicker kicker-light">PEOPLE & LICENSE</p><div><h2>Built together.</h2><p>Thomas Sawyer began Facets in 2004, building on a methods library he started in 2002. Many contributors have shaped its methods, tests, and documentation since then. Credits for individual pieces appear in the source, and the collection is distributed under the BSD 2-Clause License.</p><a class="button button-light" href="https://github.com/rubyworks/facets/blob/main/LICENSE.txt">Read the license <span aria-hidden="true">↗</span></a></div></div></section>
3535
</main>
3636

3737
<footer class="site-footer">

0 commit comments

Comments
 (0)