Writing & StyleStyle guide

Formatting Ports in Technical Documentation

Formatting Ports in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Quick answer

Use all-uppercase presentation for port names in Microsoft-style developer documentation.

Key details

Core IssueUse all-uppercase presentation for port names in Microsoft-style developer documentation.
RegisterMicrosoft technical and professional documentation

Important caveats

Scope Boundary

This is a house-style convention for port names such as LPT1; it does not govern network port numbers or ordinary uses of the word “port.”

Further guidance

Content

Use all-uppercase presentation for port names in Microsoft-style developer documentation.

Purpose

Help readers distinguish the literal technical element from surrounding explanatory prose.

Sources and evidence

Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.

  1. Formatting developer text elements — Microsoft Style Guide (opens in a new tab)Microsoft · Microsoft Style Guide conventions for formatting programmatic and code-related elements in developer content.

Related guides

Writing & Style

Formatting AI Prompts in Technical Documentation

Formatting AI Prompts in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Attributes in Technical Documentation

Formatting Attributes in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Classes in Technical Documentation

Formatting Classes in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Code Keywords in Technical Documentation

Formatting Code Keywords in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Code Samples in Technical Documentation

Formatting Code Samples in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it scoped to technical instructions rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Constants in Technical Documentation

Formatting Constants in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Control Classes in Technical Documentation

Formatting Control Classes in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Data Formats in Technical Documentation

Formatting Data Formats in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Explore the topic