Azure / Azure/azure-rest-api-specs

Clean up Cognitive Language - Language pillar readme.md

Open
#18,277 1 comment 0 reactions 0 assignees View on GitHub
Client Cognitive - LUIS Cognitive - QnA Maker Cognitive - Text Analytics Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
2d 22h
Merged PRs (30d)
444

Description

There are currently 3 top-level blocks trying to declare default tags (there can be only one - and it doesn't make sense with separate SDKs anyway), and we could move the title to a global to avoid repeating it.

https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/Language/readme.md

Currently, though, I don't think we're using this file but want to eventually - not just for autorest, but any other tools that need to parse the different versioned swaggers.

/cc @annatisch @abhahn

Contributor guide

Open the contributing guide

Research direction

Start with specification/cognitiveservices/data-plane/Language/readme.md and inspect its three top-level default-tag blocks and repeated title. Consolidate the default-tag declaration appropriately for the separate SDKs and move the title to a global, leaving one coherent configuration for tools that parse the versioned swaggers.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
documentation, tooling
Issue type
Refactor
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.