Skip to content

Conversation

@jaredlockhart
Copy link
Contributor

Because

  • We can reorganize the navigation to make it easier to find things

This commit

  • Reorganizes the tree structure
  • Renames articles to have shorter titles

fixes #725

@jaredlockhart
Copy link
Contributor Author

jaredlockhart commented Jan 27, 2026

NAVIGATION STRUCTURE

  • Welcome

    • Welcome
    • Capabilities
    • Finding Help
  • Getting Started

    • Experiment Owners
    • Experimenter Console
    • For Data Scientists
    • For Engineers
    • Access & Reviewers
    • For Leadership
    • Contributing
  • Experiment Workflow

    • Overview
    • Designing
      • Experiments
      • Rollouts
    • Configuring
      • Configuration
      • Localization
    • Testing & QA
      • Mobile Testing
      • Desktop Testing
      • Android Testing
      • iOS Testing
    • Risk Mitigation & Sign-offs
      • Risk Mitigation Overview
      • Comms Sign-off
      • Legal Sign-off
      • Message Consult
      • QA Sign-off
      • VP Sign-off
      • Types of Risk
    • Launching
      • Launching
    • Monitoring
      • Monitoring
    • Analyzing
      • Analysis
    • Ending
      • Ending
  • Platform Implementation Guides

    • Feature Definition
      • Feature Definition (Overview)
      • Desktop (Firefox Desktop)
        • Feature API
        • Pref Experiments
        • Onboarding
      • Mobile/Web
        • Feature Manifest Language (FML)
          • FML Spec
          • Cookbook
          • Front-end Format
          • String Aliases
          • Paths
          • Imports
          • CLI
          • Co-enrollment
          • Feature Metadata
          • Prefs
          • Growable Collections
          • FML History
        • Required UI
        • Feature API
        • Branches
    • Targeting
      • Advanced Targeting
      • Population Sizing
      • Platform-Specific Targeting
        • Desktop
        • Android
        • iOS
      • Advanced Targeting Topics
        • Behavioral Targeting
        • Context Values
      • Targeting FAQ
        • Custom Targeting Options
        • All Channels or No Channels
        • Version Targeting
    • Desktop (Firefox Desktop)
      • Migration Guide
      • Preview Mode
      • Incident Response
      • Local Enrollment
    • Android
      • Getting Started
      • Onboarding
      • Microsurveys
    • iOS
      • Getting Started
      • Onboarding
      • Microsurveys
    • Web (Cirrus)
      • Getting Started
    • Mobile Tools - Nimbus CLI
      • Nimbus CLI
      • Installation
      • Getting Started
      • Opening & Resetting
      • Features
      • Files
      • Patch Files
      • Logs
      • Manifests
      • Devices
      • Environment Variables
      • Instrumentation
      • What's New
  • Data & Analysis

    • Jetstream
      • Overview
      • Metrics
      • Configuration
      • Outcomes
      • Statistics
    • Analysis Tools
      • Experiment Sizing
      • Sizing CLI
      • Telemetry
      • Validation
    • Data Topics
      • Bucketing
      • Missing Exposures
      • Preenrollment Bias
      • Population Representativeness
    • Jetstream Operations
      • Operations
      • Testing
      • Troubleshooting
      • Data Products
      • Platforms
    • Jetstream GitHub (external link)
  • Messaging System

    • Overview
    • Desktop Messaging
      • Journey
      • Surfaces
      • Display Logic
      • Frequency Caps
      • Groups & Campaigns
      • Message Display
      • Limitations
      • Localization
      • Telemetry
      • Mobile Messaging
    • Surveys
  • Advanced Topics

    • First Run
    • Enrollment State Machine
    • Notifications
    • Warnings
    • State & Integration
  • Technical Reference

    • System Architecture
    • SDK Lifecycle
    • Integration Tests
  • FAQ

    • General FAQ
    • Enrollment
      • Experiment Enrollment
    • Exposure
      • Exposure
    • Rollouts
      • Rollout Interactions
      • Sizing
      • Feature Saturation
    • Branches
      • How Many Branches
      • FML Errors
    • Metrics
      • Non-Guardrail Outcomes
    • Results
      • Results Availability
    • Desktop
      • Desktop Prefs
      • Exposure
    • Mobile
      • Mobile FAQ
      • First Run
    • Early Startup
      • How Early is Early?
      • What Do It Do
    • Feature Restart
      • Feature Restart
    • Ending Experiments
      • Ending Experiments
    • Custom Configs
      • Custom Configs
    • Warnings
      • Experimenter Warnings
  • Resources

    • Glossary
    • Developer Tools
    • Foxfooding
    • Local Enrollment
    • What's New Archive
      • 2024
        • Q1 2024
        • Q2 2024
      • 2023
        • Q2 2023
        • Q3 2023
        • Q4 2023
        • March 2023
      • 2022
        • June 2022
        • July 2022
        • August 2022
      • 2021
        • February 2021
        • March 2021
        • April 2021
        • June 2021
  • External Links

    • Experimenter Console (Production)
    • Experimenter Console (Stage)
    • Experimenter GitHub Repo
    • How to Launch a Nimbus Experiment
    • Nimbus Data Transfer Object
    • Experiment Telemetry
    • Lessons Learned

