Skip to content

docs: add source file basics guidance - #193

Open
ogormans-deptstack wants to merge 1 commit into
mongodb:masterfrom
ogormans-deptstack:docs-meta-88-basics
Open

docs: add source file basics guidance#193
ogormans-deptstack wants to merge 1 commit into
mongodb:masterfrom
ogormans-deptstack:docs-meta-88-basics

Conversation

@ogormans-deptstack

@ogormans-deptstack ogormans-deptstack commented Jul 29, 2026

Copy link
Copy Markdown

Jira

N/A (external contribution)

Summary

This PR adds docs-as-code source file basics guidance as a modernization follow-up in the same area where legacy build-toolchain instructions were removed in #192.

Changes

  • Add source/style-guide/style/source-file-basics.txt
  • Link the new page from source/style-guide/style/index.txt
  • Document baseline conventions for:
    • character set (UTF-8)
    • line length (hard wrap 72-80 with practical exceptions)
    • line endings (LF)
    • tabs and indentation (spaces; no tabs)
    • naming conventions
    • Snooty VS Code extension usage

Why this helps modernization

PR #192 removed outdated Giza/Sphinx install guidance. This PR complements that cleanup by providing a concise, toolchain-agnostic baseline for contributors editing source files in current docs workflows.

Validation / checks context

From current docs-meta PR checks, this change is expected to go through:

  • Analyze (python)
  • CodeQL
  • semgrep-cloud-platform/scan
  • netlify deploy preview + Header rules / Pages changed / Redirect rules

Refs #88

Add source-file basics guidance covering character set, line length, line endings, tabs/indentation, naming conventions, and Snooty usage.

Refs mongodb#88

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@netlify

netlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

👷 Deploy request for mongodb-docs-meta pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 59fa255

@ogormans-deptstack ogormans-deptstack mentioned this pull request Jul 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant