documentation
documentation copied to clipboard
Configuration files, tools, and content to build Mapzen's documentation
It's common in documentation for a page to have a list of related pages (or see also links), in addition to any inline links, where users can get more information....
If we wanted to localize documentation content, here are some factors involved (based on my experience with this): - vendor to do translation (for example, internal vs external) and pricing...
We have some basic URL redirects in this file: https://github.com/mapzen/documentation/blob/master/setup-redirects.py It would be great to get better redirects, including allowing anchor links in the forwarded URL. That does not seem...
It would be nice if we had support for toggles so supporting objc/swift, java/kotlin, etc could look something fancy like this: https://www.mapbox.com/ios-sdk/examples/runtime-toggle-layer/
Also in: https://mapzen.com/common/styleguide/js-components.html#side-navigation  Current behavior: - Sub-sections are collapsed and are separate pages - Only one sub-section that is currently active can...
No keywords are being returned for a session in GA even though searches are occurring.
There are some incompatibilities between Github’s Markdown parsing and Python’s: - Anchor links are different - Linebreaks before lists are different - Ordered lists with images are different @rmglennon can...
This is an example query from the routing documentation where the string is different from the actual link URL: `[/route?json={"locations":[{"lat":40.730930,"lon":-73.991379,"street":"Wanamaker Place"},{"lat":40.749706,"lon":-73.991562,"street":"Penn Plaza"}],"costing":"multimodal","costing_options":{"transit":{"filters":{"stops":{"ids":["s-dr5rsq8pqg-8st~nyu
I don't see a way in MkDocs to set the visibility property for a topic in the table of contents. It seems like including the md file is the only...
Ian's done a bit of that for vector tiles in his Tilepacks work [here](https://github.com/tilezen/tilepacks/blob/master/tilepack/builder.py#L19-L63). ``` def fetch_tile(format_args): sleep_time = 0.5 * random.uniform(1.0, 1.7) response_info = [] while True: url =...