2021 August Console-Docs pass

[miniksa]

Fixes a variety of issues including:

• Closes Several Console API structures missing from Table of Contents #199 - Restores missing structures to TOC
• Closes STD_{{IN,OUT}PUT,ERROR}_HANDLE cannot be both DWORDs and negative #177 - Explains use of signed constants for GetStdHandle
• Closes How to dispose the std handle #184 - Explains disposal behavior for GetStdHandle handles
• Closes There might be a wording error on this page #135 - Clarify foreground/background flag colors for new buffers
• Closes Screen Buffers Not Defined #138 - Cross-link buffer information to conceptual articles
• Closes AllocConsole, FreeConsole, and AttachConsole reset the CtrlHandlers list but isn't documented #212 - Document that Ctrl Handlers are reset when console session changed with Alloc/Attach/Free
• Closes Missing exception #111 - Fix description with mode flags table that became inconsistent with VT flag introduction
• Closes Window Title and Icon? #98 - Remove confusing "icon" wording from VT command description
• Closes ENABLE_ECHO_INPUT meaning is not accurate. #122 - Revise wording on input echo flag to reflect behavior over implementation
• Closes No examples #105 - Add sample for hidden window picking up user32/gdi32 message intercept from OS
• odds and ends found while working these

[opbld30]

Docs Build status updates of commit 3798325:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/TOC.md	✅Succeeded	View
docs/char-info-str.md	✅Succeeded	View
docs/clearing-the-screen.md	✅Succeeded	View
docs/console-control-handlers.md	✅Succeeded	View
docs/console-screen-buffers.md	✅Succeeded	View
docs/console-virtual-terminal-sequences.md	✅Succeeded	View
docs/creation-of-a-console.md	✅Succeeded	View
docs/getstdhandle.md	✅Succeeded	View
docs/includes/console-mode-flags.md	✅Succeeded	View
docs/input-and-output-methods.md	✅Succeeded	View
docs/registering-a-control-handler-function.md	✅Succeeded	View
docs/setconsolectrlhandler.md	✅Succeeded	View
docs/setstdhandle.md	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[lhecker]

Suggested change

	> It is not required to dispose of this handle with [**CloseHandle**](/windows/win32/api/handleapi/nf-handleapi-closehandle) when use is complete. See [**Remarks**](#handle-disposal) for more information.
	It is not required to dispose of this handle with [**CloseHandle**](/windows/win32/api/handleapi/nf-handleapi-closehandle) when you're done using it. See [**Remarks**](#handle-disposal) for more information.

Same below.

[miniksa]

I was told once upon a time to not involve "You" in technical documentation. I could change it to "when completed" or "when done" though.

[lhecker]

Oh yeah I remember having read the same. But I checked again and neither Microsoft's nor Google's technical writing guide mention anything against using "you". In fact they use it in their own examples.

[lhecker]

• In the first sentence I feel like some sort of pronoun or something is missing.
• In the second sentence, "Remember" feels a bit condescending
• If possible it'd be awesome if the English could be simplified computerized, because the MSDN machine translation might choke on this.

[miniksa]

I added a bit of clarity to the first bit.
I cut "remember" from the second bit.
I improved wording on the 3rd bit a little, I think.

Beyond that, I'm hoping @mattwojo can edit for clarity if necessary.

[lhecker]

Suggested change

	> Calling [**AttachConsole**](attachconsole.md), [**AllocConsole**](allocconsole.md), or [**FreeConsole**](freeconsole.md) will reset the table of control handlers in the client process to its initial default state. Handlers must be registered again when the attached console session changes.
	> Calling [**AttachConsole**](attachconsole.md), [**AllocConsole**](allocconsole.md), or [**FreeConsole**](freeconsole.md) will reset the table of control handlers in the client process to their initial default state. Handlers must be registered again when the attached console session changes.

[miniksa]

Their for "control handlers" instead of its for "table" is what you're saying?

[lhecker]

Yeah. Because control handlers is plural I assumed that it needs to be "their" initial states, since there are multiple. Is that incorrect?

[miniksa]

Depends how pedantic you want to be about English. The way I was taught, "table" is the object that is being "reset" therefore it should be "its" as if the additional prepositional phrase "of control handlers" describing what's in the table did not exist in this sentence. This one's done both ways all the time, though, so whichever is clearer to readers is fine with me.

[opbld32]

Docs Build status updates of commit febf911:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/TOC.md	✅Succeeded	View
docs/char-info-str.md	✅Succeeded	View
docs/clearing-the-screen.md	✅Succeeded	View
docs/console-control-handlers.md	✅Succeeded	View
docs/console-screen-buffers.md	✅Succeeded	View
docs/console-virtual-terminal-sequences.md	✅Succeeded	View
docs/creation-of-a-console.md	✅Succeeded	View
docs/getstdhandle.md	✅Succeeded	View
docs/includes/console-mode-flags.md	✅Succeeded	View
docs/input-and-output-methods.md	✅Succeeded	View
docs/registering-a-control-handler-function.md	✅Succeeded	View
docs/setconsolectrlhandler.md	✅Succeeded	View
docs/setstdhandle.md	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld30]

Docs Build status updates of commit 54d0c9a:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/TOC.md	✅Succeeded	View
docs/char-info-str.md	✅Succeeded	View
docs/clearing-the-screen.md	✅Succeeded	View
docs/console-control-handlers.md	✅Succeeded	View
docs/console-screen-buffers.md	✅Succeeded	View
docs/console-virtual-terminal-sequences.md	✅Succeeded	View
docs/creation-of-a-console.md	✅Succeeded	View
docs/getstdhandle.md	✅Succeeded	View
docs/includes/console-mode-flags.md	✅Succeeded	View
docs/input-and-output-methods.md	✅Succeeded	View
docs/registering-a-control-handler-function.md	✅Succeeded	View
docs/setconsolectrlhandler.md	✅Succeeded	View
docs/setstdhandle.md	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld33]

Docs Build status updates of commit 74151bc:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/TOC.md	✅Succeeded	View
docs/char-info-str.md	✅Succeeded	View
docs/clearing-the-screen.md	✅Succeeded	View
docs/console-control-handlers.md	✅Succeeded	View
docs/console-screen-buffers.md	✅Succeeded	View
docs/console-virtual-terminal-sequences.md	✅Succeeded	View
docs/creation-of-a-console.md	✅Succeeded	View
docs/getstdhandle.md	✅Succeeded	View
docs/includes/console-mode-flags.md	✅Succeeded	View
docs/input-and-output-methods.md	✅Succeeded	View
docs/registering-a-control-handler-function.md	✅Succeeded	View
docs/setconsolectrlhandler.md	✅Succeeded	View
docs/setstdhandle.md	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld33]

Docs Build status updates of commit dd6235d:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/TOC.md	✅Succeeded	View
docs/char-info-str.md	✅Succeeded	View
docs/clearing-the-screen.md	✅Succeeded	View
docs/console-control-handlers.md	✅Succeeded	View
docs/console-screen-buffers.md	✅Succeeded	View
docs/console-virtual-terminal-sequences.md	✅Succeeded	View
docs/creation-of-a-console.md	✅Succeeded	View
docs/getstdhandle.md	✅Succeeded	View
docs/includes/console-mode-flags.md	✅Succeeded	View
docs/input-and-output-methods.md	✅Succeeded	View
docs/registering-a-control-handler-function.md	✅Succeeded	View
docs/setconsolectrlhandler.md	✅Succeeded	View
docs/setstdhandle.md	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel