Skip to content

Commit 358c32e

Browse files
committed
doc: update CHANGELOG and README
1 parent 37e7d44 commit 358c32e

2 files changed

Lines changed: 18 additions & 3 deletions

File tree

CHANGELOG.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,34 @@
44

55
### Packaging
66

7-
Native (precompiled) gems are available for the following platforms:
7+
#### Faster, more reliable installation
8+
9+
Native (precompiled) gems are available for Ruby 2.6, 2.7, 3.0, and 3.1 on all these platforms:
810

911
- `aarch64-linux`
1012
- `arm-linux`
1113
- `arm64-darwin`
12-
- `x64-mingw32` / `x64-mingw-ucrt`
14+
- `x64-mingw32` and `x64-mingw-ucrt`
1315
- `x86-linux`
1416
- `x86_64-darwin`
1517
- `x86_64-linux`
1618

19+
If you are using one of these Ruby versions on one of these platforms, the native gem is the recommended way to install sqlite3-ruby.
20+
1721
See [the README](https://github.com/sparklemotion/sqlite3-ruby#native-gems-recommended) for more information.
1822

1923

24+
#### More consistent developer experience
25+
26+
Both the native (precompiled) gems and the vanilla "ruby platform" (source) gem include sqlite v3.39.0 by default.
27+
28+
Defaulting to a consistent version of sqlite across all systems means that your development environment behaves exactly like your production environment, and you have access to the latest and greatest features of sqlite.
29+
30+
You can opt-out of the packaged version of sqlite (and use your system-installed library as in versions < 1.5.0). See [the README](https://github.com/sparklemotion/sqlite3-ruby#avoiding-the-precompiled-native-gem) for more information.
31+
32+
[Release notes for this version of sqlite](https://sqlite.org/releaselog/3_39_0.html)
33+
34+
2035
### Rubies and Platforms
2136

2237
* TruffleRuby is supported.

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ If you're on a platform that supports a native gem but you want to avoid using i
111111
- version 2.0 or earlier, then you'll need to run `bundle config force_ruby_platform true`
112112

113113

114-
### Compiling the Native Extension
114+
### Compiling the source gem
115115

116116
If you are on a platform or version of Ruby that is not covered by the Native Gems, then the vanilla "ruby platform" (non-native) gem will be installed by the `gem install` or `bundle` commands.
117117

0 commit comments

Comments
 (0)