Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jd/fixdocs2 #28

Merged
merged 32 commits into from
Feb 7, 2024
Merged
Show file tree
Hide file tree
Changes from 28 commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
f850d02
change authors
jd-lara Jan 11, 2024
cddfaec
remove unused content
jd-lara Jan 11, 2024
bb1cf45
more changes
jd-lara Jan 11, 2024
419f6a7
change bottom of page
jd-lara Jan 11, 2024
91c54a5
Update docs/src/index.md
jd-lara Jan 11, 2024
bc03230
change authors
jd-lara Jan 11, 2024
3e7a9bf
remove unused content
jd-lara Jan 11, 2024
1c8c858
more changes
jd-lara Jan 11, 2024
9e0b936
change bottom of page
jd-lara Jan 11, 2024
ab48947
Update docs/src/index.md
jd-lara Jan 11, 2024
bdac73f
Merge branch 'jd/fix_docs' of https://github.com/NREL-Sienna/StorageS…
jd-lara Feb 5, 2024
1276e9d
add model to documentation
jd-lara Feb 6, 2024
5f0beba
minor changes
jd-lara Feb 6, 2024
8773f8e
Merge pull request #26 from NREL-Sienna/jd/fix_docs
jd-lara Feb 6, 2024
2dc47ae
dont force older julia versions
jd-lara Feb 6, 2024
306654d
Merge branch 'jd/fixdocs2' of https://github.com/NREL-Sienna/StorageS…
jd-lara Feb 6, 2024
1606fcd
fix tests
jd-lara Feb 6, 2024
566cecf
reduce docs dependencies
jd-lara Feb 6, 2024
70cd530
improve documentation
jd-lara Feb 6, 2024
c7c1dc8
add more pages to docs
jd-lara Feb 6, 2024
bfdbc19
formatter
jd-lara Feb 6, 2024
a66afae
include more documentation details
jd-lara Feb 6, 2024
34c19dc
add more docs pages
jd-lara Feb 7, 2024
c65d9df
add PSI dependency
jd-lara Feb 7, 2024
8bef253
formatter
jd-lara Feb 7, 2024
2f0d6e5
Update docs/src/tutorials/simulation_tutorial.md
jd-lara Feb 7, 2024
9397504
Update docs/src/formulation_library/StorageDispatchWithReserves.md
jd-lara Feb 7, 2024
d9a7efc
Update docs/src/index.md
jd-lara Feb 7, 2024
1006c52
Update docs/src/quick_start_guide.md
jd-lara Feb 7, 2024
2f2ed5f
more formatter
jd-lara Feb 7, 2024
9d76989
formatter again
jd-lara Feb 7, 2024
3458829
add badge to README
jd-lara Feb 7, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ jobs:
- uses: actions/checkout@v2
- uses: julia-actions/setup-julia@v1
with:
version: '1.6'
version: '1'
- name: Install dependencies
run: julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()'
- name: Build and deploy
Expand Down
12 changes: 5 additions & 7 deletions docs/Project.toml
Original file line number Diff line number Diff line change
@@ -1,18 +1,16 @@
[deps]
CSV = "336ed68f-0bac-5ca0-87d4-7b16caf5d00b"
Cbc = "9961bab8-2fa3-5c5a-9d89-47fab24efd76"
DataFrames = "a93c6f00-e57d-5684-b7b6-d8193f3e46c0"
DataStructures = "864edb3b-99cc-5e75-8d2d-829cb0a9cfe8"
Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
DocumenterTools = "35a29f4d-8980-5a13-9543-d66fff28ecb8"
GLPK = "60bf3e95-4087-53dc-ae20-288a0d20c6a6"
HiGHS = "87dc4568-4c63-4d18-b0c0-bb2238e4078b"
InfrastructureSystems = "2cd47ed4-ca9b-11e9-27f2-ab636a7671f1"
Latexify = "23fbe1c1-3f47-55db-b15f-69d7ec21a316"
StorageSystemsSimulations = "e2f1a126-19d0-4674-9252-42b2384f8e3c"
PowerSimulations = "e690365d-45e2-57bb-ac84-44ba829e73c4"
PowerSystemCaseBuilder = "f00506e0-b84f-492a-93c2-c0a9afc4364e"
PowerSystems = "bcd98974-b02a-5e2f-9ee0-a103f5c450dd"
TimeSeries = "9e3dc215-6440-5c97-bce1-76c03772f85e"
StorageSystemsSimulations = "e2f1a126-19d0-4674-9252-42b2384f8e3c"

