Skip to content

Commit 07ccd5b

Browse files
Merge pull request #35934 from MicrosoftDocs/main
Auto Publish – main to live - 2025-11-25 18:30 UTC
2 parents d3d8334 + 98c8f9d commit 07ccd5b

File tree

352 files changed

+781
-609
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

352 files changed

+781
-609
lines changed

.github/copilot-instructions.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Copilot Instructions for Microsoft Learn
2+
3+
These instructions define a unified style and process standard for authoring and maintaining learn.microsoft.com documentation with GitHub Copilot or other AI assistance.
4+
5+
## Learn-wide Instructions
6+
7+
Below are instructions that apply to all Microsoft Learn documentation authored with AI assistance. Learn product team will update this periodically as needed. Each repository SHOULD NOT update this to avoid being overwritten, but update the repository-specific instructions below as needed.
8+
9+
### AI Usage & Disclosure
10+
All Markdown content created or substantially modified with AI assistance must include an `ai-usage` front matter entry:
11+
- `ai-usage: ai-generated` – AI produced the initial draft with minimal human authorship
12+
- `ai-usage: ai-assisted` – Human-directed, reviewed, and edited with AI support
13+
- Omit only for purely human-authored legacy content
14+
15+
If missing, **add it**. However, do not add or update the ai-usage tag if the changes proposed are confined solely to:
16+
- Links (link text and/or URLs)
17+
- Single words or short phrases, such as entries in table cells
18+
- Less than 5% of the article's word count
19+
20+
### Writing Style
21+
22+
Follow [Microsoft Writing Style Guide](https://learn.microsoft.com/style-guide/welcome/) with these specifics:
23+
24+
#### Voice and Tone
25+
26+
- Active voice, second person addressing reader directly
27+
- Conversational tone with contractions
28+
- Present tense for instructions/descriptions
29+
- Imperative mood for instructions ("Call the method" not "You should call the method")
30+
- Use "might" instead of "may" for possibility
31+
- Avoid "we"/"our" referring to documentation authors
32+
33+
#### Structure and Format
34+
35+
- Sentence case headings (no gerunds in titles)
36+
- Be concise, break up long sentences
37+
- Oxford comma in lists
38+
- Number all ordered list items as "1." (not sequential numbering like "1.", "2.", "3.", etc.)
39+
- Complete sentences with proper punctuation in all list items
40+
- Avoid "etc." or "and so on" - provide complete lists or use "for example"
41+
- No consecutive headings without content between them
42+
43+
#### Formatting Conventions
44+
45+
- **Bold** for UI elements
46+
- `Code style` for file names, folders, custom types, non-localizable text
47+
- Raw URLs in angle brackets
48+
- Use relative links for files in this repo
49+
- Remove `https://learn.microsoft.com/en-us` from learn.microsoft.com links
50+
51+
## Repository-Specific Instructions
52+
53+
Below are instructions specific to this repository. These may be updated by repository maintainers as needed.
54+
55+
<!--- Add additional repository level instructions below. Do NOT update this line or above. --->
56+
57+

.openpublishing.redirection.ssms.json

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -622,7 +622,7 @@
622622
},
623623
{
624624
"source_path": "docs/ssms/download-sql-server-management-studio-ssms-20.md",
625-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
625+
"redirect_url": "/ssms/install/install",
626626
"redirect_document_id": false
627627
},
628628
{
@@ -1932,7 +1932,7 @@
19321932
},
19331933
{
19341934
"source_path": "docs/ssms/about-dialog-box.md",
1935-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
1935+
"redirect_url": "/ssms/sql-server-management-studio-ssms",
19361936
"redirect_document_id": false
19371937
},
19381938
{
@@ -2002,7 +2002,7 @@
20022002
},
20032003
{
20042004
"source_path": "docs/ssms/menu-help/options-dialog-boxes-f1-help.md",
2005-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
2005+
"redirect_url": "/ssms/sql-server-management-studio-ssms",
20062006
"redirect_document_id": false
20072007
},
20082008
{
@@ -2057,7 +2057,7 @@
20572057
},
20582058
{
20592059
"source_path": "docs/ssms/menu-help/choose-search-folders-dialog-box-visual-studio.md",
2060-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
2060+
"redirect_url": "/ssms/sql-server-management-studio-ssms",
20612061
"redirect_document_id": false
20622062
},
20632063
{
@@ -2317,7 +2317,7 @@
23172317
},
23182318
{
23192319
"source_path": "docs/ssms/object/name-not-found-dialog-box.md",
2320-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
2320+
"redirect_url": "/ssms/sql-server-management-studio-ssms",
23212321
"redirect_document_id": false
23222322
},
23232323
{
@@ -2672,7 +2672,7 @@
26722672
},
26732673
{
26742674
"source_path": "docs/ssms/download-sql-server-management-studio-ssms-19.md",
2675-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
2675+
"redirect_url": "/ssms/install/install",
26762676
"redirect_document_id": false
26772677
},
26782678
{
@@ -2682,7 +2682,7 @@
26822682
},
26832683
{
26842684
"source_path": "docs/ssms/sql-server-management-studio-ssms-release-candidate.md",
2685-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
2685+
"redirect_url": "/ssms/sql-server-management-studio-ssms",
26862686
"redirect_document_id": false
26872687
},
26882688
{
@@ -2717,7 +2717,7 @@
27172717
},
27182718
{
27192719
"source_path": "docs/ssms/menu-help/windows-dialog-box-microsoft-document-explorer-help.md",
2720-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
2720+
"redirect_url": "/ssms/sql-server-management-studio-ssms",
27212721
"redirect_document_id": false
27222722
},
27232723
{
@@ -3647,7 +3647,7 @@
36473647
},
36483648
{
36493649
"source_path": "docs/ssms/sql-server-management-studio-release-notes.md",
3650-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms#release-notes",
3650+
"redirect_url": "/ssms/release-notes-22",
36513651
"redirect_document_id": false
36523652
},
36533653
{
@@ -3692,7 +3692,7 @@
36923692
},
36933693
{
36943694
"source_path": "docs/ssms/index.md",
3695-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
3695+
"redirect_url": "/ssms/sql-server-management-studio-ssms",
36963696
"redirect_document_id": false
36973697
},
36983698
{
@@ -4522,7 +4522,7 @@
45224522
},
45234523
{
45244524
"source_path": "docs/ssms/download-sql-server-management-studio-ssms.md",
4525-
"redirect_url": "/ssms/download-sql-server-management-studio-ssms",
4525+
"redirect_url": "/ssms/install/install",
45264526
"redirect_document_id": false
45274527
},
45284528
{

0 commit comments

Comments
 (0)