Merge branch 'master' into master

Author: 8bitmp3

CODEOWNERS

@@ -1,11 +1,11 @@
 # https://help.github.com/articles/about-codeowners/
-# Last matching pattern takes preecedence.
+# Last matching pattern takes precedence.
 
 # Default owners for everything in repo.
-*  @lamberta @MarkDaoust @8bitmp3
+*  @MarkDaoust @8bitmp3
 
 # Docs
-/site/en/guide/keras/ @fchollet @lamberta @MarkDaoust @8bitmp3
+/site/en/guide/keras/ @fchollet @MarkDaoust @8bitmp3
 
 # Community
-/site/en/community/ @ewilderj @lamberta @theadactyl @joanafilipa
+/site/en/community/ @ewilderj @theadactyl @joanafilipa

MANIFEST.in

@@ -1 +1,2 @@
-recursive-include tools/tensorflow_docs/api_generator/gen_java/ *
+recursive-include tools/tensorflow_docs/api_generator/gen_java/ *
+recursive-include tools/tensorflow_docs/api_generator/pretty_docs/templates/ *

OWNERS_METADATA

@@ -21,19 +21,14 @@
 from setuptools import setup
 
 project_name = 'tensorflow-docs'
-version = '0.0.0'
-
-try:
-  version += subprocess.check_output(['git', 'rev-parse',
-                                      'HEAD']).decode('utf-8')
-except subprocess.CalledProcessError:
-  pass
+version = '0.0.0.dev0'
 
 DOCLINES = __doc__.split('\n')
 
 REQUIRED_PKGS = [
     'astor',
     'absl-py',
+    'jinja2',
     'protobuf>=3.14',
     'pyyaml',
 ]

setup.py