@mikewilli
Copy link
Contributor

I haven't had a chance to look through all the changes, but just some thoughts on the section headers since I think that's the main goal if this PR. Regarding the Data & Analysis section:

  • would it make sense for the Jetstream section to be named Analysis or similar? seems a little odd that there's Jetstream and then later Jetstream Operations, so maybe that would make it more clear
  • Jetstream section sub-header ordering: I'd put Configuration at the bottom since Metrics, Statistics, and Outcomes all go together
  • the Analysis Tools section is a bit confusing to me because not all of these sound like tools
    • what's the difference between Experiment Sizing and Sizing CLI?
    • what is Telemetry? is this talking about a tool? if not, should it go under Data Topics or Jetstream Operations?
  • under Jetstream Operations, I'd suggest renaming Platforms to Applications since I think that's what we call them elsewhere

@jaredlockhart
Copy link
Contributor Author

Thnx for looking @mikewilli I reorganized the data sections from your suggestions. The sizing article was contributed by Daniel and just talks about the math and principles of sizing. The sizing cli article is about how to use a sizing tool inside mozanalysis and the flags for it etc. Now the section about the actual analysis is called Analysis, and down later Jetstream Operations is all about the infra and testing/maintenance/etc.

  • Welcome

    • Introduction
    • Capabilities
    • Finding Help
  • Getting Started

    • For Product
    • Experiment Owners
    • Data Scientists Overview
    • For Engineers
    • Access
    • For Leadership
    • Contributing
  • Experiment Workflow

    • Overview
    • Designing
      • Designing
      • Rollouts Deep Dive
    • Configuring
      • Configuring
      • Localization Process
    • Testing & QA
      • Testing on Mobile
      • Desktop Feature API Testing
      • Android Preview Testing
      • iOS Preview Testing
    • Risk Mitigation & Sign-offs (autogenerated)
    • Launching
      • Launching
    • Monitoring
      • Monitoring
    • Analyzing
      • Analyzing
    • Ending
      • Ending
  • Platform Implementation Guides

    • Feature Definition
      • Feature Definition
      • Desktop
        • Desktop Feature API
        • Desktop Pref Experiments
        • Onboarding Feature Desktop
      • Mobile/Web
        • Feature Manifest Language (FML)
          • FML Spec
          • FML Cookbook
          • FML Front-end Format
          • FML String Alias
          • FML Paths
          • FML Imports
          • FML CLI
          • Coenrolling Features
          • Feature Metadata
          • Using Prefs
          • Growable Collections
          • FM Unimplemented Spec
        • Getting Started Mobile Required UI
        • Feature Variables
        • Branches Page Deep Dive
    • Targeting
      • Custom Audiences
      • Population Sizing
      • Platform-Specific Targeting
        • Desktop Targeting Debug
        • Android Custom Targeting
        • iOS Custom Targeting
      • Advanced Targeting Topics
        • Mobile Behavioral Targeting
        • Recording Targeting Context Values to Glean
      • Targeting FAQ (autogenerated)
    • Desktop (Firefox Desktop)
      • Desktop Migration Guide
      • Preview
      • Desktop Incident Response
      • Desktop Enroll Locally
    • Android
      • Getting Started for Android Engineers
      • Onboarding Feature Android
      • Android Microsurveys
    • iOS
      • Getting Started for iOS Engineers
      • Onboarding Feature iOS
      • iOS Microsurveys
    • Web (Cirrus)
      • Getting Started for Nimbus Web Integration
    • Mobile Tools - Nimbus CLI (autogenerated)
  • Data & Analysis

    • Analysis
      • Overview
      • Metrics
      • Outcomes
      • Statistics
      • Configuration
    • Experiment Sizing
    • Auto-sizing CLI
    • Data Topics
      • Bucketing
      • Sizing
      • Missing Exposures
      • Preenrollment Bias
      • Population Representativeness
      • Telemetry
      • Validating Experiments
    • Jetstream Operations
      • Operations
      • Testing
      • Troubleshooting
      • Data Products
      • Applications
    • Jetstream GitHub (external link)
  • Messaging System

    • Experiments and User Messaging
    • Desktop Messaging (autogenerated)
    • Mobile Surveys
  • Advanced Topics

    • Mobile First Run Experiments
    • Mobile Enrollment State Machine
    • Notificationse
    • Warnings
    • Experimenter State
  • Technical Reference

    • System Architecture
    • Client SDK States and Lifecycle
    • Integration Tests
  • FAQ

    • General FAQ
    • Enrollment
      • Experiment Enrollment
    • Exposure
      • Exposure FAQ
    • Rollouts
      • Rollouts and Experiments
      • Sizing Rollouts
      • Saturation
    • Branches (autogenerated)
    • Metrics (autogenerated)
    • Results (autogenerated)
    • Desktop (autogenerated)
    • Mobile (autogenerated)
    • Early Startup (autogenerated)
    • Feature Restart (autogenerated)
    • Ending Experiments (autogenerated)
    • Custom Configs (autogenerated)
    • Warnings (autogenerated)
  • Resources

    • Glossary
    • Nimbus Devtools Guide
    • Foxfooding
    • Local Enrollment
    • What's New Archive
      • 2024 (autogenerated)
      • 2023 (autogenerated)
      • 2022 (autogenerated)
      • 2021 (autogenerated)
  • External Links

    • Experimenter Console (Production)
    • Experimenter Console (Stage)
    • Experimenter GitHub Repo
    • How to Launch a Nimbus Experiment
    • Nimbus Data Transfer Object
    • Experiment Telemetry
    • Lessons Learned

