Explain declare global details | Feature: #3409

[ishantmishra03]

docs: add detailed explanation of declare global statement ( #3409 )

Related Issue

Addresses the need for clearer explanation of declare global as noted in discussion (e.g., #3409)

Summary

This PR adds a dedicated section to the "By Example" declaration files documentation explaining:

• What declare global does
• Why it is necessary inside modules
• When and how to use it for global augmentation
• Importance of marking the file as a module with export {}

This clarifies a common confusion point for TypeScript declaration authors.

Changes

• Added a new section after "Global Functions" titled The declare global Statement
• Included example code and detailed explanation
• Added links to official handbook references

Updated :

Notes
-- This change is documentation-only and has no impact on runtime behavior.

[ishantmishra03]

@microsoft-github-policy-service agree