valhalla / valhalla-docs

DEPRECATED: The up-to-date documentation for valhalla can be found in the main repository.
Other
76 stars 44 forks source link

Rework folders in valhalla-docs to simplify publishing process #127

Closed rmglennon closed 6 years ago

rmglennon commented 7 years ago

With the docs being moved to a section at https://mapzen.com/documentation/mobility/ for all of mobility (rather than separate sections for Turn-by-Turn, Matrix, and Optimized route like we had before), there was a lot of custom work with our publishing process to make sure that files were renamed and old URLs redirected.

It's become clearer that we should do these changes upstream in the source files, rather than as part of the publishing process. For example, because of the valhalla-docs file structure and redirecting that has to happen to build the mobility help, we are no longer able to use relative links between files within the same mobility section because they do not forward properly. We have to link with the full, hard-coded URL to link within the mobility help.

I believe it is OK to reorganize the content as it is displayed in GitHub, as we have made no promises for stable links there, and anyone with bookmarks should be able to figure out the new location.

rmglennon commented 7 years ago

As part of this, can also delete any index.md files that are not for the main mobility page or elevation. These are not used now.