MIgrate nav docs script over ios-sdk repo

[danswick]

Related: mapbox/mapbox-directions-swift#467

This PR will move the shell script for generating documentation from /ios-sdk into this repo. The script will generate the documentation, switch and commit the new version on the publisher-production branch.

To do:

• Verify version branch naming convention
• Test script
• Document!

cc @katydecorah and @1ec5

Ref mapbox/ios-sdk#980

[1ec5]

Great, I think we should also name the script something more descriptive, like publish-documentation.sh.

[1ec5]

The CircleCI build failures are due to Homebrew unreliability that #2667 will work around by downloading Carthage directly from GitHub.

[MaximAlien]

Is it correct path? As I can see later in this script we attempt to add contents from ./$VERSION, here on the other hand we create ./navigation/api/$VERSION folder.

[danswick]

Thanks for pointing that out, @MaximAlien. You are correct and I've updated this value.

[danswick]

Thank you @1ec5 and @MaximAlien for your comments. I've made some updates to address the issues you've pointed out. I tested locally and all seemed to work. I would appreciate another tester if anyone has some spare cycles.

[stale]

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[stale]

Stale.