Revise .round() function documentation

Updated the documentation for the .round() function in PyTorch to clarify its behavior and parameters.

Author: mamtawardhani

content/pytorch/concepts/tensor-operations/terms/round/round.md

@@ -1,45 +1,66 @@
 ---
-Title: 'round.()'
+Title: '.round()'
 Description: 'Rounds each element to the nearest integer or specified number of decimals.'
 Subjects:
   - 'Computer Science'
   - 'Machine Learning'
   - 'Data Science'
 Tags:
-  - 'Round'
+  - 'Integers'
   - 'Python'
   - 'Tensor'
-  - 'Computer Science'
 CatalogContent:
   - 'intro-to-py-torch-and-neural-networks'
   - 'paths/computer-science'
-  - 'paths/machine-learning'
-  - 'paths/data-science'
 ---
 
-In PyTorch, the **`.round`** function returns a new [tensor](https://docs.pytorch.org/docs/stable/generated/torch.round.html#torch.round) rounded to the nearest integer.
+In PyTorch, the **`.round()`** function returns a new [tensor](https://docs.pytorch.org/docs/stable/generated/torch.round.html#torch.round) with each element rounded to the nearest integer or to a specified number of decimal places. Values exactly halfway between two integers follow “round half to even,” also known as banker's rounding.
 
 ## Syntax
 
+```pseudo
+torch.round(input, *, decimals=0, out=None)
 ```
-torch.round(input, decimals=0)
-```
 
-- `input`: (tensor) the input tensor to be rounded.
-- `decimals`: (int) Number of decimal places to round to (default: 0). If decimals is negative, it specifies the number of positions to the left of the decimal point.
+**Parameters:**
+
+- `input` (tensor): The input tensor to be rounded.
+- `decimals` (int, optional): Number of decimal places to round to.
+  - Positive values round to the right of the decimal.
+  - Negative values round to the left of the decimal.
+  - Default is 0.
+- `out` (Tensor, optional): A tensor to store the result.
+
+**Return value:**
+
+Returns a tensor containing the rounded values. If `out` is provided, the result is written into it and returned.
+
+## Example
 
-## Examples
+In this example:
 
-```python
-torch.round(torch.tensor((4.7, -2.3, 9.1, -7.7)))
+In this example, `.round()` is used with default rounding, half-even rounding, and rounding with positive and negative decimal values:
 
-# Values equidistant from two integers are rounded towards the
-# the nearest even value (zero is treated as even)
-torch.round(torch.tensor([-0.5, 0.5, 1.5, 2.5]))
+```py
+import torch
+
+print(torch.round(torch.tensor([4.7, -2.3, 9.1, -7.7])))
+
+# Halfway values follow round-half-to-even
+print(torch.round(torch.tensor([-0.5, 0.5, 1.5, 2.5])))
+
+# Rounding to a specific number of decimal places
+print(torch.round(torch.tensor([0.1234567]), decimals=3))
+
+# Rounding to the left of the decimal
+print(torch.round(torch.tensor([1200.1234567]), decimals=-3))
+```
 
-# A positive decimals argument rounds to the to that decimal place
-torch.round(torch.tensor([0.1234567]), decimals=3)
+The output of this code is:
 
-# A negative decimals argument rounds to the left of the decimal
-torch.round(torch.tensor([1200.1234567]), decimals=-3)
+```shell
+tensor([ 5., -2.,  9., -8.])
+tensor([-0., 0., 2., 2.])
+tensor([0.1230])
+tensor([1000.])
 ```