aboutsummaryrefslogtreecommitdiffhomepage
path: root/tensorflow/docs_src
diff options
context:
space:
mode:
authorGravatar Mark Daoust <markdaoust@google.com>2018-08-07 16:41:12 -0700
committerGravatar TensorFlower Gardener <gardener@tensorflow.org>2018-08-07 16:47:22 -0700
commit6f07c3f37425ca0f893cd7f2f457830662ffed02 (patch)
tree33f64db93a7d64d77809a374f4d1523729526d64 /tensorflow/docs_src
parentef2bd57e75d829a921e9045851c53bcecf441d08 (diff)
"All_files" is no longer necessary (ref: cl/190878279)
`layers` subclassing instructions are out of date. PiperOrigin-RevId: 207802618
Diffstat (limited to 'tensorflow/docs_src')
-rw-r--r--tensorflow/docs_src/community/style_guide.md58
1 files changed, 5 insertions, 53 deletions
diff --git a/tensorflow/docs_src/community/style_guide.md b/tensorflow/docs_src/community/style_guide.md
index c9268790a7..daf0d2fdc0 100644
--- a/tensorflow/docs_src/community/style_guide.md
+++ b/tensorflow/docs_src/community/style_guide.md
@@ -47,27 +47,7 @@ licenses(["notice"]) # Apache 2.0
exports_files(["LICENSE"])
```
-* At the end of every BUILD file, should contain:
-```
-filegroup(
- name = "all_files",
- srcs = glob(
- ["**/*"],
- exclude = [
- "**/METADATA",
- "**/OWNERS",
- ],
- ),
- visibility = ["//tensorflow:__subpackages__"],
-)
-```
-
-* When adding new BUILD file, add this line to `tensorflow/BUILD` file into `all_opensource_files` target.
-
-```
-"//tensorflow/<directory>:all_files",
-```
* For all Python BUILD targets (libraries and tests) add next line:
@@ -80,6 +60,9 @@ srcs_version = "PY2AND3",
* Operations that deal with batches may assume that the first dimension of a Tensor is the batch dimension.
+* In most models the *last dimension* is the number of channels.
+
+* Dimensions excluding the first and last usually make up the "space" dimensions: Sequence-length or Image-size.
## Python operations
@@ -148,37 +131,6 @@ Usage:
## Layers
-A *Layer* is a Python operation that combines variable creation and/or one or many
-other graph operations. Follow the same requirements as for regular Python
-operation.
-
-* If a layer creates one or more variables, the layer function
- should take next arguments also following order:
- - `initializers`: Optionally allow to specify initializers for the variables.
- - `regularizers`: Optionally allow to specify regularizers for the variables.
- - `trainable`: which control if their variables are trainable or not.
- - `scope`: `VariableScope` object that variable will be put under.
- - `reuse`: `bool` indicator if the variable should be reused if
- it's present in the scope.
-
-* Layers that behave differently during training should take:
- - `is_training`: `bool` indicator to conditionally choose different
- computation paths (e.g. using `tf.cond`) during execution.
-
-Example:
-
- def conv2d(inputs,
- num_filters_out,
- kernel_size,
- stride=1,
- padding='SAME',
- activation_fn=tf.nn.relu,
- normalization_fn=add_bias,
- normalization_params=None,
- initializers=None,
- regularizers=None,
- trainable=True,
- scope=None,
- reuse=None):
- ... see implementation at tensorflow/contrib/layers/python/layers/layers.py ...
+Use `tf.keras.layers`, not `tf.layers`.
+See `tf.keras.layers` and [the Keras guide](../guide/keras.md#custom_layers) for details on how to sub-class layers.