modify documentation

Author: ytdHuang

docs/make.jl

@@ -10,12 +10,15 @@ DocMeta.setdocmeta!(QuantumToolbox, :DocTestSetup, :(using QuantumToolbox); recu
 
 const DRAFT = false # set `true` to disable cell evaluation
 
-bib = CitationBibliography(joinpath(@__DIR__, "src", "bibliography.bib"), style=:authoryear)
+bib = CitationBibliography(
+    joinpath(@__DIR__, "src", "resources", "bibliography.bib"), 
+    style=:authoryear,
+)
 
 const PAGES = [
     "Home" => "index.md",
     "Getting Started" => [
-        "Introduction" => "getting_started.md",
+        "Brief Example" => "getting_started.md",
         "Key differences from QuTiP" => "qutip_differences.md",
         "The Importance of Type-Stability" => "type_stability.md",
         # "Cite QuantumToolbox.jl" => "cite.md",
@@ -51,9 +54,11 @@ const PAGES = [
             "tutorials/logo.md",
         ],
     ],
-    "API" => "api.md",
-    "Bibliography" => "bibliography.md",
-    # "Change Log" => "changelog.md",
+    "Resources" => [
+        "API" => "resources/api.md",
+        # "Change Log" => "resources/changelog.md",
+        "Bibliography" => "resources/bibliography.md",
+    ],
 ]
 
 makedocs(;

docs/src/getting_started.md

@@ -2,29 +2,6 @@
 CurrentModule = QuantumToolbox
 ```
 
-## [Installation](@id doc:Installation)
-
-!!! note "Requirements"
-    `QuantumToolbox.jl` requires `Julia 1.10+`.
-
-To install `QuantumToolbox.jl`, run the following commands inside Julia's interactive session (also known as REPL):
-```julia
-using Pkg
-Pkg.add("QuantumToolbox")
-```
-Alternatively, this can also be done in Julia's [Pkg REPL](https://julialang.github.io/Pkg.jl/v1/getting-started/) by pressing the key `]` in the REPL to use the package mode, and then type the following command:
-```julia-REPL
-(1.10) pkg> add QuantumToolbox
-```
-More information about `Julia`'s package manager can be found at [`Pkg.jl`](https://julialang.github.io/Pkg.jl/v1/).
-
-To load the package and check the version information, use either [`QuantumToolbox.versioninfo()`](@ref) or [`QuantumToolbox.about()`](@ref), namely
-```julia
-using QuantumToolbox
-QuantumToolbox.versioninfo()
-QuantumToolbox.about()
-```
-
 ## Brief Example
 
 We now provide a brief example to demonstrate the similarity between [QuantumToolbox.jl](https://github.com/qutip/QuantumToolbox.jl) and [QuTiP](https://github.com/qutip/qutip).

docs/src/index.md

@@ -13,6 +13,9 @@ hero:
     - theme: brand
       text: Getting Started
       link: /getting_started
+    - theme: alt
+      text: Users Guide
+      link: /users_guide/QuantumObject/QuantumObject
     - theme: alt
       text: View on Github
       link: https://github.com/qutip/QuantumToolbox.jl
@@ -37,6 +40,31 @@ features:
 ---
 ```
 
+# [Introduction](@id doc:Introduction)
+
 [QuantumToolbox.jl](https://github.com/qutip/QuantumToolbox.jl) is a cutting-edge Julia package designed for quantum physics simulations, closely emulating the popular Python [QuTiP](https://github.com/qutip/qutip) package. It uniquely combines the simplicity and power of Julia with advanced features like GPU acceleration and distributed computing, making simulation of quantum systems more accessible and efficient. Taking advantage of the Julia language features (like multiple dispatch and metaprogramming), QuantumToolbox.jl is designed to be easily extendable, allowing users to build upon the existing functionalities.
 
 *__With this package, moving from Python to Julia for quantum physics simulations has never been easier__*, due to the similar syntax and functionalities.
+
+# [Installation](@id doc:Installation)
+
+!!! note "Requirements"
+    `QuantumToolbox.jl` requires `Julia 1.10+`.
+
+To install `QuantumToolbox.jl`, run the following commands inside Julia's interactive session (also known as REPL):
+```julia
+using Pkg
+Pkg.add("QuantumToolbox")
+```
+Alternatively, this can also be done in Julia's [Pkg REPL](https://julialang.github.io/Pkg.jl/v1/getting-started/) by pressing the key `]` in the REPL to use the package mode, and then type the following command:
+```julia-REPL
+(1.10) pkg> add QuantumToolbox
+```
+More information about `Julia`'s package manager can be found at [`Pkg.jl`](https://julialang.github.io/Pkg.jl/v1/).
+
+To load the package and check the version information, use either [`QuantumToolbox.versioninfo()`](@ref) or [`QuantumToolbox.about()`](@ref), namely
+```julia
+using QuantumToolbox
+QuantumToolbox.versioninfo()
+QuantumToolbox.about()
+```

docs/src/api.md renamed to docs/src/resources/api.md

@@ -4,11 +4,13 @@ CurrentModule = QuantumToolbox
 
 # [API](@id doc-API)
 
-## Contents
+<!-- Disable this first (until we find a way to fix it)
+**Table of contents**
 
 ```@contents
 Pages = ["api.md"]
 ```
+-->
 
 ## [Quantum object (Qobj) and type](@id doc-API:Quantum-object-and-type)
 

docs/src/bibliography.bib renamed to docs/src/resources/bibliography.bib

@@ -2,7 +2,5 @@
 CurrentModule = QuantumToolbox
 ```
 
-# [Bibliography](@id doc:Bibliography)
-
 ```@bibliography
 ```

docs/src/bibliography.md renamed to docs/src/resources/bibliography.md

@@ -1,5 +1,6 @@
 # [Time Evolution and Quantum System Dynamics](@id doc:Time-Evolution-and-Quantum-System-Dynamics)
 
+<!-- Disable this first (until we find a way to fix it)
 **Table of contents**
 
 ```@contents
@@ -14,6 +15,7 @@ Pages = [
 ]
 Depth = 1:2
 ```
+-->
 
 # [Introduction](@id doc-TE:Introduction)