@@ -0,0 +1,50 @@
+# TensorFlow docs
+
+These are the source files for the core TensorFlow
+[guide](https://www.tensorflow.org/guide),
+[tutorials](https://www.tensorflow.org/tutorials), and other technical docs.
+Please read the
+[contributor guide](https://www.tensorflow.org/community/contribute)
+to submit patches to the TensorFlow documentation and code.
+
+## TensorFlow ecosystem projects
+
+In addition to the core TensorFlow docs,
+[tensorflow.org](https://www.tensorflow.org) hosts documentation for many
+[libraries and extensions](https://www.tensorflow.org/resources/libraries-extensions).
+These docs are sourced from separate project repos and where pull requests can
+be sent. The following is a list of TensorFlow documentation projects published
+on the website and a link to their source files:
+
+tensorflow.org project | GitHub docs location
+-----------------------|---------------------
+[/addons](https://www.tensorflow.org/addons) | https://github.com/tensorflow/addons/tree/master/docs
+[/agents](https://www.tensorflow.org/agents) | https://github.com/tensorflow/agents/tree/master/docs
+[/cloud](https://www.tensorflow.org/cloud) | https://github.com/tensorflow/cloud/tree/master/g3doc
+[/datasets](https://www.tensorflow.org/datasets) | https://github.com/tensorflow/datasets/tree/master/docs
+[/decision_forests](https://www.tensorflow.org/decision_forests) | https://github.com/tensorflow/decision-forests/tree/main/documentation
+[/federated](https://www.tensorflow.org/federated) | https://github.com/tensorflow/federated/tree/main/docs
+[/graphics](https://www.tensorflow.org/graphics) | https://github.com/tensorflow/graphics/tree/master/tensorflow_graphics/g3doc
+[/hub](https://www.tensorflow.org/hub) | https://github.com/tensorflow/hub/tree/master/docs
+[/io](https://www.tensorflow.org/io) | https://github.com/tensorflow/io/tree/master/docs/
+[/js](https://www.tensorflow.org/js) | https://github.com/tensorflow/tfjs-website/tree/master/docs
+[/jvm](https://www.tensorflow.org/jvm) | https://github.com/tensorflow/java/tree/master/docs
+[/lattice](https://www.tensorflow.org/lattice) | https://github.com/tensorflow/lattice/tree/master/docs
+[/lite](https://www.tensorflow.org/lite) | https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/g3doc
+[/mlir](https://www.tensorflow.org/mlir) | https://github.com/tensorflow/tensorflow/tree/master/tensorflow/compiler/mlir/g3doc
+[/model_optimization](https://www.tensorflow.org/model_optimization) | https://github.com/tensorflow/model-optimization/tree/master/tensorflow_model_optimization/g3doc
+[/neural_structured_learning](https://www.tensorflow.org/neural_structured_learning) | https://github.com/tensorflow/neural-structured-learning/tree/master/g3doc
+[/probability](https://www.tensorflow.org/probability) | https://github.com/tensorflow/probability/tree/main/tensorflow_probability/g3doc
+[/quantum](https://www.tensorflow.org/quantum) | https://github.com/tensorflow/quantum/tree/master/docs
+[/ranking](https://www.tensorflow.org/ranking) | https://github.com/tensorflow/ranking/tree/master/docs
+[/recommenders](https://www.tensorflow.org/recommenders) | https://github.com/tensorflow/recommenders/tree/main/docs
+[/responsible_ai/fairness_indicators](https://www.tensorflow.org/responsible_ai/fairness_indicators/guide) | https://github.com/tensorflow/fairness-indicators/tree/master/g3doc
+[/responsible_ai/model_card_toolkit](https://www.tensorflow.org/responsible_ai/model_card_toolkit/guide) | https://github.com/tensorflow/model-card-toolkit/tree/master/model_card_toolkit/documentation
+[/responsible_ai/model_remediation](https://www.tensorflow.org/responsible_ai/model_remediation) | https://github.com/tensorflow/model-remediation/tree/master/docs
+[/responsible_ai/privacy](https://www.tensorflow.org/responsible_ai/privacy/guide) | https://github.com/tensorflow/privacy/tree/master/g3doc
+[/tensorboard](https://www.tensorflow.org/tensorboard) | https://github.com/tensorflow/tensorboard/tree/master/docs
+[/guide/keras](https://www.tensorflow.org/guide/keras/) | https://github.com/keras-team/keras-io/tree/master/guides
+[/text](https://www.tensorflow.org/text) | https://github.com/tensorflow/text/tree/master/docs
+[/tfx](https://www.tensorflow.org/tfx) | https://github.com/tensorflow/tfx/tree/master/docs
+[/tfx/guide/serving](https://www.tensorflow.org/tfx/guide/serving) | https://github.com/tensorflow/serving/tree/master/tensorflow_serving/g3doc
+[/xla](https://www.tensorflow.org/xla) | https://github.com/tensorflow/tensorflow/tree/master/tensorflow/compiler/xla/g3doc

site/en/README.md

@@ -5,5 +5,3 @@ toc:
       path: /about/
     - label: "Case studies"
       path: /about/case-studies/
-    - label: "AI Service Partners"
-      path: /partners/

site/en/about/_menu_toc.yaml

@@ -24,11 +24,14 @@ To participate in the TensorFlow docs community:
 
 * Watch the [tensorflow/docs](https://github.com/tensorflow/docs) GitHub
   repository.
-* Subscribe to [[email protected]](https://groups.google.com/a/tensorflow.org/forum/#!forum/docs).
+* Follow the [docs](https://discuss.tensorflow.org/tag/docs) tag on the
+  [TensorFlow Forum](https://discuss.tensorflow.org/).
+
 
 ## API reference
 
-To update reference documentation, find the
+For details, use the [TensorFlow API docs contributor guide](docs_ref.md). This
+shows you how to find the
 [source file](https://www.tensorflow.org/code/tensorflow/python/)
 and edit the symbol's
 <a href="https://www.python.org/dev/peps/pep-0257/" class="external">docstring</a>.
@@ -38,9 +41,6 @@ where the symbol is defined. Docstrings support
 and can be (approximately) previewed using any
 <a href="http://tmpvar.com/markdown.html" class="external">Markdown previewer</a>.
 
-For reference documentation quality and how to get involved with doc sprints and
-the community, see the
-[TensorFlow 2 API Docs advice](https://docs.google.com/document/d/1e20k9CuaZ_-hp25-sSd8E8qldxKPKQR-SkwojYr_r-U/preview).
 
 ### Versions and branches
 

site/en/addons/README.md

@@ -45,6 +45,11 @@ def concat(values, axis, name="concat"):
 
 Note: TensorFlow DocTest uses TensorFlow 2 and Python 3.
 
+To assess reference documentation quality, see the example section of the
+[TensorFlow 2 API Docs advice](https://docs.google.com/document/d/1e20k9CuaZ_-hp25-sSd8E8qldxKPKQR-SkwojYr_r-U/preview).
+(Be aware that the Task Tracker on this sheet is no longer in use.)
+
+
 ### Make the code testable with DocTest
 
 Currently, many docstrings use backticks (```) to identify code. To make the