UDict docs (#7)

This pull request updates the documentation for the `UDict` class,
introduces the new `uSTL` package with initial documentation for the
`Stack` class, and deprecates the `UStack` class. It also enhances the
MkDocs theme configuration and simplifies the CI workflow for
documentation deployment.

- **New Features**:
- Introduced `uSTL` package with initial documentation for `Stack`
class.
- **Enhancements**:
- Updated `UDict` documentation to improve clarity and consistency,
including better formatting and additional examples.
    - Added a logo to the MkDocs theme configuration.
- Enhanced MkDocs theme with new features like content code annotation
and updated navigation settings.
- **CI**:
- Simplified the GitHub Actions workflow for deploying MkDocs by
removing specific branch restrictions.
- **Documentation**:
- Deprecated `UStack` class in favor of `uSTL.Stack` and updated its
documentation accordingly.
- Updated the main index documentation to reflect the new structure and
features, including the `uSTL` package and its components.

.github/workflows/deploy_mkdocs.yml

@@ -1,11 +1,10 @@
 name: deploy_mkdocs
 on:
-  push:
-    branches:
-      - master
-      - main
+  push
+
 permissions:
   contents: write
+
 jobs:
   deploy:
     runs-on: ubuntu-latest

docs/index.md

@@ -18,11 +18,12 @@ Ufpy (Useful Python) - is a package for simplifying Python programs using many u
 Now Ufpy has these features:
 
 - [`UDict`](useful_classes/udict.md "Useful dict.").
-- [`UStack`](useful_classes/ustack.md "Useful stack.").
+- [`uSTL` package](uSTL/index.md).
+    - [`Stack`](uSTL/stack.md).
 - Generators of classes methods:
-    - [`cmp_generator`](generators.md "Compare generator. In latest python version were deleted __cmp__ method. With this generator you can use __cmp__ in your class")
-    - [`r_generator`](generators.md "Reverse generator. Generating __r...__ methods for math operations")
-    - [`i_generator`](generators.md "I methods generator. Generating __i...__ method for math operations")
+    - [`cmp_generator`](useful_features/generators.md "Compare generator. In latest python version were deleted __cmp__ method. With this generator you can use __cmp__ in your class")
+    - [`r_generator`](useful_features/generators.md "Reverse generator. Generating __r...__ methods for math operations")
+    - [`i_generator`](useful_features/generators.md "I methods generator. Generating __i...__ method for math operations")
 - [many protocols for type hinting.](type_checking/protocols.md)
 - [many type alias for type hinting.](type_checking/type_alias.md)
 

docs/uSTL/index.md

@@ -0,0 +1,7 @@
+# Introduction
+
+{--
+`uSTL` package is ...
+--}
+
+Under development!

docs/uSTL/stack.md

@@ -0,0 +1,8 @@
+---
+title: Stack[VT]
+
+tags:
+  - uSTL
+---
+
+# class Stack[VT]