Add array groupby documentation

[shahzdvp]

Add documentation and example for array.groupBy() method

Description

This pull request adds comprehensive documentation and a practical example for the array.groupBy() method in JavaScript. This contribution aims to help developers understand and effectively use this method for grouping array elements.

Changes Made

1. Documentation:

   • Created a new file src/content/docs/02-array/24_array-groupby.md
   • Provided detailed explanation of the array.groupBy() method
   • Included syntax, parameters, return value, and usage examples
   • Added notes on browser compatibility and alternatives

2. Example:

   • Created a new file examples/02-24_array-groupby.mjs
   • Implemented a practical example using a sample inventory dataset
   • Demonstrated grouping of inventory items by their type
   • Added comments explaining each step of the process

Documentation Overview

The documentation covers:

• Introduction to the array.groupBy() method
• Detailed syntax and parameters
• Return value explanation
• Comprehensive description of the method's functionality
• Multiple usage examples
• Notes on compatibility and alternatives
• Related methods for further exploration

Example Overview

The example demonstrates:

• Practical usage of array.groupBy() with an array of objects
• How to define the grouping callback function
• Outputting the grouped result in a readable format
• Extensive comments explaining the code and expected output

Testing and Formatting

• Both the documentation and example have been reviewed for accuracy
• The example has been tested locally and produces the expected output
• Ran bun run format-examples-bun to ensure adherence to project formatting standards

Additional Notes

• This contribution provides a complete learning resource on array.groupBy(), combining theory (documentation) and practice (example)
• The documentation and example are designed to be beginner-friendly while also providing depth for more experienced developers

Checklist

• [x] Documentation follows the project's structure and style guidelines
• [x] Example code follows the project's coding standards
• [x] Comments have been added to explain the example code
• [x] The example has been tested and works as expected
• [x] The format-examples-bun script has been run on the new example file
• [x] Both documentation and example are consistent with each other

I'm open to any feedback or suggestions for improvement on both the documentation and the example. Thank you for reviewing this contribution!

[vercel[bot]]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
some-drops-of-javascript	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Oct 9, 2024 1:35am

[shahzdvp]

here's the updated example, I got a bit confused while committing because I'm still learning Git

[shahzdvp]

is my pr is ok or do i want to make any changes

[roberto-butti]

ehi @shahzdvp your PR is great, i was thinking to move it , from array to object directory, because in the end the groupBy is a method for object. if you feel confident you can do it, otherwise i can merge it and then i can move it

[shahzdvp]

i think there is no object directory ,so i need to create one right..?

[roberto-butti]

i think there is no object directory ,so i need to create one right..?

@shahzdvp i mean this one: https://github.com/roberto-butti/some-drops-of-javascript/tree/main/src/content/docs/03-var