Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rearrange contributor guide #823

Merged
merged 8 commits into from
Sep 28, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,11 @@
"redirect_url": "/contribute/content/dotnet/labels-projects",
"redirect_document_id": true
},
{
"source_path": "Contribute/content/additional-resources.md",
"redirect_url": "/contribute/content/index",
"redirect_document_id": true
},
{
"source_path": "Contribute/dotnet/net-core-5-naming.md",
"redirect_url": "/contribute/content/dotnet/net-core-5-naming",
Expand Down Expand Up @@ -210,6 +215,16 @@
"redirect_url": "/contribute/content/text-formatting-guidelines",
"redirect_document_id": true
},
{
"source_path": "Contribute/content/get-started-setup-github.md",
"redirect_url": "/contribute/content/index",
"redirect_document_id": true
},
{
"source_path": "Contribute/content/how-to-write-workflows-major.md",
"redirect_url": "/contribute/content/how-to-write-major-edits",
"redirect_document_id": true
},
{
"source_path": "Contribute/content/architecture-center/guide-templates.md",
"redirect_url": "/contribute/content/architecture-center/aac-contribute",
Expand Down
96 changes: 56 additions & 40 deletions Contribute/content/TOC.yml
Original file line number Diff line number Diff line change
@@ -1,23 +1,45 @@
- name: Contributor guide overview and browser-based tasks
- name: Contributor guide overview
href: index.md
- name: Set up and work locally
- name: Edit documentation
items:
- name: 1. Sign up for GitHub
href: get-started-setup-github.md
- name: 2. Install Git and Markdown tools
href: get-started-setup-tools.md
- name: 3. Set up a local Git repository
href: get-started-setup-local.md
- name: Overview
href: how-to-write-overview.md
- name: Edit in the browser
href: how-to-write-quick-edits.md
- name: Work locally
items:
- name: 1. Install Git and Markdown tools
href: get-started-setup-tools.md
- name: 2. Set up a local Git repository
href: get-started-setup-local.md
- name: 3. Make major changes
href: how-to-write-major-edits.md
- name: Process a pull request
href: process-pull-request.md
- name: Git and GitHub fundamentals
href: git-github-fundamentals.md
- name: Full workflow
href: how-to-write-workflows-major.md
- name: Writing essentials
- name: Write for Hacktoberfest
href: hacktoberfest.md
- name: Review pull requests
href: how-to-review-pull-request.md
- name: Create GitHub issues
href: how-to-create-github-issues.md
- name: Create and manage Collections
href: collections.md
- name: Respond to Q&A
carlyrevier marked this conversation as resolved.
Show resolved Hide resolved
href: qna-overview.md
- name: Connect with other experts in Tech Community
href: https://techcommunity.microsoft.com/t5/microsoft-learn/ct-p/MicrosoftLearn
#- name: Contributor program (future topic)
# items:
# - name: Overview
# - name: Contributor stories program
- name: Writing resources
items:
- name: Markdown reference
href: markdown-reference.md
displayName: alerts notes tips important caution warnings apostrophes quotation marks quotes blockquotes bold italic code snippets columns headings html images includes links lists bullets bulleted checklist numbered next steps button localize non-localized section selector superscript subscript table tables tabs tabbed videos icons
- name: Style and voice quick start
- name: Style and voice quickstart
href: style-quick-start.md
- name: Microsoft Writing Style Guide
href: /style-guide/
Expand Down Expand Up @@ -56,31 +78,25 @@
href: docs-authoring/jupyter-notebooks.md
- name: Documentation set-specific guidance
items:
- name: .NET docs
items:
- name: How to contribute
href: dotnet/dotnet-contribute.md
- name: Labels, projects, and milestones roadmap
href: dotnet/labels-projects.md
- name: Style conventions
href: dotnet/dotnet-style-guide.md
- name: Voice and tone guide
href: dotnet/dotnet-voice-tone.md
- name: API reference guidelines
href: dotnet/api-documentation.md
- name: Pull request review process
href: dotnet/dotnet-pr-review.md
- name: Code analysis docs
href: dotnet/dotnet-contribute-code-analysis.md
- name: .NET naming in docs
href: dotnet/net-core-5-naming.md
- name: Patterns and Practices (AAC, WAF, CAF)
href: architecture-center/aac-contribute.md
- name: PowerShell-Docs
href: powershell-overview.md
- name: Create and manage Collections
href: collections.md
- name: Hacktoberfest
href: hacktoberfest.md
- name: Additional resources
href: additional-resources.md
- name: .NET docs
items:
- name: How to contribute
href: dotnet/dotnet-contribute.md
- name: Labels, projects, and milestones roadmap
href: dotnet/labels-projects.md
- name: Style conventions
href: dotnet/dotnet-style-guide.md
- name: Voice and tone guide
href: dotnet/dotnet-voice-tone.md
- name: API reference guidelines
href: dotnet/api-documentation.md
- name: Pull request review process
href: dotnet/dotnet-pr-review.md
- name: Code analysis docs
href: dotnet/dotnet-contribute-code-analysis.md
- name: .NET naming in docs
href: dotnet/net-core-5-naming.md
- name: Patterns and Practices (AAC, WAF, CAF)
href: architecture-center/aac-contribute.md
- name: PowerShell-Docs
href: powershell-overview.md
31 changes: 0 additions & 31 deletions Contribute/content/additional-resources.md

This file was deleted.

24 changes: 0 additions & 24 deletions Contribute/content/get-started-setup-github.md

This file was deleted.

Loading