made the docs more clear, improved the images

Author: XFajk

buildconfig/stubs/pygame/geometry.pyi

@@ -197,4 +197,6 @@ class Line:
     def scale_ip(self, factor_and_origin: Point, /) -> None: ...
     def flip_ab(self) -> Line: ...
     def flip_ab_ip(self) -> None: ...
-    def project(self, point: Point, do_clamp: bool = False) -> Point: ...
+    def project(
+        self, point: tuple[float, float], clamp: bool = False
+    ) -> tuple[float, float]: ...

docs/reST/ref/code_examples/project.png

@@ -744,26 +744,22 @@
    .. method:: project
 
          | :sl:`projects the line onto the given line`
-         | :sg:`project(point, do_clamp=False) -> point`
+         | :sg:`project(point: tuple[float, float], clamp=False) -> tuple[float, float]`
 
-         Returns a new point(tuple[float, float]) that is projected onto the line like so
+         This method takes in a point and one boolean keyword argument clamp. It outputs an orthogonally projected point onto the line.
+         If clamp is True it makes sure that the outputted point will be on the line segment.
 
-         .. figure:: code_examples/project1.png
-            :alt: project method image
-
-            Example of what project method does if you input the green point you get back the yellow one.
 
+         .. figure:: code_examples/project.png
+            :alt: project method image
 
-         .. figure:: code_examples/project2.png
-            :alt: project do_clamp=False image
-
-            Example of what the do_clamp argument does when it is False
+            Example of how it projects the point on to the line purplish point is the point we want to project and the blue point is what you would get as a result
 
 
-         .. figure:: code_examples/project1.png
+         .. figure:: code_examples/project_clamp.png
             :alt: project do_clamp=True image
 
-            Example of what the do_clamp argument does when it is True
+            Example of what the clamp argument changes if it is true it stays on the line segment
 
          .. versionadded:: 2.5.4
 

docs/reST/ref/code_examples/project1.png

@@ -45,4 +45,4 @@
 #define DOC_LINE_SCALEIP "scale_ip(factor, origin) -> None\nscale_ip(factor_and_origin) -> None\nscales the line by the given factor from the given origin in place"
 #define DOC_LINE_FLIPAB "flip_ab() -> Line\nflips the line a and b points"
 #define DOC_LINE_FLIPABIP "flip_ab_ip() -> None\nflips the line a and b points, in place"
-#define DOC_LINE_PROJECT "project(point, do_clamp=False) -> point\nprojects the line onto the given line"
+#define DOC_LINE_PROJECT "project(point: tuple[float, float], clamp=False) -> tuple[float, float]\nprojects the line onto the given line"