azd docs command and flag

[Austinauth]

Related to #822

Description

We'd like to propose adding an azd docs command and an azd <command> --docs flag.

Behavior

Behavior for this command should be fairly simple. Inputing azd docs should open the azd reference page in a new browser window (see Figure 1.A below).

Inputing azd <command> --docs should behave similarly, opening a new browser window to the reference docs section for the specific command entered (see Figure 1.B below).

Figure 1.A

Figure 1.B

[savannahostrowski]

This should be added before GA.

[rajeshkamal5050]

Moving to Gallium @savannahostrowski

[savannahostrowski]

As a start here, we should support just a top-level docs command.

The flag will require some documentation updates. @gkulin for your consideration!

[ellismg]

Do we need a top level docs command or could we have azd --docs behave as azd docs would?

I do think the idea of having some browser based view of our docs is a good idea, I'm less sure we need an entire top level command to do (especially if we are going to support --docs on all the sub commands).

[savannahostrowski]

Now that you mention it, I'd probably prefer a flag to avoid bloating the top-level commands.

I don't think we need to worry about more granular docs right now.