search

npm / documentation

Documentation for the npm registry, website, and command-line interface.
https://docs.npmjs.com/
Creative Commons Attribution 4.0 International
414 stars 2.86k forks source link

Update about-access-tokens.mdx #1345

Closed DelushaanM closed 1 month ago

DelushaanM commented 1 month ago

This change improves the structure, clarity, and readability of the "About Access Tokens" document. The key updates include:

Improved Flow: The document's flow has been enhanced to provide a more logical progression, making it easier for readers to understand the concepts of access tokens and their use cases. Simplified Language: Complex technical terms and lengthy sentences were simplified to make the content more accessible to users of varying technical skill levels. Clearer Token Descriptions: The differences between legacy tokens and granular tokens were clarified, with added emphasis on security recommendations. Enhanced Readability: Content sections were reorganized for better readability, especially the token types and their use cases. Consistent Formatting: A consistent and cleaner formatting style was applied to improve the overall look of the document. The purpose of these changes is to make the document easier to understand and use, while retaining all necessary technical details.

References

kenshanta commented 1 month ago

The format and explanation was more readable before. IMO keeping the original format and updating the content only would be a better approach.

leobalter commented 1 month ago

This looks like AI generated content only. @DelushaanM I'm not sure what goal is this trying to resolve but I'd prefer if we go on a step to improve this docs.