Skip to content

Commit

Permalink
Adding documentation with mkdocs
Browse files Browse the repository at this point in the history
  • Loading branch information
ahmed-shariff committed Mar 25, 2024
1 parent d6d9019 commit 235ca14
Show file tree
Hide file tree
Showing 5 changed files with 549 additions and 1 deletion.
5 changes: 5 additions & 0 deletions docs/documentation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# ::: experiment_server.Experiment
# ::: experiment_server.Client

# ::: experiment_server.server_process
1 change: 1 addition & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
--8<-- "README.md"
55 changes: 55 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
site_name: experiment-server
site_url: https://example.com/
repo_url: https://github.com/ahmed-shariff/experiment_server/
repo_name: 'GitHub'

theme:
name: material
palette:

# Palette toggle for automatic mode
- media: "(prefers-color-scheme)"
toggle:
icon: material/brightness-auto
name: Switch to light mode

# Palette toggle for light mode
- media: "(prefers-color-scheme: light)"
scheme: default
toggle:
icon: material/brightness-7
name: Switch to dark mode

# Palette toggle for dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
toggle:
icon: material/brightness-4
name: Switch to system preference

plugins:
- search
- mkdocstrings:
default_handler: python
handlers:
python:
options:
show_source: false
show_root_heading: true
heading_level: 2
parameter_headings: true
show_symbol_type_heading: true

nav:
- Introduction: 'index.md'
- Documentation: 'documentation.md'

markdown_extensions:
- toc:
permalink: true
toc_depth: 3
- pymdownx.snippets:
check_paths: true
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.superfences
Loading

0 comments on commit 235ca14

Please sign in to comment.