/Console-Docs

Windows Console Docs Repo

Primary LanguagePowerShellCreative Commons Attribution 4.0 InternationalCC-BY-4.0

Windows Console Documentation

Welcome to the Windows Console documentation repo. The MSDN Console Docs are generated from the markdown stored in this repo. The published docs can be found at https://docs.microsoft.com/windows/console/

For code issues related to the Windows Console, Windows Terminal, and related command-line and terminal tooling products acquired with Windows, from the Windows Store, or other sources like GitHub, please check out the Microsoft/Terminal repository.

Metadata

Each content page in this repo requires some metadata expressed as YAML, stored at the top of each doc between '---' markers. For example:

---
title: About Consoles
description: Consoles provide high-level support for simple character-mode applications that interact with the user by using functions that read from standard input and write to standard output or standard error.
author: miniksa
ms.author: miniksa
ms.assetid: 39204f0e-b0b8-4f92-af8e-e146ac06c454
ms.topic: article
---

# About Consoles

Consoles provide high-level support for ...

Notes on metadata:

  • author: Main article author
  • ms.author: Additional co-authors / contributors / editors
  • ms.assetid: UUID used by BI for reporting and analysis. Generated by CAPS for existing content, auto-generated by OPS in future
  • ms.topic: One of [article | get-started-article | hero-article | hub-page | landing-page | non-content | reference | search] (see this Excel workbook for current valid values).

While some metadata is stored per file (e.g. above), common metadata required by all files within a documentation set (docset) is stored in the docfx.json file in the root of the docs folder, e.g.:

  "build": {
    #...
    "fileMetadata": {
      "ms.prod": { "/console/**.yml": "windows"},
      "ms.technology": { "/console/**.yml": "desktop"},
      "manager": {"/console/**.yml": "richturn"}
    }
  }
}

The values for ms.prod and ms.technology are standard for Win32 API's & desktop technology, as defined in the Excel workbook above. Custom values can be registered if required.