updated documentation to follow diataxis and updated to Documenter 1.0

docs/Project.toml

@@ -3,6 +3,7 @@ Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 DocumenterTools = "35a29f4d-8980-5a13-9543-d66fff28ecb8"
 Literate = "98b081ad-f1c9-55d3-8b20-4c87d4299306"
 PowerAnalytics = "56ce1300-00bc-47e4-ba8c-b166ccc19f51"
+DataStructures = "864edb3b-99cc-5e75-8d2d-829cb0a9cfe8"
 
 [compat]
-Documenter = "~0.27"
+Documenter = "^1.7"

docs/make.jl

@@ -1,53 +1,53 @@
 using Documenter
 using PowerAnalytics
-using Literate
+import DataStructures: OrderedDict
+
+
+pages = OrderedDict(
+    "Welcome Page" => "index.md",
+    "Tutorials" => Any["stub" => "tutorials/stub.md"],
+    "How to..." => Any["stub" => "how_to_guides/stub.md"],
+    "Explanation" => Any["stub" => "explanation/stub.md"],
+    "Reference" => Any[ 
+        "Public API" => "reference/public.md",
+        "Developers" => ["Developer Guidelines" => "reference/developer_guidelines.md",
+        "Internals" => "reference/internal.md"]]
+
+)
+
 
-folders = Dict()
 
-for (name, folder) in folders
-    for file in folder
-        outputdir = joinpath(pwd(), "docs/src/howto")
-        inputfile = joinpath(pwd(), "docs/src/$name/$file")
-        Literate.markdown(inputfile, outputdir)
-    end
-end
-if isfile("docs/src/howto/.DS_Store.md")
-    rm("docs/src/howto/.DS_Store.md")
-end
 
 makedocs(
-    sitename = "PowerAnalytics.jl",
-    format = Documenter.HTML(
-        mathengine = Documenter.MathJax(),
-        prettyurls = get(ENV, "CI", nothing) == "true",
-    ),
     modules = [PowerAnalytics],
+    format = Documenter.HTML(
+        prettyurls = haskey(ENV, "GITHUB_ACTIONS"),
+        size_threshold = nothing,),
+    sitename = "PowerAnalytics.jl",
     authors = "Clayton Barrows",
-    pages = Any[
-        "Introduction" => "index.md",
-        #"Quick Start Guide" => "qs_guide.md",
-        #"Logging" => "man/logging.md",
-        # "Operation Model" => "man/op_problem.md",
-        # "How To" => Any[
-        #     "Set Up Plots" => "howto/3.0_set_up_plots.md",
-        #     "Make Stack Plots" => "howto/3.1_make_stack_plots.md",
-        #     "Make Bar Plots" => "howto/3.2_make_bar_plots.md",
-        #     "Make Fuel Plots" => "howto/3.3_make_fuel_plots.md",
-        #     "Make Forecast Plots" => "howto/3.4_make_forecast_plots.md",
-        #     "Plot Fewer Variables" => "howto/3.5_plot_fewer_variables.md",
-        #     "Plot Multiple Results" => "howto/3.6_plot_multiple_results.md",
-        # ],
-        #"Simulation Recorder" => "man/simulation_recorder.md",
-        #"Model References" => Any["Hydro Models" => "ref/hydro.md"],
-        "API" => Any["PowerAnalytics" => "api/PowerAnalytics.md"],
-    ],
+    pages = Any[p for p in pages],
+    draft = false,
 )
 
+
 deploydocs(
-    repo="github.com/NREL-Sienna/PowerAnalytics.jl.git",
+    repo="github.com/NREL-Sienna/PowerAnalytics.jl",
     target="build",
     branch="gh-pages",
     devbranch="main",
     devurl="dev",
+    push_preview=true,
     versions=["stable" => "v^", "v#.#"],
 )
+
+
+
+
+
+
+
+
+
+
+
+

docs/src/reference/developer_guidelines.md

@@ -0,0 +1,12 @@
+# Developer Guidelines
+
+In order to contribute to `PowerSystems.jl` repository please read the following sections of
+[`InfrastructureSystems.jl`](https://github.com/NREL-Sienna/InfrastructureSystems.jl)
+documentation in detail:
+
+ 1. [Style Guide](https://nrel-sienna.github.io/InfrastructureSystems.jl/stable/style/)
+ 2. [Contributing Guidelines](https://github.com/NREL-Sienna/SiennaTemplate.jl/blob/main/CONTRIBUTING.md)
+
+Pull requests are always welcome to fix bugs or add additional modeling capabilities.
+
+**All the code contributions need to include tests with a minimum coverage of 70%**

docs/src/reference/internal.md

@@ -0,0 +1,6 @@
+## Internal
+
+```@autodocs
+Modules = [PowerAnalytics]
+Public = false
+```

docs/src/reference/public.md

@@ -0,0 +1,6 @@
+## Exported
+
+```@autodocs
+Modules = [PowerAnalytics]
+Private = false
+```