Authoring tools and extensions

VS Code, markdown, and extensions

  • Docs Authoring Pack
  • Reflow - why the 100-character limit?

PowerShell best practices

  • Code styling for docs
  • Don’t use continuation characters - use splatting
  • Code fences - powershell vs. azurepowershell-interactive
  • No aliases - Use proper Pascal Case
  • No prompts unless documenting the prompt behavior