Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
31 changes: 31 additions & 0 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
name: Documentation
on:
push:
branches:
- main
paths:
- zensical.toml
- docs/**
permissions:
contents: read
pages: write
id-token: write
jobs:
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
steps:
- uses: actions/configure-pages@v5
- uses: actions/checkout@v5
- uses: actions/setup-python@v5
with:
python-version: 3.x
- run: pip install zensical
- run: zensical build --clean
- uses: actions/upload-pages-artifact@v4
with:
path: site
- uses: actions/deploy-pages@v4
id: deployment
1 change: 1 addition & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# Some

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

While this is an initial setup, adding a brief description of the project to the index page provides immediate context for visitors. It is also recommended to include a trailing newline at the end of the file for POSIX compliance.

Suggested change
# Some
# Some
A Kotlin JVM library that generates populated instances of any Kotlin class for testing purposes, with zero configuration required.

2 changes: 2 additions & 0 deletions zensical.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
[project]
site_name = "Some"
Comment on lines +1 to +2

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

It is a best practice to end configuration files with a newline character. This ensures compatibility with POSIX-compliant tools and prevents 'No newline at end of file' warnings in version control systems.

Suggested change
[project]
site_name = "Some"
[project]
site_name = "Some"