Move all symbols to the top of the left nav.

PiperOrigin-RevId: 286620058
martbox3721 · Dec 20, 2019 · 83b2b0f · 83b2b0f
1 parent 34140b1
commit 83b2b0f
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 2 deletions.
diff --git a/site/en/api_docs/_book.yaml b/site/en/api_docs/_book.yaml
@@ -79,10 +79,12 @@ upper_tabs:
     - name: Python
       skip_translation: true
       contents:
-      - title: Python {VERSION}
-      - include: {VERSION_ROOT}/python/_toc.yaml
+      - title: Overview
+        path: {VERSION_ROOT}/python/tf
       - title: All Symbols
         path: {VERSION_ROOT}/python/
+      - title: Python {VERSION}
+      - include: {VERSION_ROOT}/python/_toc.yaml
 
     - name: JavaScript
       contents:

diff --git a/tools/tensorflow_docs/api_generator/generate_lib.py b/tools/tensorflow_docs/api_generator/generate_lib.py
@@ -554,6 +554,14 @@ def write_docs(output_dir,
     toc_gen = GenerateToc(module_children)
     toc_dict = toc_gen.generate()
 
+    # Replace the overview path *only* for 'TensorFlow' to
+    # `/api_docs/tf_overview`. This will be redirected to `/api_docs/python/tf`.
+    toc_values = toc_dict['toc'][0]
+    if toc_values['title'] == 'tf':
+      section = toc_values['section'][0]
+      if '/versions/' not in section['path']:
+        section['path'] = '/api_docs/tf_overview'
+
     leftnav_toc = os.path.join(output_dir, '_toc.yaml')
     with open(leftnav_toc, 'w') as toc_file:
       yaml.dump(toc_dict, toc_file, default_flow_style=False)