Ac/package updates

.github/pull_request_template.md

@@ -1,3 +1,5 @@
-Thanks for opening a PR to SIIP-PACKAGE.jl, please take note of the following when making a PR:
-
-Check the [contributor guidelines](https://nrel-siip.github.io/SIIP-PACKAGE.jl/stable/code_base_developer_guide/developer/)
+Thanks for opening a PR to SIIP-PACKAGE.jl, please take note of the following when making a PR:
+
+Check the [contributor guidelines](https://nrel-siip.github.io/SIIP-PACKAGE.jl/stable/code_base_developer_guide/developer/)
+
+

Project.toml

@@ -1,4 +1,4 @@
-name = "SIIP-Package"
+name = "SiennaTemplate"
 uuid = "bed98974-b02a-5e2f-9ee0-a103f5c450dd"
 authors = ["YOUR_NAME"]
 version = "0.1.0"

docs/Project.toml

@@ -1,6 +1,9 @@
 [deps]
+DataStructures = "864edb3b-99cc-5e75-8d2d-829cb0a9cfe8"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+DocumenterInterLinks = "d12716ef-a0f6-4df4-a9f1-a5a34e75c656"
+SiennaTemplate = "bed98974-b02a-5e2f-9ee0-a103f5c450dd"
 
 [compat]
-Documenter = "0.27"
 julia = "^1.6"
+Documenter = "^1.0"

docs/make.jl

@@ -1,27 +1,37 @@
-using Documenter, SIIP - PACKAGE
-
-pages = OrderedDict(
-    "Welcome Page" => "index.md",
-    "Quick Start Guide" => "quick_start_guide.md",
-    "Tutorials" => "tutorials/intro_page.md",
-    "Public API Reference" => "api/public.md",
-    "Internal API Reference" => "api/internal.md",
-)
-
-makedocs(
-    modules=[SIIP-PACKAGE],
-    format=Documenter.HTML(prettyurls=haskey(ENV, "GITHUB_ACTIONS")),
-    sitename="SIIP-PACKAGE.jl",
-    authors="Freddy Mercury, Nikola Tesla, Leonard Bernestein",
-    pages=Any[p for p in pages],
-)
-
-deploydocs(
-    repo="github.com/NREL-SIIP/SIIP-PACKAGE.git",
-    target="build",
-    branch="gh-pages",
-    devbranch="master",
-    devurl="dev",
-    push_preview=true,
-    versions=["stable" => "v^", "v#.#"],
-)
+using Documenter
+import DataStructures: OrderedDict
+using SiennaTemplate
+
+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",
+        "Internals" => "reference/internal.md",
+        "Stub" => "reference.stud.md"
+    ],
+)
+
+makedocs(
+    modules = [SiennaTemplate],
+    format = Documenter.HTML(
+        prettyurls = haskey(ENV, "GITHUB_ACTIONS"),
+        size_threshold = nothing,),
+    sitename = "github.com/NREL-Sienna/SiennaTemplate.jl",
+    authors = "Freddy Mercury",
+    pages = Any[p for p in pages],
+    draft = false,
+)
+
+deploydocs(
+    repo="github.com/NREL-Sienna/SiennaTempalte.jl",
+    target="build",
+    branch="gh-pages",
+    devbranch="master",
+    devurl="dev",
+    push_preview=true,
+    versions=["stable" => "v^", "v#.#"],
+)
+

docs/src/explanation/stub.md

