docs: refactor project structure and improve user experience

- Change the title of the deck from `Python Dependencies` to `Dependencies`
- Update the error message in case of a subprocess error in fetching installed packages
- Add a heading `Python Dependencies` above the table output in the HTML

Signed-off-by: jason.lai <[email protected]>

flytekit/core/python_function_task.py

@@ -362,7 +362,7 @@ def _write_decks(self, native_inputs, native_outputs_as_map, ctx, new_user_param
                 renderer = SourceCodeRenderer()
                 source_code_deck.append(renderer.to_html(source_code))
 
-            python_dependencies_deck = Deck("Python Dependencies")
+            python_dependencies_deck = Deck("Dependencies")
             renderer = PythonDependencyRenderer()
             python_dependencies_deck.append(renderer.to_html())
 

flytekit/deck/renderer.py

@@ -93,7 +93,7 @@ class PythonDependencyRenderer:
     PythonDependencyDeck is a deck that contains information about packages installed via pip.
     """
 
-    def __init__(self, title: str = "Python Dependencies"):
+    def __init__(self, title: str = "Dependencies"):
         self._title = title
 
     def to_html(self) -> str:
@@ -115,7 +115,7 @@ def to_html(self) -> str:
             )
         except subprocess.CalledProcessError as e:
             logger.error(f"Error occurred while fetching installed packages: {e}")
-            return ""
+            return "Error occurred while fetching installed packages."
 
         table = (
             "<table>\n<tr>\n<th style='text-align:left;'>Name</th>\n<th style='text-align:left;'>Version</th>\n</tr>\n"
@@ -150,7 +150,7 @@ def to_html(self) -> str:
         <button onclick="copyTable()">
           <span>Copy table as requirements.txt</span>
         </button>
-        <br><br><br>
+        <h3>Python Dependencies</h3>
 
         {table}