System information

• TensorFlow version: 2.0
• Doc Link: https://www.tensorflow.org/versions/r2.0/api_docs/python/tf/math/acos

Describe the documentation issue

Documentation for tf.math.acos is created from a generated file, python/ops/gen_math_ops.py. It would be excellent to have a link to the files that are used to generate gen_math_ops.py - so a user could make modifications quickly, without having to search through tensorflow/tensorflow.

tf.math.acos could use a clear description, usage examples, and example visuals. A great template to model this on could be numpy.arccos.

Users also experience obfuscated errors from unexpected arguments (ex: strings, Booleans, and even just ints). Some examples are shared below. The file used to generate this error is located here. All tf.math.* operations and the operations they influence (e.g., tf.linspace) would experience these same obfuscated XLA errors.

InvalidArgumentError: Invalid cast from floating point type to S32 in ConstantR0WithType.
	 [[{{node Acos}}]] [Op:Acos]

InternalError: Could not find valid device for node.
Node: {{node Acos}}
All kernels registered for op Acos :
  device='XLA_CPU'; T in [DT_FLOAT, DT_DOUBLE, DT_INT32, DT_COMPLEX64, DT_INT64, DT_COMPLEX128, DT_HALF]
  device='XLA_CPU_JIT'; T in [DT_FLOAT, DT_DOUBLE, DT_INT32, DT_COMPLEX64, DT_INT64, DT_COMPLEX128, DT_HALF]
  device='CPU'; T in [DT_DOUBLE]
  device='CPU'; T in [DT_FLOAT]
 [Op:Acos]

We welcome contributions by users. Will you be able to update submit a PR (use the doc style guide) to fix the doc Issue?
I shall certainly try! :)