Skip to content

docs: Linear Algebra review and docs restructure - Basics section complete#11

Merged
AronT-TLV merged 26 commits intomainfrom
docs/linear-algebra-review-1
Mar 1, 2026
Merged

docs: Linear Algebra review and docs restructure - Basics section complete#11
AronT-TLV merged 26 commits intomainfrom
docs/linear-algebra-review-1

Conversation

@AronT-TLV
Copy link
Member

Complete review and restructure of the Basics documentation section, including vectors, matrices, and systems of equations, with updated notebook examples.

Changes

  • Refactored Copilot instructions into contextual instruction files (synced with Math_Foundations)
  • Completed Vectors documentation and notebook with definitions, operations, linear independence, examples
  • Expanded Matrices documentation with examples, notation, matrix operations
  • Moved Systems of Equations content from Matrices into a dedicated document
  • Restructured Basics section order to match textbook sequence
  • Updated Basics notebook with additional examples
  • Trimmed Matrices content to current scope and updated index to reflect document state

Testing

Docs built successfully locally with julia --project=. docs/make.jl.

- Add Cartesian Plane section and restructure coordinate system intro
- Add Magnitude and Unit Vectors sections to Basics/01 Vectors
- Change point notation from uppercase to lowercase for consistency
- Uncomment Lines and Transformations pages in make.jl
- Minor formatting fix in Dot Product document
… Vectors and Geometry.md and

2. fix link in Basics/01 Vectors.md to point to Geometry/03 Vectors and Geometry.md
3. Expose a few more files in docs/make.jl
- Replace retry loop with simple let block (matches Math_Foundations pattern)
- Silent error handling to avoid MethodError in Task context
- GR backend auto-configures on first plot if init fails
- Remove __init__() and module-level gr() calls
- GR backend now set explicitly in plotting functions
- Add ENV["GKSwstype"] = "100" in runtests.jl for CI headless mode
1. more examples to Basics.ipynb
2. added Linear Independence & Dependence section to 01 Vectors.md
3. fixed project activation in Linear_Algebra_Geometry.ipynb
- notebooks/Basics.ipynb: add Linear Combinations & Linear Dependency section with examples
- docs/src/Basics/01 Vectors.md: add Linear System of Equations subsection, remove span (moved to geometry)
- docs/src/Geometry/01 Points and Coordinates.md: add Span (Geometric View) section after Linear Independence
- docs/src/Geometry/03 Vectors and Geometry.md: fix formatting, rename section to Geometric Formula for the Dot Product
- docs/src/Geometry/04 Projections and Distance.md: fix cross-document links with proper anchor syntax
- docs/src/Geometry/06 Transformations.md: fix link to geometric dot product formula
- docs/make.jl: enable all geometry pages (04-09) and Systems of Equations in sidebar
…trices

01 Vectors.md:
- Add Orthogonal and Orthonormal Vectors subsection after Dot Product Properties
- Define orthogonal vectors (dot product equals zero)
- Define orthonormal vectors (orthogonal + unit vectors)

02 Matrices.md:
- Add property names to Transpose properties (Involution, Distributive, etc.)
- Add property names to Orthogonal Matrix properties
- Add property names to Determinant properties
- Add property names to Matrix Inverse properties
- Fix LaTeX bracket syntax using \lbrack/\rbrack for augmented matrices
- Renamed linear_algebra_basic.jl to linear_algebra_geometry.jl (point/line operations)
- Created new linear_algebra_basic.jl with lin_ind_vec function for linear independence
- Added tests for lin_ind_vec covering 2D/3D vectors, dependent/independent cases
- Updated module exports and includes
- Reorganized tests into test_linear_algebra_basic.jl and test_linear_algebra_geometry.jl
Move domain-specific instructions into .github/instructions/ with applyTo
front matter so they load only when editing relevant files:

- docs.instructions.md (docs/**): LaTeX, MathJax3, MathWorld, doc structure
- testing.instructions.md (test/**): CI strategy, plotting patterns, test org
- source.instructions.md (src/**): module structure, coding standards, signatures
- notebooks.instructions.md (notebooks/**): notebook setup and guidelines

Main copilot-instructions.md trimmed from 497 to 127 lines, keeping only
universal content: project overview, workflows, git/PR conventions,
communication patterns, Azure integration.
Add missing shared content to instruction files for cross-project consistency:

docs.instructions.md:
- Add context example and derivation reference (items 5,6)
- Add project-specific grouping example (item 7)

testing.instructions.md:
- Add @test_throws/@test_broken mentions (item 14)
- Add Plotting in Tests section with save conventions (item 12)
- Add CI/CD Pipeline section (item 13)

source.instructions.md:
- Add Function Design Pattern code example (item 17)
- Extract CI detection into separate section for consistency (item 18)
- improved matrix documentation
…c, add notebook examples

- Move systems of linear equations section from 02 Matrices to 04 Systems of Equations
- Merge matrix-specific solution criteria into Types of Solutions section
- Add homogeneous systems section to 04
- Fix broken LaTeX in 'No solution' description
- Update cross-references between documents
- Change identity matrix notation from I_{n×n} to standard I_n
- Add notebook examples for linear algebra basics
Reorganize the 4 Basics documents to align with Walz et al. Chapter 5:
- 5.1 Vectors (01 - unchanged)
- 5.2 Matrices (02 - slimmed: removed row ops, eigenvalues, decompositions, rank/nullity)
- 5.3 Linear Systems → 03 Systems of Equations (renamed from 04; added Row Operations and Rank/Nullity sections)
- 5.4 Analytical Geometry → 04 Analytic Geometry (renamed from 03 Linear Transformations; added position/connecting vectors, parameterized/parameter-free plane equations, normal vectors, cross product)

Content moves:
- Row Operations + Rank/Nullity moved from 02 Matrices into 03 Systems
- Eigenvalues/Decompositions stored in Linear Algebra Old (gitignored)
- Linear Transformations content preserved in 04 Analytic Geometry under demoted headings

Updated all cross-references and make.jl pages list.
@AronT-TLV AronT-TLV merged commit 36fd4c6 into main Mar 1, 2026
5 checks passed
@AronT-TLV AronT-TLV deleted the docs/linear-algebra-review-1 branch March 2, 2026 12:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant