human
Here's a good function header given the following:
I wrote the below code

    def l2_norm(t, eps=1e-12):
        '\n                                Returns:\n                                                tf.Tensor:    norm    of    2D    input    tensor    on    axis    1\n                                '
        with tf.name_scope('l2_norm'):
            return tf.sqrt((tf.reduce_sum(tf.square(t), 1) + eps))
    with tf.name_scope(scope):
        y = ((2 * tf.cast(y, tf.float32)) - 1)
        pred = (tf.reduce_sum((left * right), 1) / ((l2_norm(left) * l2_norm(right)) + 1e-10))
        return (tf.nn.l2_loss((y - pred)) / tf.cast(tf.shape(left)[0], tf.float32))

What's a good function header?
assistant
#Here's a good function header.

def siamese_cosine_loss(left, right, y, scope='cosine_loss'):