Add additional rdoc example for ordering

[JonRowe]

No description provided.

[myronmarston]

s/paritition/partition/

[myronmarston]

In the future, please write an example snippet like this in a real project and copy it in so you've actually demonstrated it working, @JonRowe. Simple mistakes like you had here are easy for anyone to do, but we do our users a disservice if we merge broken example code in our docs.

[JonRowe]

Apologies I did this last night then forgot to check it over, it actually is a snippet from a real project, I had just over simplified it. FYI the original was:

  config.register_ordering :global do |examples|
    api, rest = examples.partition { |ex| ex.metadata[:api] }
    app, rest = rest.partition { |ex| ex.metadata[:app] }
    randomiser = config.ordering_manager.ordering_registry.fetch(:random)

    [rest, api, app].inject([]) do |specs, more|
      specs += randomiser.order(more)
    end
  end

[myronmarston]

We've tend to use the American spelling with a z:

➜  repos git:(master) ack customize | wc -l
      65
➜  repos git:(master) ack customise | wc -l
       2

Mind spelling it with a z for consistency?

[JonRowe]

@myronmarston I double checked it rendered correctly

[myronmarston]

@JonRowe this LGTM apart from the build failure. I (hopefully) have a fix for the build in #2249 -- maybe you can merge that, rebase this on top, and merge this when it goes green?

[myronmarston]

@JonRowe -- I merged #2248. Want to rebase this to see if it'll go green?