Change Details

Material for Mkdocs does a really nice rendering of its default/standard horizontal nav menu into a left nav tray when the browser window size can no longer accommodate the full width of all the menu items horizontally: {F34892943} We should investigate the possibility of: 1) having this type of left navigation menu displayed on *all* browsers (likely collapsed into a tray on mobile), 2) decoupling horizontal navigation menu from vertical so that we can have two different sets of items in those menus. This would be a nicer UI for the dev portal because it would have the following benefits: * Better use of screen real estate by not duplicating horizontal and vertical navigation items; use the left nav to provide one type of path through the content (with potentially longer section labels), and use the horizontal menu to provide alternate options, like quick links to key tools or help pages (with succinct, short labels). * Ensure more consistent UX/UI across languages: the Material theme seems to be rather smart about switching from the horizontal menu to the vertical one when the nav labels overflowing the horizontal space. This (nice) behavior will, however, result in the portal rendering differently depending on the language in which you're viewing it. In the screenshot below, for example, the horizontal nav can accommodate the current section labels in English, but if they were being rendered in German, the increased word length would likely result in the horizontal nav automatically being rendered as a left vertical nav instead. It would be nice if you didn't have a different navigation experience based on the language you're using. * Eliminate the need to be overly terse in how we name site sections due to the constraints of displaying section labels horizontally. Labels that look quite nice in a vertical nav look terrible and hard to read when rendered horizontally: {F34892957}

(splitting this into two separate tasks) Material for Mkdocs does a really nice rendering of its default/standard horizontal nav menu into a left nav tray when the browser window size can no longer accommodate the full width of all the menu items horizontally: {F34892943} We should investigate the possibility of having this type of left navigation menu displayed on *all* browsers (likely collapsed into a tray on mobile), This would be a nicer UI for the dev portal because it would: * Ensure more consistent UX/UI across languages: the Material theme seems to be rather smart about switching from the horizontal menu to the vertical one when the nav labels overflowing the horizontal space. This (nice) behavior will, however, result in the portal rendering differently depending on the language in which you're viewing it. In the screenshot below, for example, the horizontal nav can accommodate the current section labels in English, but if they were being rendered in German, the increased word length would likely result in the horizontal nav automatically being rendered as a left vertical nav instead. It would be nice if you didn't have a different navigation experience based on the language you're using. * Eliminate the need to be overly terse in how we name site sections due to the constraints of displaying section labels horizontally. Labels that look quite nice in a vertical nav look terrible and hard to read when rendered horizontally: {F34892957}

(splitting this into two separate tasks) Material for Mkdocs does a really nice rendering of its default/standard horizontal nav menu into a left nav tray when the browser window size can no longer accommodate the full width of all the menu items horizontally: {F34892943} We should investigate the possibility of:of having this type of left navigation menu displayed on *all* browsers (likely collapsed into a tray on mobile), 1) having tThis type of left navigation menu displayed on *all* browsers (likely collapsed into a tray on mobile),would be a nicer UI for the dev portal because it would: 2) decoupling horizontal navigation menu from vertical so that we can have two different sets of items in those menus. This would be a nicer UI for the dev portal because it would have the following benefits: * Better use of screen real estate by not duplicating horizontal and vertical navigation items; use the left nav to provide one type of path through the content (with potentially longer section labels), and use the horizontal menu to provide alternate options, like quick links to key tools or help pages (with succinct, short labels). * Ensure more consistent UX/UI across languages: the Material theme seems to be rather smart about switching from the horizontal menu to the vertical one when the nav labels overflowing the horizontal space. This (nice) behavior will, however, result in the portal rendering differently depending on the language in which you're viewing it. In the screenshot below, for example, the horizontal nav can accommodate the current section labels in English, but if they were being rendered in German, the increased word length would likely result in the horizontal nav automatically being rendered as a left vertical nav instead. It would be nice if you didn't have a different navigation experience based on the language you're using. * Eliminate the need to be overly terse in how we name site sections due to the constraints of displaying section labels horizontally. Labels that look quite nice in a vertical nav look terrible and hard to read when rendered horizontally: {F34892957}