Merge pull request timoxley#47 from Sequoia/master

Normalize export style in problem.md

Author: timoxley

problems/async_loops/problem.md

@@ -4,7 +4,6 @@ A Java developer has committed this terrible code to our codebase
 and didn't test it!
 
 ```js
-
 function loadUsers(userIds, load, done) {
   var users = []
   for (var i = 0; i < userIds.length; i++) {
@@ -14,38 +13,29 @@ function loadUsers(userIds, load, done) {
 }
 
 module.exports = loadUsers
-
 ```
 
-Task: Fix this code! The callback should be called with all the users loaded.
-
+# Task: Fix this code! The callback should be called with all the users loaded.
 The order of the users should match the order of supplied user ids.
 Because this function is asynchronous, we do not care about its return value.
 
-Arguments:
-
+## Arguments
 * userIds: an Array of numeric user ids.
 * load: a Function used to load user objects. Expects a numeric id and a callback. The callback will be called with the
   result of loading the user with the specified id (either a user object or null).
 * done: a Function that expects an Array of user objects (as retrieved from `load`).
 
-Conditions:
-
+## Conditions
 * Do not use any for/while loops.
 * The order of the results in `done` must be the same as they were specified in `userIds`.
 * Users should be loaded in parallel i.e. the entire job should not take more than 1 second.
 
-Hint:
+## Hint 
 
 * You don't need to use a sort to maintain ordering.
 
-
-#################
-## Boilerplate ##
-#################
-
+## Boilerplate
 ```js
-
 function loadUsers(userIds, load, done) {
   var users = []
   for (var i = 0; i < userIds.length; i++) {
@@ -55,5 +45,4 @@ function loadUsers(userIds, load, done) {
 }
 
 module.exports = loadUsers
-
 ```

problems/basic_call/problem.md

@@ -13,15 +13,13 @@ We can use Object#hasOwnProperty to detect if an object 'has' a property defined
 inherited from its prototype):
 
 ```js
-
 var duck = {
   quack: function() {
     console.log('quack')
   }
 }
 
 duck.hasOwnProperty('quack') // => true
-
 ```
 
 We didn't give the duck a .hasOwnProperty method, where did it come from?
@@ -30,18 +28,15 @@ Duck was created with the `{}` syntax, and as such
 it inherits from Object.prototype:
 
 ```js
-
 var object = {quack: true}
 
 Object.getPrototypeOf(object) === Object.prototype // => true
 object.hasOwnProperty('quack')                     // => true
-
 ```
 
 But what if an object doesn't inherit from Object.prototype?
 
 ```js
-
 // create an object with 'null' prototype.
 var object = Object.create(null)
 object.quack = function() {
@@ -53,7 +48,6 @@ Object.getPrototypeOf(object) === null             // => true
 
 object.hasOwnProperty('quack')
 // => TypeError: Object object has no method 'hasOwnProperty'
-
 ```
 
 We can still use `hasOwnProperty` from the `Object.prototype` though,
@@ -62,15 +56,13 @@ an object'. Function#call allows us to invoke any function with
 an altered `this` value.
 
 ```js
-
 // the first argument to call becomes the value of `this`
 // the rest of the arguments are passed to the function as per
 
 Object.prototype.hasOwnProperty.call(object, 'quack') // => true
-
 ```
 
-Task:
+# Task:
 
 Write a function `duckCount` that returns the number of arguments passed to it which
 have a property 'quack' defined directly on them. Do not match values inherited
@@ -79,40 +71,36 @@ from prototypes.
 Example:
 
 ```js
-
 var notDuck = Object.create({quack: true})
 var duck = {quack: true}
 duckCount(duck, notDuck) // 1
-
 ```
-Arguments:
+## Arguments
 
 * You will be passed 0-20 arguments. Each argument could be of any type with any
   properties. Some of these items will have a 'quack' property.
 
-Conditions:
+## Conditions
 
 * Do not use any for/while loops.
 * Do not create any counter/accumulator variables.
 * You do not need to define any additional name functions
   unless a stub is provided in the boilerplate.
 
-Hint:
+## Hint
 
 * The arguments variable, available in every function,
   is an object that quacks like an Array:
 
 ```js
-
 {
   0: 'argument0',
   1: 'argument1', // etc
   length: 2
 }
-
 ```
 
-Resources:
+## Resources
 
 * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/call
 * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty
@@ -121,16 +109,12 @@ Resources:
 * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions_and_function_scope/arguments
 
 
-#################
-## Boilerplate ##
-#################
+## Boilerplate
 
 ```js
-
 function duckCount() {
   // SOLUTION GOES HERE
 }
 
 module.exports = duckCount
-
 ```

problems/basic_every_some/problem.md