@@ -0,0 +1 @@
+Please refer to the [Explanation](https://diataxis.fr/explanation/) section of the diataxis framework.

docs/src/how_to_guides/stub.md

@@ -0,0 +1 @@
+Please refer to the [How-to-Guides](https://diataxis.fr/how-to-guides/) section of the diataxis framework.

docs/src/index.md

@@ -1,14 +1,28 @@
 # PowerSystems.jl
 
 ```@meta
-CurrentModule = SIIP_PACKAGE
+CurrentModule = SiennaTemplate
 ```
 
 ## Overview
 
-`PSIIP-PACKAGE .jl` is a [`Julia`](http://www.julialang.org) package that provides blah blah
+`SiennaTemplate.jl` is a [`Julia`](http://www.julialang.org) package that provides blah blah
+
+## About
+
+`PowerSystems.jl` is part of the National Renewable Energy Laboratory's
+[Sienna ecosystem](https://www.nrel.gov/analysis/sienna.html), an open source framework for
+scheduling problems and dynamic simulations for power systems. The Sienna ecosystem can be
+[found on github](https://github.com/NREL-Sienna/Sienna). It contains three applications:
+
+  - [Sienna\Data](https://github.com/NREL-Sienna/Sienna?tab=readme-ov-file#siennadata) enables
+    efficient data input, analysis, and transformation
+  - [Sienna\Ops](https://github.com/NREL-Sienna/Sienna?tab=readme-ov-file#siennaops) enables
+    enables system scheduling simulations by formulating and solving optimization problems
+  - [Sienna\Dyn](https://github.com/NREL-Sienna/Sienna?tab=readme-ov-file#siennadyn) enables
+    system transient analysis including small signal stability and full system dynamic
+    simulations
+
+Each application uses multiple packages in the [`Julia`](http://www.julialang.org)
+programming language.
 
-------------
-SIIP-PACKAGE  has been developed as part of the Scalable Integrated Infrastructure Planning
-(SIIP) initiative at the U.S. Department of Energy's National Renewable Energy
-Laboratory ([NREL](https://www.nrel.gov/)).

docs/src/quick_start_guide.md

@@ -1,3 +1,3 @@
 # Quick Start Guide
 
-SIIP-PACKAGE.jl is structured to enable stuff
+SiennaTemplate.jl is structured to enable stuff

docs/src/api/internal.md → docs/src/reference/internal.md

@@ -1,6 +1,6 @@
 # Internal API
 
 ```@autodocs
-Modules = [SIIP-Package]
+Modules = [SiennaTemplate]
 Public = false
 ```

docs/src/api/public.md → docs/src/reference/public.md

@@ -1,6 +1,6 @@
 # Public API Reference
 
 ```@autodocs
-Modules = [SIIP-Package]
+Modules = [SiennaTemplate]
 Public = true
 ```

docs/src/reference/stub.md

@@ -0,0 +1 @@
+Please refer to the [Reference](https://diataxis.fr/reference/) section of the diataxis framework.

docs/src/tutorials/stub.md

@@ -0,0 +1 @@
+Please refer to the [Tutorial](https://diataxis.fr/tutorials/) section of the diataxis framework.

scripts/formatter/formatter_code.jl

@@ -1,41 +1,28 @@
-using Pkg
-Pkg.activate(@__DIR__)
-Pkg.instantiate()
-using JuliaFormatter
-
-main_paths = [".", "./docs/src"]
-for main_path in main_paths
-    format(
-        main_path;
-        whitespace_ops_in_indices=true,
-        remove_extra_newlines=true,
-        verbose=true,
-        always_for_in=true,
-        whitespace_typedefs=true,
-        whitespace_in_kwargs=false,
-        format_docstrings=true,
-        always_use_return=false, # removed since it has false positives.
-    )
-end
-
-# Documentation Formatter
-main_paths = ["./docs/src"]
-for main_path in main_paths
-    for folder in readdir(main_path)
-        @show folder_path = joinpath(main_path, folder)
-        if isfile(folder_path)
-            !occursin(".md", folder_path) && continue
-        end
-        format(
-            folder_path;
-            format_markdown=true,
-            whitespace_ops_in_indices=true,
-            remove_extra_newlines=true,
-            verbose=true,
-            always_for_in=true,
-            whitespace_typedefs=true,
-            whitespace_in_kwargs=false,
-            # always_use_return = true # removed since it has false positives.
-        )
-    end
-end
+using Pkg
+Pkg.activate(@__DIR__)
+Pkg.instantiate()
+using JuliaFormatter
+
+main_paths = ["./src", "./test", "./docs/src"]
+for main_path in main_paths
+    for (root, dir, files) in walkdir(main_path)
+        for f in files
+        @show file_path = abspath(root, f)
+        !((occursin(".jl", f) || occursin(".md", f))) && continue
+        format(file_path;
+            whitespace_ops_in_indices = true,
+            remove_extra_newlines = true,
+            verbose = true,
+            always_for_in = true,
+            whitespace_typedefs = true,
+            conditional_to_if = true,
+            join_lines_based_on_source = true,
+            separate_kwargs_with_semicolon = true,
+            format_markdown = true,
+            #ignore = [] # list of file that cause formatter to error
+
+            # always_use_return = true. # Disabled since it throws a lot of false positives
+            )
+        end
+    end
+end

src/SIIP-PACKAGE.jl → src/SiennaTemplate.jl

@@ -1,6 +1,4 @@
-module SIIP
--PACKAGE
-
+module SiennaTemplate
 using DocStringExtensions
 
 @template (FUNCTIONS, METHODS) = """