From ac737c0e07a15d37753c4698bb46062b3a3f19a5 Mon Sep 17 00:00:00 2001
From: vyudu <vincent.duyuan@gmail.com>
Date: Mon, 10 Feb 2025 19:21:56 -0500
Subject: [PATCH 1/2] init

---
 docs/src/systems/DiscreteSystem.md            | 28 +++++++++++++++++++
 .../discrete_system/discrete_system.jl        | 13 +++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 docs/src/systems/DiscreteSystem.md

diff --git a/docs/src/systems/DiscreteSystem.md b/docs/src/systems/DiscreteSystem.md
new file mode 100644
index 0000000000..dcb98ca1cf
--- /dev/null
+++ b/docs/src/systems/DiscreteSystem.md
@@ -0,0 +1,28 @@
+# DiscreteSystem
+
+## System Constructors
+
+```@docs
+DiscreteSystem
+```
+
+## Composition and Accessor Functions  
+
+- `get_eqs(sys)` or `equations(sys)`: The equations that define the discrete system.  
+- `get_unknowns(sys)` or `unknowns(sys)`: The set of unknowns in the discrete system.  
+- `get_ps(sys)` or `parameters(sys)`: The parameters of the discrete system.  
+- `get_iv(sys)`: The independent variable of the discrete system
+- `discrete_events(sys)`: The set of discrete events in the discrete system.
+ 
+## Transformations
+
+```@docs; canonical=false
+structural_simplify
+```
+ 
+## Problem Constructors
+
+```@docs; canonical=false
+DiscreteProblem(sys::DiscreteSystem, u0map, tspan)
+DiscreteFunction(sys::DiscreteSystem, args...)
+```
diff --git a/src/systems/discrete_system/discrete_system.jl b/src/systems/discrete_system/discrete_system.jl
index bd81255706..cd6ff45b6c 100644
--- a/src/systems/discrete_system/discrete_system.jl
+++ b/src/systems/discrete_system/discrete_system.jl
@@ -323,6 +323,19 @@ end
 function SciMLBase.DiscreteFunction{false}(sys::DiscreteSystem, args...; kwargs...)
     DiscreteFunction{false, SciMLBase.FullSpecialize}(sys, args...; kwargs...)
 end
+
+"""
+```julia
+SciMLBase.DiscreteFunction{iip}(sys::DiscreteSystem,
+                            dvs = unknowns(sys),
+                            ps = parameters(sys);
+                            kwargs...) where {iip}
+```
+
+Create an `DiscreteFunction` from the [`DiscreteSystem`](@ref). The arguments `dvs` and `ps`
+are used to set the order of the dependent variable and parameter vectors,
+respectively.
+"""
 function SciMLBase.DiscreteFunction{iip, specialize}(
         sys::DiscreteSystem,
         dvs = unknowns(sys),

From 992ec21e4f077f4e81837a6fdd3430aa16fd6add Mon Sep 17 00:00:00 2001
From: vyudu <vincent.duyuan@gmail.com>
Date: Mon, 10 Feb 2025 19:24:42 -0500
Subject: [PATCH 2/2] up

---
 docs/pages.jl | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/pages.jl b/docs/pages.jl
index 82cc23d4a8..6e18f403dd 100644
--- a/docs/pages.jl
+++ b/docs/pages.jl
@@ -41,7 +41,8 @@ pages = [
         "systems/JumpSystem.md",
         "systems/NonlinearSystem.md",
         "systems/OptimizationSystem.md",
-        "systems/PDESystem.md"],
+        "systems/PDESystem.md",
+        "systems/DiscreteSystem.md"],
     "comparison.md",
     "internals.md"
 ]