Azure / Azure/azure-cli

References without commands in the azCLI reference TOC

Open
#26,655 1 comment 0 reactions 1 assignee Claimed by @jsntcy View on GitHub
Azure CLI Team bug Documentation potential-pruning
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

### Describe the bug

Reference groups without commands are shown in the reference TOC. We need to either 1.) check for this scenario in our build process or 2.) put an enforceable reference guideline so this doesn't happen. In the interim, I am updating the _service-name.json_ files today and will remove them. This, however, is not a long-term solution.

Example link: https://learn.microsoft.com/en-us/cli/azure/service-page/azure%20voiceservices?view=azure-cli-latest
**Examples:** Azure Application Insights, Azure VoiceServices and Partner Center. Here is a screen print:
![image](https://github.com/Azure/azure-cli/assets/58762114/04d56f8e-0fea-4f6a-bbb8-9a190cc0e4ce)

### Related command

**Azure application insights (az find) -- incorrect mapping. I am fixing this.
Azure VoiceServices (az voice-service)
Partner Center (az partnercenter)**

**This is the resulting customer experience:**
![image](https://github.com/Azure/azure-cli/assets/58762114/72f547cb-35f0-4323-845f-005db28a6cc8)

### Errors

n/a

### Issue script & Debug output

n/a

### Expected behavior

Reference groups without commands should not appear in the TOC.

### Environment Summary

n/a

### Additional context

n/a

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.