writing-docs

النتيجة المتوقعة:

/**
* Calculates the discounted price by applying a percentage discount.
*
* @param {number} price - The original price before discount
* @param {number} percentage - The discount percentage (0-100)
* @returns {number} The final price after applying the discount
*
* @example
* // Calculate 20% off $100
* const finalPrice = calculateDiscount(100, 20);
* // Returns: 80
*
* @example
* // Calculate 15% off $50.99
* const finalPrice = calculateDiscount(50.99, 15);
* // Returns: 43.3415
*/

النتيجة المتوقعة:

• # Weather API Wrapper
• A simple, lightweight JavaScript wrapper for popular weather APIs with built-in caching and error handling.
•  
• ## Features
• - Support for multiple weather providers (OpenWeather, WeatherAPI)
• - Built-in response caching to reduce API calls
• - TypeScript support with full type definitions
• - Promise-based async API with error handling
•  
• ## Installation
• ```bash
• npm install weather-api-wrapper
• ```
•  
• ## Quick Start
• ```javascript
• import WeatherAPI from 'weather-api-wrapper';
•  
• const weather = new WeatherAPI({ apiKey: 'your-key' });
• const forecast = await weather.getForecast('London');
• console.log(forecast.temperature);
• ```