“View Source on GitHub” links in documentation are broken

[1ec5]

#7337 changed the framework-root configuration variable for jazzy from ../darwin/src to the hard-coded path build/ios/pkg/dynamic/Mapbox.framework. Now the “View Source on GitHub” links point to e.g. https://github.com/mapbox/mapbox-gl-native/tree/ios-v3.4.0-beta.6/build/ios/pkg/dynamic/Mapbox.framework/Headers/MGLShapeSource.h#L106 – with the right line numbers but a nonexistent path.

/cc @ericrwolfe

[1ec5]

No matter what we use as the source for jazzy, we’re going to wind up with incorrect URLs (either the paths or the line numbers). Here’s a possible alternative:

1. Copy the examples to the original headers to be checked in.
2. Revert the changes to jazzy.yml and document.sh.
3. Keep the unit tests. Add a unit test that ensures the headers are in sync with the tests (by comparing the headers’ contents to the test file’s contents).

[1ec5]

Fixed in #7569 on the release-ios-v3.4.0 branch.