Skip to content

Date Facets from 2004, tell its origin story, and note 3.2.0's versioning - #338

Merged
trans merged 2 commits into
mainfrom
claude/github-connector-capabilities-4qcre6
Sep 27, 2026
Merged

trans merged 2 commits into
mainfrom
claude/github-connector-capabilities-4qcre6

Conversation

@trans

@trans trans commented Sep 27, 2026 •

Copy link
Copy Markdown
Member

Follow-up to #337.

2004, not 2005

work/HISTORY-0.rdoc records the rename to Ruby Facets in 0.5.0 on 2004-12-23, and the old .index metadata recorded a creation date of 2004-12-16. 1.0.0 followed on 2005-12-04, which is where 2005 came from. These now say 2004:

  • LICENSE.txt: Copyright (c) 2004, Thomas Sawyer
  • README.md: "Facets took its name in 2004, growing out of a small methods library started in 2002"
  • Home page: "A Ruby library since 2004"
  • News page: "growing since 2004"
  • Contribute page: "began Facets in 2004, building on a methods library he started in 2002"

Origin story

The news page's archive section, retitled "Over twenty years of ideas.", gains a short history from work/HISTORY-0.rdoc:

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.

3.2.0 should have been 4.0.0 (922b856)

3.2.0 removed methods and raised the minimum Ruby to 3.1, which under semantic versioning called for a major version. Rather than yanking the 3.2 releases, which would break anyone whose lockfile pins them, HISTORY.md now says so at the top of the 3.2.0 notes:

Note: This release removed methods and raised the minimum Ruby version to 3.1, so it should have been released as 4.0.0. Treat the 3.2 series as a major upgrade from 3.1, and review the Removals below before upgrading.

The next release, which already contains breaking changes, can be 4.0.0.

Fixes from the #337 review

  • docs/build.rb sets Encoding.default_external = Encoding::UTF_8, so the build no longer crashes outside a UTF-8 locale. It now builds with LANG unset.
  • news.html links the 2.4 release post, which was built but not linked from anywhere.

Checks

  • Rebuilt with ruby docs/build.rb. Only index.html, news.html and source.html change, and only in the edited text.
  • All archive links resolve, and no "2005" remains in the README, the license or the pages.
  • The archive section renders cleanly at desktop (1200px) and mobile (390px) widths, with no horizontal overflow.

🤖 Generated with Claude Code

https://claude.ai/code/session_01E2Njj4j1r9twkVcXsMySLW

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
3.2.0 removed methods and raised the minimum Ruby to 3.1, which under
semantic versioning called for 4.0.0. Say so in its release notes, so
anyone upgrading from 3.1 knows to treat the 3.2 series as a major
upgrade and to check the Removals list.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E2Njj4j1r9twkVcXsMySLW
@trans trans changed the title Date Facets from 2004 and tell its origin story Date Facets from 2004, tell its origin story, and note 3.2.0's versioning Sep 27, 2026
@trans
trans merged commit 9e4fad4 into main Sep 27, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants