Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Misc changes from Myron #19

Merged
merged 8 commits into from
Nov 4, 2014
Merged

Misc changes from Myron #19

merged 8 commits into from
Nov 4, 2014

Conversation

myronmarston
Copy link
Member

  • Use consistent style for code snippets
  • Fix typo
  • Greatly expand history.

The history could use some feedback, particularly from @dchelimsky. Is it accurate? Did I cover the important things?

/cc @JonRowe

- Favor `RSpec.describe` for outer describe.
- Remove unneeded blank lines (it made the page
  longer than it needed to be).
- "for an all gutter game" reads better.
over by David Chelimsky who brought it into the limelight as a behaviour
driven style development tool. David also built rspec-rails, which provided
tight integration with 
= link_to 'Ruby on Rails', 'http://rubyonrails.org/'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe you can use #{} interpolation to tidy this up.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, I was wondering about that...I'll give that a shot.

@myronmarston
Copy link
Member Author

BTW, @JonRowe, I noticed that there's no favicon -- can you make one from the logo?

Also, added a release date for RSpec 3.
The old spec was more specific (an all zero game)
then the implementation (which summed all the pins).
Given we didn’t want to do the “simplest” thing and hard
code a return value of 0, it’s better to have a spec
that actually forces the summing of the pins.
@myronmarston
Copy link
Member Author

OK, @JonRowe, I used string interpolation. Thanks for the tip.

I also updated the example spec -- let me know what you think.

On a side note...I think the "created with the assistance of Ninefold" footer looks pretty janky. What's with the cattle icon? Can we clean that up?

@JonRowe
Copy link
Member

JonRowe commented Nov 3, 2014

That's Brutus, their "mascot", I'm open to improving it, I asked them if they wanted to improve it but they were fine with it, we can always tweak it though :)

@myronmarston
Copy link
Member Author

That's Brutus, their "mascot", I'm open to improving it, I asked them if they wanted to improve it but they were fine with it, we can always tweak it though :)

Hmm, I had no idea it's their mascot. I expected to see something like the "stacks" logo I see at their site.

Regardless, it'd be good to center the footer text and logo rather than it being left-aligned. Also, the footer seems much taller than it needs to be. Should we shrink it a bit?

My CSS skills are virtually non-existent so it's probably best if someone else makes those changes.

@myronmarston
Copy link
Member Author

BTW, do you have any feedback on what I wrote up as the history?

@myronmarston
Copy link
Member Author

Regarding the favicon, it appears there's a middleman plugin that may help here:

https://github.com/follmann/middleman-favicon-maker


p
| RSpec 1.0 was released in May of 2007, and included many of the
features that are still present in RSpec today.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given that HTML won't respect this spacing there's no need for the new line break here.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't intend for this to be a line break in the HTML..these were originally separate paragraphs and then I joined them into one. I'll reformat it a bit so it doesn't look odd in the source, though.

@JonRowe
Copy link
Member

JonRowe commented Nov 4, 2014

Changes look good to me, is it worth mentioning the expansion of the core team before RSpec 3? I'll work on a favicon :)

@myronmarston
Copy link
Member Author

Changes look good to me, is it worth mentioning the expansion of the core team before RSpec 3?

I thought about it, but if we mention the history of some folks joining the core team I'd feel obligated to mention when everyone who has ever been on the core team joined. I don't think our users care to know that level of detail.


p
| RSpec began life in 2005 as an experiment by Steven Baker. It was taken
over by David Chelimsky who brought it into the limelight as a behaviour
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not necessary, but you could say "taken over by David Chelimsky in 2006".

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea. I added the year in 4502ef9 although I worded it differently -- I didn't think it read well to say "taken over by David Chelimsky in 2006 who brought it into the limelight...".

@dchelimsky
Copy link
Contributor

LGTM.

myronmarston added a commit that referenced this pull request Nov 4, 2014
@myronmarston myronmarston merged commit 3c50fc8 into source Nov 4, 2014
@myronmarston myronmarston deleted the initial-myron-changes branch November 4, 2014 18:25
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.

3 participants