[compat]
Documenter = "0.27"
Documenter = "1"
InfrastructureSystems = "1"
julia = "^1.6"
13 changes: 8 additions & 5 deletions docs/make.jl
Original file line number Diff line number Diff line change
Expand Up @@ -6,25 +6,28 @@ using DataStructures
pages = OrderedDict(
"Welcome Page" => "index.md",
"Quick Start Guide" => "quick_start_guide.md",
"Code Base Developer Guide" =>
Any["Developer Guide" => "code_base_developer_guide/developer.md",],
"Formulation Library" => Any["Storage" => "formulation_library/Storage.md",],
"Tutorials" =>
Any["tutorials/single_stage_model.md", "tutorials/simulation_tutorial.md"],
"Formulation Library" =>
Any["StorageDispatchWithReserves" => "formulation_library/StorageDispatchWithReserves.md",],
"Code Base Developer Guide" => "code_base_developer_guide/developer.md",
"API Reference" => "api/StorageSystemsSimulations.md",
)

makedocs(;
modules=[StorageSystemsSimulations],
format=Documenter.HTML(; prettyurls=haskey(ENV, "GITHUB_ACTIONS")),
warnonly=[:missing_docs],
sitename="StorageSystemsSimulations.jl",
authors="Sourabh Dalvi, Jose Daniel Lara",
authors="Jose Daniel Lara, Rodrigo Henriquez-Auba, Sourabh Dalvi",
pages=Any[p for p in pages],
)

deploydocs(;
repo="github.com/NREL-Sienna/StorageSystemsSimulations.jl.git",
target="build",
branch="gh-pages",
devbranch="master",
devbranch="main",
devurl="dev",
push_preview=true,
versions=["stable" => "v^", "v#.#"],
Expand Down
14 changes: 1 addition & 13 deletions docs/src/api/StorageSystemsSimulations.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,24 +7,12 @@ DocTestSetup = quote
end
```

API documentation

```@contents
Pages = ["StorageSystemsSimulations.md"]
```

## Index

```@index
Pages = ["StorageSystemsSimulations.md"]
```

## Exported

```@autodocs
Modules = [StorageSystemsSimulations]
Private = false
Filter = t -> typeof(t) === DataType ? !(t <: Union{StorageSystemsSimulations.AbstractStorageFormulation}) : true
Filter = t -> typeof(t) === DataType ? !(t <: StorageSystemsSimulations.AbstractStorageFormulation) : true
```

## Internal
Expand Down
4 changes: 2 additions & 2 deletions docs/src/code_base_developer_guide/developer.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Guidelines for Developers

In order to contribute to `PowerSystems.jl` repository please read the following sections of
In order to contribute to `StorageSystemsSimulations.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/PowerSystems.jl/blob/master/CONTRIBUTING.md)
2. [Contributing Guidelines](https://github.com/NREL-Sienna/StorageSystemsSimulations.jl/blob/master/CONTRIBUTING.md)

Pull requests are always welcome to fix bugs or add additional modeling capabilities.

Expand Down
15 changes: 0 additions & 15 deletions docs/src/formulation_library/README.md

This file was deleted.

244 changes: 0 additions & 244 deletions docs/src/formulation_library/Storage.md

This file was deleted.

Loading
Loading