search

Azure / azure-cli

Azure Command-Line Interface
MIT License
3.98k stars 2.95k forks source link

Documentation for Preview features should indicate that the feature is preview. #11923

Open btardif opened 4 years ago

btardif commented 4 years ago

Is your feature request related to a problem? Please describe. Customers are looking at documentation and getting confused when they discover a command is in preview when docs don't have any indication that is the case.

Describe the solution you'd like Add some decoration to documentation pages to indicate commands that are in preview, this should be automated based on the 'is_preview=True' tag

btardif commented 4 years ago

@panchagnula FYI

yonzhan commented 4 years ago

add to S165.

btardif commented 4 years ago

@yonzhan any progress on this item? looks like it's just getting punted from sprint to sprint

yonzhan commented 4 years ago

We are working with document team about this. Will update here if any progress.

btardif commented 4 years ago

@Juliehzl any news on this issue, looks like it's just getting punted form sprint to sprint.

Juliehzl commented 4 years ago

Hi @btardif, for the document part, which is owned by docs team. We need to discuss with docs team for further upgrade.

But because the limit of work bandwidth, we have to do some features with higher priority this sprint. We will move it to backlog and make a plan for it with docs team asap.

btardif commented 4 years ago

@Juliehzl its been > 2 months, so just checking in here. Looks like this is still not prioritized.

@LomisChen is this something you can help push through?

btardif commented 4 years ago

ping @LomisChen it's been another 2 months with no updates....

chenlomis commented 4 years ago

Apologies the previous comments didn't show up in my FTE account... @btardif @dbradish-microsoft and we were just discussing providing a doc explaining the similarities and diffs between ore, extenisons, GA, preview, and experimental

We will also work with Catherine to look into autogenerating the tag etc

btardif commented 4 years ago

Any news here @chenlomis ?

yonzhan commented 4 years ago

@dbradish-microsoft may help with the latest status.