Combine abstract and discussion in page overview

[luketheobscure]

I've got the following file in my project:

/**
    Protocol for storing information about a diff.

    Two things that kind of suck:
        - As of XCode 6.1.1, There's some kind of bug between the @NSManaged directive, protocols, and the compiler, so we can't set these as actual @NSManaged properties in out models, thus the weird names
        - We have to add the @objc or else the compiler won't let us assign back to these variables, despite having defined setters.
*/

@objc
public protocol Diffable {
    var diffUrlString: String? { get set }
    var diffString: String? { get set }
}

As expected, the whole comment shows up in the "Protocols available globally section" under "Diffable". But if I document the two variables "Diffable" gets it's own section, and we only get the first line of the comment. Removing the blank line gives me two lines of documentation, but we don't get the list. See attached.

Properties not documented:

Properties documented (documentation is truncated):

[segiddins]

@jpsim this seems to be the abstract vs the discussion... Should the partials they're currently in be switched?

[jpsim]

I think we should show combined abstract/discussion in both cases, instead of just in the inline view.

[jpsim]

Done in f0060d8.

[luketheobscure]

I'm not sure this worked. Here's the documentation generated with Jazzy 0.0.19: http://luketheobscure.github.io/BlargBucket/Protocols/Diffable.html

Here's the file that was parsed:
https://github.com/luketheobscure/BlargBucket/blob/master/BlargBucket/Models/Base%20Classes/Diffable.swift

[jpsim]

That change hasn't been pushed to rubygems yet. You'll have to run from the current master branch to see the change.