@yashikakhurana
Copy link
Contributor

@jaredlockhart do we have labs content too in the docs?
Designing
Experiments
Rollouts
New- Labs

@jaredlockhart
Copy link
Contributor Author

@yashikakhurana I don't think so? I don't see one on the current site? Maybe @freshstrangemusic didn't write it yet?

## Find an existing experiment

If the experiment was run with Nimbus, check out the [directory of live and completed experiments](https://experimenter.services.mozilla.com/nimbus/). Normandy experiments can be found [here](https://experimenter.services.mozilla.com/).
Check out the [directory of live and completed experiments](https://experimenter.services.mozilla.com/nimbus/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we update these links to point to the home page? 🤔

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh but that specific line says 'directory of live and complete experiments' which is on the table view, which is what it's linking to?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh sorry I meant where it is necessary, because I don't think we have updated the links like here- Experimenter Console (Production)
Experimenter Console (Stage)

Copy link
Contributor

@yashikakhurana yashikakhurana left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested locally, thank you for organizing this, apart from updating the links to the home page, feel free to merge this, thank you @jaredlockhart

@mikewilli
Copy link
Contributor

Much better, thanks! I think we'll want to clean up and maybe consolidate the sizing information -- there's at least 3 pages that refer to Sizing in the header now -- but that can be separate from this first pass.

Because

* We can reorganize the navigation to make it easier to find things

This commit

* Reorganizes the tree structure
* Renames articles to have shorter titles

fixes #725
@jaredlockhart
Copy link
Contributor Author

@yashikakhurana Okay ya good call, I updated the links to point to either the home page where appropriate, or the table page where appropriate.

And yes @mikewilli exactly, that's the next PR ;D

@jaredlockhart jaredlockhart merged commit e710179 into main Jan 29, 2026
2 checks passed
@jaredlockhart jaredlockhart deleted the 725 branch January 29, 2026 17:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Reorganize Navigation Structure

4 participants