This reads a little awkwardly, and we should document the parameters. (I know this file does not do that consistently).

For future reference, we use (http://tomdoc.org)[TomDoc] for our documentation style.

Perhaps something like this would read better.
```
// Resizes a rectangle to fit inside a larger containing rectangle.
//
// rect          - The rectangle to resize.
// maxRect  - The rectangle to fit rect inside.
//
// Returns a new CGRect that has the same aspect ratio as the provided rectangle, but is resized and centred to fit inside the maxRect.
```