Thank you for your feedback on the new developer documentation site that launched last month. We’ve been listening closely to your comments, and wanted to provide an update on some enhancements you can expect to see in the coming weeks.
Planned improvements
Below is a list of UI enhancements and new features that we plan to implement, stack-ranked according to priority:
- Improve the styling for tables:
- Make tables responsive; prevent horizontal scrolling on tables except for exceptionally large tables (such as the hardware specifications table)
- Top-justify text within each cell
- Apply width precedence to columns with cells with lots of text
- Drastically increase max width of the body container; minimize unused whitespace on the left- and right-hand sides
- Render the left- and right-hand menus as collapsed when first landing on a new page on a mobile device; optimize menu navigation for mobile experience
- Enable developers to directly contribute content and corrections to the documentation site (DELAYED INDEFINITELY)
- Apply fixed position to the left-hand navigation menu
- Open search results in the same tab when clicked
- Make titles of search results clickable
Additionally, we are tracking the following bugs for resolution:
- The right-hand menu in Safari jumps left after scrolling below the fold
- In Chrome on PC, entries in the right-hand table of contents do not bring the user to the correct anchor point
Feedback is welcome
This thread will remain open until community feedback tapers off significantly. Please continue sharing your feedback with us in the coming weeks. Even if a suggestion has already been recommended by someone else, there is value in putting in an additional request, as it will help us set priority on the most critical updates. Let us know if you believe the above-listed stack ranking of priorities should be adjusted.