@@ -1,16 +1,13 @@
-Task:
+# Task
 
 Return a function that takes a list of valid users, and returns a function that returns true
 if all of the supplied users exist in the original list of users.
 
 You only need to check that the ids match.
 
-#############
-## Example ##
-#############
+## Example
 
 ```js
-
 var goodUsers = [
   { id: 1 },
   { id: 2 },
@@ -32,31 +29,28 @@ testAllValid([
   { id: 1 }
 ])
 // => false
-
 ```
 
-Arguments:
+## Arguments
 
 * goodUsers: a list of valid users
 
 Use array#some and Array#every to check every user passed to your returned
 function exists in the array passed to the exported function.
 
-Resources:
+## Resources
 
 * https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/every
 * https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/some
 
-#################
-## Boilerplate ##
-#################
+## Boilerplate
 
 ```js
-
-module.exports = function checkUsersValid(goodUsers) {
+function checkUsersValid(goodUsers) {
   return function(submittedUsers) {
     // SOLUTION GOES HERE
   };
 }
 
+module.exports = checkUsersValid
 ```

problems/basic_filter/problem.md

@@ -1,55 +1,51 @@
+# Task
 Use Array#filter to write a function called `getShortMessages`.
 
 `getShortMessages` takes an array of objects with '.message' properties
 and returns an array of messages that are *less than < 50 characters long*.
 
-Arguments:
+## Arguments
 
 * messages: an Array of 10 to 100 random objects that look something like this:
 
 ```js
-
 {
   message: 'Esse id amet quis eu esse aute officia ipsum.' // random
 }
-
 ```
 
-Conditions:
+## Conditions
 
 * Do not use for loops or Array#forEach.
 
-Hint: Try chaining some Array methods!
+## Hint
 
-Expected Output:
+* Try chaining some Array methods!
+
+## Expected Output
 
 The function should return an array containing the messages themselves,
 *without their containing object*.
 
 e.g.
-
 ```
-
 [ 'Tempor quis esse consequat sunt ea eiusmod.',
   'Id culpa ad proident ad nulla laborum incididunt.',
   'Ullamco in ea et ad anim anim ullamco est.',
   'Est ut irure irure nisi.' ]
-
 ```
 
-Resources:
+## Resources
 
 * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter
 * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map
 
-#################
-## Boilerplate ##
-#################
+## Boilerplate
 
 ```js
-
-module.exports = function getShortMessages(messages) {
+function getShortMessages(messages) {
   // SOLUTION GOES HERE
 }
 
+module.exports = getShortMessages
 ```

problems/basic_inheritance_with_objectcreate/problem.md

@@ -1,6 +1,4 @@
-##########
-## Task ##
-##########
+# Task
 
 Create a new "BetterUser" type that extends "User" by overriding
 the User's `.toString` method.
@@ -9,7 +7,6 @@ Your exported function will be passed the constructor function
 for a "User" type that looks like this:
 
 ```js
-
 /**
  * User Constructor.
  *
@@ -39,33 +36,36 @@ User.prototype.displayName = function() {
 User.prototype.toString = function() {
   return '[User:'+this.displayName()+']'
 }
-
 ```
 
 Note: you do not need to copy this into your solution.
 
-#####################
-## Expected Output ##
-#####################
+## Expected Output
 
 From your exported function, return a `BetterUser` constructor function
 that extends `User` with a custom `toString` method that works like so:
 
 ```js
-
 var joe = new BetterUser('Mr.', 'Joe Smith') // pass in title and name
 console.log('Hello ' + joe) // 'Hello [BetterUser: Mr. Joe Smith]'
-
 ```
 
-#################
-## Boilerplate ##
-#################
+## Conditions
 
-```js
+* Don't call the User constructor unnecessarily!
+* Don't use `__proto__`
+
+## Resources
+
+* http://yehudakatz.com/2011/08/12/understanding-prototypes-in-javascript/
+* http://tobyho.com/2011/11/11/js-object-inheritance/
+* http://hughfdjackson.com/javascript/2012/01/05/prototypes:-the-short%28est-possible%29-story/
 
+## Boilerplate
+
+```js
 // User is a constructor
-module.exports = function(User) {
+function upgradeUser(User) {
 
   // EDIT THESE AS NECESSARY
   function BetterUser() {
@@ -75,19 +75,5 @@ module.exports = function(User) {
   return BetterUser
 }
 
+module.exports = upgradeUser
 ```
-
-################
-## Conditions ##
-################
-
-* Don't call the User constructor unnecessarily!
-* Don't use `__proto__`
-
-###############
-## Resources ##
-###############
-
-* http://yehudakatz.com/2011/08/12/understanding-prototypes-in-javascript/
-* http://tobyho.com/2011/11/11/js-object-inheritance/
-* http://hughfdjackson.com/javascript/2012/01/05/prototypes:-the-short%28est-possible%29-story/