Ac/package updates

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,7 @@
 [deps]
+DataStructures = "864edb3b-99cc-5e75-8d2d-829cb0a9cfe8"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+SiennaTemplate = "bed98974-b02a-5e2f-9ee0-a103f5c450dd"
 
 [compat]
-Documenter = "0.27"
 julia = "^1.6"

docs/make.jl

@@ -1,27 +1,36 @@
-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",
+    ],
+)
+
+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/annacasavant/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,15 @@
 # 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
+
+* * *
 
-------------
 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/reference/internal.md

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

docs/src/reference/public.md

@@ -0,0 +1,6 @@
+# Public API Reference
+
+```@autodocs
+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/SiennaTemplate.jl

@@ -0,0 +1,9 @@
+module SiennaTemplate
+using DocStringExtensions
+
+@template (FUNCTIONS, METHODS) = """
+                                 $(TYPEDSIGNATURES)
+                                 $(DOCSTRING)
+                                 """
+
+end

test/runtests.jl

@@ -2,11 +2,11 @@ using Test
 import Logging
 
 import Aqua
-Aqua.test_unbound_args(SIIP - PACKAGE)
-Aqua.test_undefined_exports(SIIP - PACKAGE)
-Aqua.test_ambiguities(SIIP - PACKAGE)
-Aqua.test_stale_deps(SIIP - PACKAGE)
-Aqua.test_deps_compat(SIIP - PACKAGE)
+Aqua.test_unbound_args(SiennaTemplate)
+Aqua.test_undefined_exports(SiennaTemplate)
+Aqua.test_ambiguities(SiennaTemplate)
+Aqua.test_stale_deps(SiennaTemplate)
+Aqua.test_deps_compat(SiennaTemplate)
 
 LOG_FILE = "power-systems.log"
 LOG_LEVELS = Dict(