| route-pattern | /_view_fragments/voltron/pull_requests/show/:user_id/:repository/:id/pull_request_layout(.:format) |
| route-controller | voltron_pull_requests_fragments |
| route-action | pull_request_layout |
| fetch-nonce | v2:11f6b1f6-6a69-b803-3fdb-2fa7fb001cf7 |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | EE40:9609B:14E4106:1E3AC53:6A4CE1A7 |
| html-safe-nonce | ac89f1cc2d4d6bbe717200b5df3262c998818f57507d1d4d685772a413c7c9f9 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFRTQwOjk2MDlCOjE0RTQxMDY6MUUzQUM1Mzo2QTRDRTFBNyIsInZpc2l0b3JfaWQiOiIyNzM1MTAzNzEwNjY5MzY1NjcxIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 89414ee38b6cceffeee571a03d3f5758d178dca7be21ce315923feb33db00ee3 |
| hovercard-subject-tag | pull_request:3455109177 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | ///voltron/pull_requests_fragments/pull_request_layout |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/voltron/pull_requests/show/usethis-python/usethis-python/1582/pull_request_layout |
| twitter:image | https://opengraph.githubassets.com/13866a35001312c369812fe75ea695416a6f5f51d1fc48cfac1c0db64aa596a3/usethis-python/usethis-python/pull/1582 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/13866a35001312c369812fe75ea695416a6f5f51d1fc48cfac1c0db64aa596a3/usethis-python/usethis-python/pull/1582 |
| og:image:alt | The distinction between ToolSpec and Tool was undocumented, leading to confusion about where new methods belong.
Changes
Class docstrings on ToolSpec and Tool: ToolSpec = factual, non-opinionated,... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | Copilot |
| hostname | github.com |
| expected-hostname | github.com |
| None | 299b43bca6e02ad35197ffeba30d2466846d5fb02ab96fbced5b5e6cec589fb8 |
| turbo-cache-control | no-cache |
| go-import | github.com/usethis-python/usethis-python git https://github.com/usethis-python/usethis-python.git |
| octolytics-dimension-user_id | 216362695 |
| octolytics-dimension-user_login | usethis-python |
| octolytics-dimension-repository_id | 842189705 |
| octolytics-dimension-repository_nwo | usethis-python/usethis-python |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 842189705 |
| octolytics-dimension-repository_network_root_nwo | usethis-python/usethis-python |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | c5a57f04eeb310f57c73fd6d751d957e2ca27ed2 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| Skip to content | https://github.com/usethis-python/usethis-python/pull/1582#start-of-content |
|
| https://github.com/ |
|
Sign in
| https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fusethis-python%2Fusethis-python%2Fpull%2F1582 |
| GitHub CopilotWrite better code with AI | https://github.com/features/copilot |
| GitHub Copilot appDirect agents from issue to merge | https://github.com/features/ai/github-app |
| MCP RegistryNewIntegrate external tools | https://github.com/mcp |
| ActionsAutomate any workflow | https://github.com/features/actions |
| CodespacesInstant dev environments | https://github.com/features/codespaces |
| IssuesPlan and track work | https://github.com/features/issues |
| Code ReviewManage code changes | https://github.com/features/code-review |
| GitHub Advanced SecurityFind and fix vulnerabilities | https://github.com/security/advanced-security |
| Code securitySecure your code as you build | https://github.com/security/advanced-security/code-security |
| Secret protectionStop leaks before they start | https://github.com/security/advanced-security/secret-protection |
| Why GitHub | https://github.com/why-github |
| Documentation | https://docs.github.com |
| Blog | https://github.blog |
| Changelog | https://github.blog/changelog |
| Marketplace | https://github.com/marketplace |
| View all features | https://github.com/features |
| Enterprises | https://github.com/enterprise |
| Small and medium teams | https://github.com/team |
| Startups | https://github.com/enterprise/startups |
| Nonprofits | https://github.com/solutions/industry/nonprofits |
| App Modernization | https://github.com/solutions/use-case/app-modernization |
| DevSecOps | https://github.com/solutions/use-case/devsecops |
| DevOps | https://github.com/solutions/use-case/devops |
| CI/CD | https://github.com/solutions/use-case/ci-cd |
| View all use cases | https://github.com/solutions/use-case |
| Healthcare | https://github.com/solutions/industry/healthcare |
| Financial services | https://github.com/solutions/industry/financial-services |
| Manufacturing | https://github.com/solutions/industry/manufacturing |
| Government | https://github.com/solutions/industry/government |
| View all industries | https://github.com/solutions/industry |
| View all solutions | https://github.com/solutions |
| AI | https://github.com/resources/articles?topic=ai |
| Software Development | https://github.com/resources/articles?topic=software-development |
| DevOps | https://github.com/resources/articles?topic=devops |
| Security | https://github.com/resources/articles?topic=security |
| View all topics | https://github.com/resources/articles |
| Customer stories | https://github.com/customer-stories |
| Events & webinars | https://github.com/resources/events |
| Ebooks & reports | https://github.com/resources/whitepapers |
| Business insights | https://github.com/solutions/executive-insights |
| GitHub Skills | https://skills.github.com |
| Documentation | https://docs.github.com |
| Customer support | https://support.github.com |
| Community forum | https://github.com/orgs/community/discussions |
| Trust center | https://github.com/trust-center |
| Partners | https://github.com/partners |
| View all resources | https://github.com/resources |
| GitHub SponsorsFund open source developers | https://github.com/sponsors |
| Security Lab | https://securitylab.github.com |
| Maintainer Community | https://maintainers.github.com |
| Accelerator | https://github.com/accelerator |
| GitHub Stars | https://stars.github.com |
| Archive Program | https://archiveprogram.github.com |
| Topics | https://github.com/topics |
| Trending | https://github.com/trending |
| Collections | https://github.com/collections |
| Enterprise platformAI-powered developer platform | https://github.com/enterprise |
| GitHub Advanced SecurityEnterprise-grade security features | https://github.com/security/advanced-security |
| Copilot for BusinessEnterprise-grade AI features | https://github.com/features/copilot/copilot-business |
| Premium SupportEnterprise-grade 24/7 support | https://github.com/premium-support |
| Pricing | https://github.com/pricing |
| Search syntax tips | https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax |
| documentation | https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax |
|
Sign in
| https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fusethis-python%2Fusethis-python%2Fpull%2F1582 |
|
Sign up
| https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fpull_requests_fragments%2Fpull_request_layout&source=header-repo&source_repo=usethis-python%2Fusethis-python |
| Reload | https://github.com/usethis-python/usethis-python/pull/1582 |
| Reload | https://github.com/usethis-python/usethis-python/pull/1582 |
| Reload | https://github.com/usethis-python/usethis-python/pull/1582 |
| Please reload this page | https://github.com/usethis-python/usethis-python/pull/1582 |
|
usethis-python
| https://github.com/usethis-python |
| usethis-python | https://github.com/usethis-python/usethis-python |
|
Notifications
| https://github.com/login?return_to=%2Fusethis-python%2Fusethis-python |
|
Fork
5
| https://github.com/login?return_to=%2Fusethis-python%2Fusethis-python |
|
Star
19
| https://github.com/login?return_to=%2Fusethis-python%2Fusethis-python |
|
Code
| https://github.com/usethis-python/usethis-python |
|
Issues
163
| https://github.com/usethis-python/usethis-python/issues |
|
Pull requests
4
| https://github.com/usethis-python/usethis-python/pulls |
|
Actions
| https://github.com/usethis-python/usethis-python/actions |
|
Security and quality
0
| https://github.com/usethis-python/usethis-python/security |
|
Insights
| https://github.com/usethis-python/usethis-python/pulse |
|
Code
| https://github.com/usethis-python/usethis-python |
|
Issues
| https://github.com/usethis-python/usethis-python/issues |
|
Pull requests
| https://github.com/usethis-python/usethis-python/pulls |
|
Actions
| https://github.com/usethis-python/usethis-python/actions |
|
Security and quality
| https://github.com/usethis-python/usethis-python/security |
|
Insights
| https://github.com/usethis-python/usethis-python/pulse |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| Copilot | https://github.com/apps/copilot-swe-agent |
| main | https://github.com/usethis-python/usethis-python/tree/main |
| copilot/improve-docstrings-tool-toolspec | https://github.com/usethis-python/usethis-python/tree/copilot/improve-docstrings-tool-toolspec |
| Conversation | https://github.com/usethis-python/usethis-python/pull/1582 |
| Commits2 (2) | https://github.com/usethis-python/usethis-python/pull/1582/commits |
| Checks | https://github.com/usethis-python/usethis-python/pull/1582/checks |
| Files changed | https://github.com/usethis-python/usethis-python/pull/1582/files |
| Improve docstrings for Tool and ToolSpec | https://github.com/usethis-python/usethis-python/pull/1582#top |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| Copilot | https://github.com/apps/copilot-swe-agent |
| main | https://github.com/usethis-python/usethis-python/tree/main |
| copilot/improve-docstrings-tool-toolspec | https://github.com/usethis-python/usethis-python/tree/copilot/improve-docstrings-tool-toolspec |
|
| https://github.com/apps/copilot-swe-agent |
| Copilot | https://github.com/apps/copilot-swe-agent |
| Mar 27, 2026 | https://github.com/usethis-python/usethis-python/pull/1582#issue-4149333842 |
| Please reload this page | https://github.com/usethis-python/usethis-python/pull/1582 |
| Raycast | https://gh.io/cca-raycast-docs |
| Please reload this page | https://github.com/usethis-python/usethis-python/pull/1582 |
|
| https://github.com/apps/copilot-swe-agent |
| Initial plan | https://github.com/usethis-python/usethis-python/pull/1582/commits/eb00a52ff0ac3d21c2b8cccad4ba2593e39ae5ea |
| eb00a52 | https://github.com/usethis-python/usethis-python/pull/1582/commits/eb00a52ff0ac3d21c2b8cccad4ba2593e39ae5ea |
|
| https://github.com/apps/copilot-swe-agent |
| Copilot | https://github.com/apps/copilot-swe-agent |
| Copilot | https://github.com/apps/copilot-swe-agent |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| Mar 27, 2026 | https://github.com/usethis-python/usethis-python/pull/1582#event-23959516832 |
| started work | https://github.com/usethis-python/usethis-python/sessions/c531fdc1-bb25-4d66-a6fd-4d71b150e9f8 |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| March 27, 2026 04:54 | https://github.com/usethis-python/usethis-python/pull/1582#event-23959517870 |
|
View session
| https://github.com/usethis-python/usethis-python/sessions/c531fdc1-bb25-4d66-a6fd-4d71b150e9f8 |
|
| https://github.com/apps/copilot-swe-agent |
|
| https://github.com/nathanjmcdougall |
| Improve docstrings for Tool and ToolSpec classes | https://github.com/usethis-python/usethis-python/pull/1582/commits/63350e6f40776627144558f66a4d4c3d64c51be8 |
| 63350e6 | https://github.com/usethis-python/usethis-python/pull/1582/commits/63350e6f40776627144558f66a4d4c3d64c51be8 |
| https://github.com/usethis-python/usethis-python/sessions/c531fdc1-bb25-4d66-a6fd-4d71b150e9f8 | https://github.com/usethis-python/usethis-python/sessions/c531fdc1-bb25-4d66-a6fd-4d71b150e9f8 |
|
| https://github.com/apps/copilot-swe-agent |
| Copilot | https://github.com/apps/copilot-swe-agent |
| Mar 27, 2026 | https://github.com/usethis-python/usethis-python/pull/1582#event-23959673007 |
| finished work | https://github.com/usethis-python/usethis-python/sessions/c531fdc1-bb25-4d66-a6fd-4d71b150e9f8 |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| March 27, 2026 05:03 | https://github.com/usethis-python/usethis-python/pull/1582#event-23959676001 |
|
| https://github.com/apps/copilot-swe-agent |
| Copilot | https://github.com/apps/copilot-swe-agent |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| March 27, 2026 05:03 | https://github.com/usethis-python/usethis-python/pull/1582#event-23959676034 |
| https://github.com/nathanjmcdougall |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| Mar 27, 2026 | https://github.com/usethis-python/usethis-python/pull/1582#issuecomment-4141107914 |
| Please reload this page | https://github.com/usethis-python/usethis-python/pull/1582 |
| https://github.com/nathanjmcdougall |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| Mar 27, 2026 | https://github.com/usethis-python/usethis-python/pull/1582#event-23964600647 |
| https://github.com/nathanjmcdougall |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
| Mar 27, 2026 | https://github.com/usethis-python/usethis-python/pull/1582#event-23964610722 |
|
Improve docstrings for Tool and ToolSpec
#1434
| https://github.com/usethis-python/usethis-python/issues/1434 |
| https://github.com/nathanjmcdougall |
| nathanjmcdougall | https://github.com/nathanjmcdougall |
|
Mar 27, 2026
| https://github.com/usethis-python/usethis-python/pull/1582#ref-issue-4109952084 |
|
Improve docstrings for Tool and ToolSpec
#1434
| https://github.com/usethis-python/usethis-python/issues/1434 |
| https://github.co/hiddenchars |
| https://github.com/usethis-python/usethis-python/pull/{{ revealButtonHref }} |
| Sign up for free | https://github.com/join?source=comment-repo |
| Sign in to comment | https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fusethis-python%2Fusethis-python%2Fpull%2F1582 |
|
| https://github.com/nathanjmcdougall |
|
nathanjmcdougall
| https://github.com/nathanjmcdougall |
|
| https://github.com/nathanjmcdougall |
|
nathanjmcdougall
| https://github.com/nathanjmcdougall |
|
Copilot code review
| https://github.com/apps/copilot-swe-agent |
|
Copilot
| https://github.com/apps/copilot-swe-agent |
|
Improve docstrings for Tool and ToolSpec
| https://github.com/usethis-python/usethis-python/issues/1434 |
| Please reload this page | https://github.com/usethis-python/usethis-python/pull/1582 |
|
| https://github.com/apps/copilot-swe-agent |
|
| https://github.com/nathanjmcdougall |
|
| https://github.com |
| Terms | https://docs.github.com/site-policy/github-terms/github-terms-of-service |
| Privacy | https://docs.github.com/site-policy/privacy-policies/github-privacy-statement |
| Security | https://github.com/security |
| Status | https://www.githubstatus.com/ |
| Community | https://github.community/ |
| Docs | https://docs.github.com/ |
| Contact | https://support.github.com?tags=dotcom-footer |