Skip to content

docs: use parentheses for callable names in prose (DOCS-1362)#2327

Open
johndmulhausen wants to merge 21 commits intomainfrom
functions-should-have-parentheses
Open

docs: use parentheses for callable names in prose (DOCS-1362)#2327
johndmulhausen wants to merge 21 commits intomainfrom
functions-should-have-parentheses

Conversation

@johndmulhausen
Copy link
Copy Markdown
Contributor

Summary

Aligns English documentation with the convention that functions and methods are written with trailing () when mentioned in prose (not inside code samples), for example wandb.init() and run.log().

Changes

  • Edits across models, platform, release-notes, weave (English only; ja/, ko/, and support/ were not included).
  • AGENTS.md: adds a style bullet and links to the Global Functions overview.
  • Small follow-ups: wandb.controller() link text, wandb.restore() in a few historical release-note bullets, and backtick cleanup in ref prose where wandb.init() appeared without code formatting.

Issue

Resolves DOCS-1362

Made with Cursor

- Update English docs and release notes so functions and methods are written as `wandb.init()`, `run.log()`, and similar in running text (outside code fences).
- Document the convention and link to Global Functions overview in AGENTS.md.
- Normalize `wandb.controller()` link text and a few `wandb.restore()` release note lines.

Resolves DOCS-1362

Made-with: Cursor
@johndmulhausen johndmulhausen requested a review from a team as a code owner March 20, 2026 18:03
@mintlify
Copy link
Copy Markdown
Contributor

mintlify bot commented Mar 20, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview Mar 20, 2026, 6:05 PM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 20, 2026

📚 Mintlify Preview Links

🔗 View Full Preview

📝 Changed (48 total)

📄 Pages (48)

File Preview
AGENTS.md AGENTS
models/artifacts/create-a-new-artifact-version.mdx Create A New Artifact Version
models/artifacts/storage.mdx Storage
models/integrations/accelerate.mdx Accelerate
models/integrations/add-wandb-to-any-library.mdx Add Wandb To Any Library
models/integrations/farama-gymnasium.mdx Farama Gymnasium
models/integrations/fastai.mdx Fastai
models/integrations/huggingface_transformers.mdx Huggingface Transformers
models/integrations/kubeflow-pipelines-kfp.mdx Kubeflow Pipelines Kfp
models/integrations/lightning.mdx Lightning
... and 38 more files

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 1b6c668 at 2026-03-23 16:34:57 UTC

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 20, 2026

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-functions-should-have-parentheses.mintlify.app

- Added .env to .gitignore to prevent environment variable files from being tracked.
- Corrected function name references in documentation from `wandb.log_artifacts` to `wandb.log_artifact()` for consistency and clarity.
- Updated documentation to ensure consistency by adding parentheses to function calls, such as `run.finish_artifact()`, `wandb.tensorboard.patch()`, and `weave.init()`.
- Improved clarity in various sections by correcting function references to match the standard format.
- Updated documentation to ensure consistency by adding parentheses to function calls, such as `wandb.log()`, `weave.init()`, and various other method references across different integration guides.
- Improved clarity and uniformity in the documentation for better readability and understanding.
@ngrayluna
Copy link
Copy Markdown
Contributor

Summoning @dbrian57 to verify Weave-related methods, etc.

johndmulhausen and others added 5 commits March 23, 2026 12:24
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
johndmulhausen and others added 2 commits March 23, 2026 12:25
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
johndmulhausen and others added 2 commits March 23, 2026 12:26
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
Co-authored-by: Noah Luna <15202580+ngrayluna@users.noreply.github.com>
@johndmulhausen
Copy link
Copy Markdown
Contributor Author

@ngrayluna Would appreciate if you can make the SDK edits. Also, is it wandb.Run.log() or wandb.log()? We definitely have both

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.

2 participants