docs: improve ticks function return value documentation

[Caplost]

Description

Improve the documentation format for the ticks() function in IUniswapV3PoolState.sol. This change enhances readability and maintains consistency with Solidity documentation standards.

Changes

• Add proper @return tags for each return parameter
• Capitalize first letter of each return description
• Remove unnecessary commas and line breaks
• Maintain all technical details while improving readability
• Keep consistent documentation format across the interface

Before

/// @return liquidityGross the total amount of position liquidity that uses the pool either as tick lower or
/// tick upper,
/// liquidityNet how much liquidity changes when the pool price crosses the tick,
/// feeGrowthOutside0X128 the fee growth on the other side of the tick from the current tick in token0,
/// feeGrowthOutside1X128 the fee growth on the other side of the tick from the current tick in token1,
/// tickCumulativeOutside the cumulative tick value on the other side of the tick from the current tick
/// secondsPerLiquidityOutsideX128 the seconds spent per liquidity on the other side of the tick from the current tick,
/// secondsOutside the seconds spent on the other side of the tick from the current tick,
/// initialized Set to true if the tick is initialized, i.e. liquidityGross is greater than 0, otherwise equal to false.

After

/// @return liquidityGross The total amount of position liquidity that uses the pool either as tick lower or tick upper
/// @return liquidityNet How much liquidity changes when the pool price crosses the tick
/// @return feeGrowthOutside0X128 The fee growth on the other side of the tick from the current tick in token0
/// @return feeGrowthOutside1X128 The fee growth on the other side of the tick from the current tick in token1
/// @return tickCumulativeOutside The cumulative tick value on the other side of the tick from the current tick
/// @return secondsPerLiquidityOutsideX128 The seconds spent per liquidity on the other side of the tick from the current tick
/// @return secondsOutside The seconds spent on the other side of the tick from the current tick
/// @return initialized Set to true if the tick is initialized, i.e. liquidityGross is greater than 0, otherwise equal to false

Type of change

Documentation update (non-breaking change)

Checklist

• Documentation update only
• No code changes
• No breaking changes
• Improves readability while maintaining technical accuracy