Skip to content

Commit cf3be7b

Browse files
Colby Swandalestomar
authored andcommitted
Improve the libraries page (en) (#1616)
Improve the libraries documentation by rewriting some areas.
1 parent 5768c3d commit cf3be7b

File tree

1 file changed

+16
-12
lines changed

1 file changed

+16
-12
lines changed

en/libraries/index.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,14 @@ As most programming languages, Ruby leverages a wide set of third-party
88
libraries.
99
{: .summary}
1010

11-
Most of them are released in the form of a **gem**. [**RubyGems**][1] is
12-
a Ruby packaging system designed to facilitate the creation, sharing and
11+
Nearly all of these libraries are released in the form of a **gem**, a packaged
12+
library or application that can be installed with a tool called [**RubyGems**][1].
13+
14+
RubyGems is a Ruby packaging system designed to facilitate the creation, sharing and
1315
installation of libraries (in some ways, it is a distribution packaging
1416
system similar to, say, `apt-get`, but targeted at Ruby software).
15-
Since version 1.9 Ruby comes with RubyGems by default, while previous
16-
Ruby versions require to [install it by hand][2].
17+
Ruby comes with RubyGems by default since version 1.9, previous
18+
Ruby versions require RubyGems to be [installed by hand][2].
1719

1820
Some other libraries are released as archived (.zip or .tar.gz)
1921
directories of **source code**. Installation processes may vary,
@@ -24,11 +26,12 @@ use.
2426

2527
### Finding libraries
2628

27-
The main place where libraries are hosted is [**RubyGems.org**][1],
28-
providing Ruby libs as gems. You may browse the website directly, or use
29+
The main place where libraries are hosted is [**RubyGems.org**][1], a public
30+
repository of gems that can be searched and installed onto your machine.
31+
You may browse and search for gems using [RubyGems.org][1], or use
2932
the `gem` command.
3033

31-
Using `gem search -r`, you can inspect RubyGems' repository. For
34+
Using `gem search -r`, you can search RubyGems' repository. For
3235
instance, `gem search -r rails` will return a list of Rails-related
3336
gems. With the `--local` (`-l`) option, you would perform a local search
3437
through your installed gems. To install a gem, use `gem install [gem]`.
@@ -45,9 +48,10 @@ published as a fully-fledged gem to RubyGems.org.
4548
[**The Ruby Toolbox**][6] is a project that makes it easy to explore open
4649
source Ruby projects. It has categories for various common development tasks,
4750
collects a lot of information about the projects like release and commit
48-
activity or dependencies, and rates projects based on their popularity on
49-
RubyGems.org and GitHub. The search makes it easy to find what you are
50-
looking for.
51+
activity or dependencies and rates projects based on their popularity on
52+
RubyGems.org and GitHub. This makes it easy to find a gem which solves
53+
a particular problem such as web frameworks, documentation tools and
54+
code quality libraries.
5155

5256
### A few more words about RubyGems
5357

@@ -77,13 +81,13 @@ among your installed gems.
7781
#### Installing a gem
7882

7983
Once you know which gem you would like to **install**, for instance the
80-
popular Rails:
84+
popular Ruby on Rails framework:
8185

8286
{% highlight sh %}
8387
$ gem install rails
8488
{% endhighlight %}
8589

86-
You can even install just a certain version of the library, using the
90+
You can even install just a specific version of the library, using the
8791
`--version` / `-v` flag:
8892

8993
{% highlight sh %}

0 commit comments

Comments
 (0)