Skip to content

Commit

Permalink
Add minimal documentation stub (#40)
Browse files Browse the repository at this point in the history
  • Loading branch information
fingolfin authored May 17, 2023
1 parent 5cb2536 commit 601eb39
Show file tree
Hide file tree
Showing 6 changed files with 59 additions and 13 deletions.
26 changes: 13 additions & 13 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -36,16 +36,16 @@ jobs:
- uses: julia-actions/julia-processcoverage@v1
- uses: codecov/codecov-action@v3

# Documentation:
# runs-on: ubuntu-latest
# steps:
# - uses: actions/checkout@v3
# - uses: julia-actions/setup-julia@latest
# with:
# version: 1
# - uses: julia-actions/cache@v1
# with:
# cache-registries: "true"
# - uses: julia-actions/julia-docdeploy@releases/v1
# env:
# DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}
Documentation:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: julia-actions/setup-julia@latest
with:
version: 1
- uses: julia-actions/cache@v1
with:
cache-registries: "true"
- uses: julia-actions/julia-docdeploy@v1
env:
DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
Manifest.toml
/docs/build/
8 changes: 8 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# Scratch.jl

[![CI](https://github.com/JuliaPackaging/Scratch.jl/actions/workflows/ci.yml/badge.svg)](https://github.com/JuliaPackaging/Scratch.jl/actions/workflows/ci.yml)

[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://juliapackaging.github.io/Scratch.jl/stable)
[![](https://img.shields.io/badge/docs-latest-blue.svg)](https://juliapackaging.github.io/Scratch.jl/dev)

[![codecov](https://codecov.io/gh/JuliaPackaging/Scratch.jl/branch/master/graph/badge.svg)](https://codecov.io/gh/JuliaPackaging/Scratch.jl)


This repository implements the scratch spaces API for package-specific mutable containers of data.
These spaces can contain datasets, text, binaries, or any other kind of data that would be convenient to store in a location specific to your package.
As compared to [Artifacts](https://pkgdocs.julialang.org/v1/artifacts/), these containers of data are mutable.
Expand Down
5 changes: 5 additions & 0 deletions docs/Project.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
[deps]
Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"

[compat]
Documenter = "~0.27"
11 changes: 11 additions & 0 deletions docs/make.jl
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
using Documenter, Scratch

makedocs(
modules = [Scratch],
sitename = "Scratch.jl",
)

deploydocs(
repo = "github.com/JuliaPackaging/Scratch.jl.git",
push_preview = true,
)
20 changes: 20 additions & 0 deletions docs/src/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Scratch.jl Documentation

This is the reference documentation of
[`Scratch.jl`](https://github.com/JuliaPackaging/Scratch.jl).

## Index
```@index
```

## Macros
```@autodocs
Modules = [Scratch]
Order = [:macro]
```

## Functions
```@autodocs
Modules = [Scratch]
Order = [:function]
```

0 comments on commit 601eb39

Please sign in to comment.