@@ -11,16 +11,15 @@ programmers. A style guide that reflects real-world usage gets used, while a
11
11
style guide that holds to an ideal that has been rejected by the people it is
12
12
supposed to help risks not getting used at all&mdash ; no matter how good it is.
13
13
14
- The guide is separated into several sections of related rules. I 've tried to add
15
- the rationale behind the rules (if it's omitted I 've assumed it's pretty
16
- obvious).
14
+ The guide is separated into several sections of related rules. We 've
15
+ tried to add the rationale behind the rules (if it's omitted we 've
16
+ assumed it's pretty obvious).
17
17
18
- I didn't come up with all the rules out of nowhere&mdash ; they are mostly
19
- based on my extensive career as a professional software engineer,
20
- feedback and suggestions from members of the Ruby community and
21
- various highly regarded Ruby programming resources, such as
22
- [ "Programming Ruby"] [ pickaxe ] and
23
- [ "The Ruby Programming Language"] [ trpl ] .
18
+ We didn't come up with all the rules out of nowhere&mdash ; they are
19
+ mostly based on the professional experience of the editors, feedback and
20
+ suggestions from members of the Ruby community and various highly
21
+ regarded Ruby programming resources, such as [ "Programming
22
+ Ruby"] [ pickaxe ] and [ "The Ruby Programming Language"] [ trpl ] .
24
23
25
24
There are some areas in which there is no clear consensus in the Ruby community
26
25
regarding a particular style (like string literal quoting, spacing inside hash
@@ -4592,20 +4591,27 @@ on this guide.
4592
4591
4593
4592
## History
4594
4593
4595
- One thing has always bothered me as a Ruby developer—Python developers
4596
- have a great programming style reference ([PEP-8][]) and we never got an
4597
- official guide, documenting Ruby coding style and best practices. And I do
4598
- believe that style matters. I also believe that a great hacker community, such
4599
- as Ruby has, should be quite capable of producing this coveted document.
4600
-
4601
- This guide started its life as our internal company Ruby coding guidelines
4602
- (written by yours truly). At some point I decided that the work I was doing
4603
- might be interesting to members of the Ruby community in general and that the
4604
- world had little need for another internal company guideline. But the world
4605
- could certainly benefit from a community-driven and community-sanctioned set of
4606
- practices, idioms and style prescriptions for Ruby programming.
4607
-
4608
- Since the inception of the guide I' ve received a lot of feedback from members of
4594
+ This guide started its life as an internal company Ruby coding
4595
+ guidelines (written by [Bozhidar
4596
+ Batsov](https://github.com/bbatsov)). Bozhidar had always been bothered
4597
+ as a Ruby developer about one thing —Python developers had a great programming
4598
+ style reference ([PEP-8][]) and Rubyists never got an official guide,
4599
+ documenting Ruby coding style and best practices. Bozhidar firmly believed
4600
+ that style matters. He also believed that a great hacker community, such
4601
+ as Ruby has, should be quite capable of producing this coveted
4602
+ document. The rest is history...
4603
+
4604
+ At some point Bozhidar decided that the
4605
+ work he was doing might be interesting to members of the Ruby community
4606
+ in general and that the world had little need for another internal
4607
+ company guideline. But the world could certainly benefit from a
4608
+ community-driven and community-sanctioned set of practices, idioms and
4609
+ style prescriptions for Ruby programming.
4610
+
4611
+ Bozhidar served as the guide' s only editor for a few years, before a team of editors
4612
+ was formed once the project transitioned to RuboCop HQ .
4613
+
4614
+ Since the inception of the guide we' ve received a lot of feedback from members of
4609
4615
the exceptional Ruby community around the world. Thanks for all the suggestions
4610
4616
and the support! Together we can make a resource beneficial to each and every
4611
4617
Ruby developer out there.
@@ -4645,9 +4651,6 @@ your friends and colleagues. Every comment, suggestion or opinion we
4645
4651
get makes the guide just a little bit better. And we want to have the
4646
4652
best possible guide, don' t we?
4647
4653
4648
- Cheers,<br>
4649
- [Bozhidar](https://twitter.com/bbatsov)
4650
-
4651
4654
[PEP - 8 ]: https: // www.python.org/ dev/ peps/ pep- 0008 /
4652
4655
[rails- style- guide]: https: // github.com/ rubocop- hq/ rails- style- guide
4653
4656
[pickaxe]: https: // pragprog.com/ book/ ruby4/ programming- ruby- 1 - 9 - 2 - 0
0 commit comments