Update plotting documentation and function comments (#7)

- Enhanced documentation for plot_param_line and calculate_param_line functions
- Updated module documentation in Linear_Algebra.jl
- Improved function docstrings for clarity and consistency
- Updated docs/src/index.md with plotting-related documentation

Author: AronT-TLV

docs/src/index.md

@@ -2,12 +2,22 @@
 
 This package provides a collection of functions for linear algebra operations and transformations.
 
-## Linear Algebra Functions
+## Basic Linear Algebra Functions
 
-This section provides the documentation for all the linear algebra functions.
+This section provides the documentation for the basic linear algebra functions.
 
 ```@autodocs
 Modules = [Linear_Algebra]
 Order   = [:function, :type]
-Pages   = ["linear_algebra_basic.jl", "linear_algebra_transform.jl"]
-```
+Pages   = ["linear_algebra_basic.jl"]
+```
+
+## Linear Transformations
+
+This section provides the documentation for linear transformations and related operations.
+
+```@autodocs
+Modules = [Linear_Algebra]
+Order   = [:function, :type]
+Pages   = [""linear_algebra_transform.jl"]
+```

src/Linear_Algebra.jl

@@ -15,8 +15,7 @@ end
 # Exports...
 # Pure computational functions (no plotting dependencies)
 export calculate_param_line
-# Integrated plotting functions (computation + visualization)
-export distance_2_points, center_of_gravity, barycentric_coord, plot_param_line
+export distance_2_points, center_of_gravity, barycentric_coord
 export vector_angle_cos, is_orthogonal, polar_unit, orthproj, reflection, rotation
 export point_in_implicit_line, parametric_to_implicit_line, implicit_to_parametric_line, explicit_line
 export distance_to_implicit_line, implicit_line_point_normal_form, distance_to_pnf_implicit_line
@@ -26,6 +25,8 @@ export projection_matrix_symbolic, projection_matrix_symbolic_polar, projection_
 export projection_matrix_transpose, rotation_matrix_symbolic, rotation_matrix, rotation_matrix_ns
 export stretch_matrix_symbolic, stretch_matrix
 export reflection_matrix_symbolic, reflection_matrix, reflection_matrix_rational
+# Integrated plotting functions (computation + visualization)
+export plot_param_line
 
 # Re-export the @variables macro
 eval(:(export @variables))

src/linear_algebra_basic.jl

@@ -45,7 +45,6 @@ end
     plot_param_line(p::Point, q::Point, n::Int64) → [Point]
 Creates `n` points on a line defined by `p` and `q`, using the parametric equation of a line, then plot
 """
-
 function plot_param_line(p::Point, q::Point, n::Int64)
     # Use computational function for calculations
     Ps = calculate_param_line(p, q, n)