Improving documentation in Math.swift tensorflow#160 (tensorflow#269)

* Improving documentation in Math.swift tensorflow#160

* Sign doc update

Author: Shashi456

Sources/TensorFlow/Operators/Math.swift

@@ -576,7 +576,7 @@ func _vjpLog1p<T: TensorFlowFloatingPoint>(
     (log1p(x), { v in Raw.xdivy(v, 1 + x) })
 }
 
-/// Returns `sin` of the specified tensor element-wise.
+/// Returns the sine of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpSin(_:))
 public func sin<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -590,7 +590,7 @@ internal func _vjpSin<T: TensorFlowFloatingPoint>(
     (sin(x), { v in v * cos(x) })
 }
 
-/// Returns `cos` of the specified tensor element-wise.
+/// Returns the cosine of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpCos(_:))
 public func cos<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -604,7 +604,7 @@ internal func _vjpCos<T: TensorFlowFloatingPoint>(
     (cos(x), { v in -v * sin(x) })
 }
 
-/// Returns `tan` of the specified tensor element-wise.
+/// Returns the tangent of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpTan(_:))
 public func tan<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -633,7 +633,7 @@ internal func _vjpSinh<T: TensorFlowFloatingPoint>(
     (sinh(x), { v in v * cosh(x) })
 }
 
-/// Returns `cosh` of the specified tensor element-wise.
+/// Returns the hyperbolic cosine of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpCosh(_:))
 public func cosh<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -647,7 +647,7 @@ internal func _vjpCosh<T: TensorFlowFloatingPoint>(
     (cosh(x), { v in v * sinh(x) })
 }
 
-/// Returns `tanh` of the specified tensor element-wise.
+/// Returns the hyperbolic tangent of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpTanh(_:))
 public func tanh<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -662,7 +662,7 @@ internal func _vjpTanh<T: TensorFlowFloatingPoint>(
     return (value, { v in v * (1 - value.squared()) })
 }
 
-/// Returns `acos` of the specified tensor element-wise.
+/// Returns the inverse cosine of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpAcos(_:))
 public func acos<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -676,7 +676,7 @@ internal func _vjpAcos<T: TensorFlowFloatingPoint>(
     (acos(x), { v in -v / sqrt(1 - x.squared()) })
 }
 
-/// Returns `asin` of the specified tensor element-wise.
+/// Returns the inverse sine of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpAsin(_:))
 public func asin<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -690,7 +690,7 @@ internal func _vjpAsin<T: TensorFlowFloatingPoint>(
     (asin(x), { v in v / sqrt(1 - x.squared()) })
 }
 
-/// Returns `atan` of the specified tensor element-wise.
+/// Returns the inverse tangent of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpAtan(_:))
 public func atan<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -704,7 +704,7 @@ internal func _vjpAtan<T: TensorFlowFloatingPoint>(
     (atan(x), { v in v / (1 + x.squared()) })
 }
 
-/// Returns `acosh` of the specified tensor element-wise.
+/// Returns the inverse hyperbolic cosine of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpAcosh(_:))
 public func acosh<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -718,7 +718,7 @@ internal func _vjpAcosh<T: TensorFlowFloatingPoint>(
     (acosh(x), { v in v / asinh(x) })
 }
 
-/// Returns `asinh` of the specified tensor element-wise.
+/// Returns the inverse hyperbolic sine of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpAsinh(_:))
 public func asinh<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -732,7 +732,7 @@ internal func _vjpAsinh<T: TensorFlowFloatingPoint>(
     (asinh(x), { v in v / acosh(x) })
 }
 
-/// Returns `atanh` of the specified tensor element-wise.
+/// Returns the inverse hyperbolic tangent of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpAtanh(_:))
 public func atanh<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -809,7 +809,7 @@ internal func _vjpRsqrt<T: TensorFlowFloatingPoint>(
     return (value, { v in -v / (2 * pow(x, 3 / 2)) })
 }
 
-/// Returns `exp` of the specified tensor element-wise.
+/// Returns the exponential of the specified tensor element-wise.
 @inlinable
 @differentiable(vjp: _vjpExp(_:))
 public func exp<T: TensorFlowFloatingPoint>(_ x: Tensor<T>) -> Tensor<T> {
@@ -895,6 +895,8 @@ internal func _vjpFloor<T: TensorFlowFloatingPoint>(
     (floor(x), { _ in Tensor(0).broadcasted(like: x) })
 }
 
+/// Returns an indication of the sign of the specified tensor element-wise.
+/// Specifically, computes `y = sign(x) = -1` if `x < 0`; 0 if `x == 0`; 1 if `x > 0`.
 @inlinable
 @differentiable(vjp: _vjpSign(_:) where T: TensorFlowFloatingPoint)
 public func sign<T: Numeric>(_ x: Tensor<T>) -> Tensor<T> {
@@ -1036,7 +1038,7 @@ func _vjpLeakyRelu<T: TensorFlowFloatingPoint>(
     })
 }
 
-/// Returns `relu` of the specified tensor element-wise.
+/// Returns a tensor by applying the ReLU activation function to the specified tensor element-wise.
 /// Specifically, computes `max(0, x)`.
 @inlinable
 @differentiable(vjp: _vjpRelu(_:))