TYP: added explanation of the join methods within df.align (#53101)

* added description to join methods of alignment

* Update generic.py

* run ruff/black to fix type errors

* Update pandas/core/generic.py

Co-authored-by: Matthew Roeschke <[email protected]>

* update from - to * to follow join's doc guide

* Update generic.py

---------

Co-authored-by: Matthew Roeschke <[email protected]>

Author: Antony-evm

pandas/core/generic.py

@@ -9471,6 +9471,14 @@ def align(
         ----------
         other : DataFrame or Series
         join : {{'outer', 'inner', 'left', 'right'}}, default 'outer'
+            Type of alignment to be performed.
+
+            * left: use only keys from left frame, preserve key order.
+            * right: use only keys from right frame, preserve key order.
+            * outer: use union of keys from both frames, sort keys lexicographically.
+            * inner: use intersection of keys from both frames,
+              preserve the order of the left keys.
+
         axis : allowed axis of the other object, default None
             Align on index (0), columns (1), or both (None).
         level : int or level name, default None