Azure / Azure/azure-powershell

[Doc]: New-AzApplicationInsightsContinuousExport parameters

Open
#16,452 2 comments 0 reactions 0 assignees View on GitHub
customer-reported needs-triage question
Dominant language
C#
Stars
4.8k
Forks
4.3k
Avg merge
3d 14h
Merged PRs (30d)
54

Description

### Description

On this page https://docs.microsoft.com/en-us/powershell/module/az.applicationinsights/new-azapplicationinsightscontinuousexport?view=azps-6.6.0&viewFallbackFrom=azps-6.3.0

The example shows -StorageLocation sourcecentralus, the param description states:

-StorageLocation
Destination Storage Location Id.

Which doesn't really describe what information we need to pass the parameter. We're already passing it the storage account id, container, and resource group. Based on the example value I believe it wants the geolocation of the storage account but doesn't explain why the word source is in front of it.

I think the param description needs to be more detailed, at the moment it's very vague. Somewhat like looking up a word in a dictionary only to find that they used the same word on the definition.

Contributor guide

Open the contributing guide

Research direction

Start with the linked New-AzApplicationInsightsContinuousExport documentation page and inspect the -StorageLocation example and parameter description. Clarify what value is expected, including the meaning of the sourcecentralus example and how it relates to the storage account details, then verify the rendered parameter documentation is specific and consistent.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, powershell
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.