1250470 - Side menu on MDN contracted

Status: RESOLVED WONTFIX

(Developer Documentation Graveyard :: Firefox OS, defect)

Description

[Jonathan Kingston [:jkt] he/him]

What did you do?
================
1. Went to: https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build

What happened?
==============
The side menu was contracted for sub items that I was viewing

What should have happened?
==========================
The side menu should be expanded

Is there anything else we should know?
======================================

Comment 1

[Florian Scholz (Open Web Docs)]

https://developer.mozilla.org/en-US/docs/Template:FirefoxOSSidebar is the template that generates the side menu.

It is currently set up so that it looks for URL hierarchies. Example:

When browsing https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_build_process_summary the "Build and install" item is expanded because the URL contains the hierarchy "Building_and_installing_Firefox_OS".

However, https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build is mentioned in the "Build and install" menu, but is not actually under the https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS hierarchy.

In fact, the hierarchies of menu items are quite cluttered:

Mozilla/Firefox_OS/Building_and_installing_Firefox_OS
Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_build_process_summary
Mozilla/Firefox_OS/Firefox_OS_build_prerequisites
Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build
Mozilla/Firefox_OS/Building
Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/B2G_installer_add-on
Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Building_for_Flame_on_OS_X
Mozilla/Firefox_OS/Choosing_how_to_run_Gaia_or_B2G 
Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Compatible_Devices
Mozilla/Firefox_OS/Building_the_Firefox_OS_simulator
Mozilla/Firefox_OS/Using_the_B2G_emulators
Mozilla/Firefox_OS/Installing_on_a_mobile_device
Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_update_packages
Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_update_packages
Mozilla/Firefox_OS/Building/FOTA_community_builds
Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/B2G_Build_Variables_Reference_Sheet

There is no hierarchy (pages sit directly under Firefox_OS/), there is "Building/", and there is "Building_and_installing_Firefox_OS/" (which is the only thing that currently triggers expanding the menu).

Chris, two options:
a) we move pages into clear hierarchies and use the current mechanism that expands the menu, or
b) we come up with a different way (see https://developer.mozilla.org/en-US/docs/Template:JsSidebar) to expand the menu correctly for the given pages so that it makes sense.

What do you prefer?

Comment 2

[Chris Mills [:cmills]]

(In reply to Florian Scholz [:fscholz] (MDN) from comment #1)

> Chris, two options:
> a) we move pages into clear hierarchies and use the current mechanism that
> expands the menu, or
> b) we come up with a different way (see
> https://developer.mozilla.org/en-US/docs/Template:JsSidebar) to expand the
> menu correctly for the given pages so that it makes sense.
> 
> What do you prefer?

a. is clearly the best option here. The hierarchy is a bit of a mess, and could do with improving.

I will be able to get this done as part of my upcoming work to update the FxOS zone to B2G branding, which will also involve archiving some of the stuff that is no longer relevant.

I will record this bug on a new trello card to keep track of it.

Comment 3

[Jonathan Kingston [:jkt] he/him]

I think it is fair to say Firefox OS specific MDN changes won't be fixed now. Please reopen if you you think differently.