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
2 changes: 0 additions & 2 deletions .coveragerc
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,3 @@ omit =
examples/*
docs/*
*/__init__.py


16 changes: 8 additions & 8 deletions .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -27,14 +27,14 @@ repos:
- id: isort
args: ["--profile", "black"]

# MyPy - Type checking
- repo: https://github.com/pre-commit/mirrors-mypy
rev: v1.18.2
hooks:
- id: mypy
additional_dependencies: []
args: [--ignore-missing-imports]
files: ^(fynx|tests)/
# MyPy - Type checking, disabled for now
# - repo: https://github.com/pre-commit/mirrors-mypy
# rev: v1.18.2
# hooks:
# - id: mypy
# additional_dependencies: []
# args: [--ignore-missing-imports]
# files: ^(fynx|tests)/

# General pre-commit hooks
- repo: https://github.com/pre-commit/pre-commit-hooks
Expand Down
171 changes: 105 additions & 66 deletions README.md

Large diffs are not rendered by default.

18 changes: 10 additions & 8 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,14 @@ docs/
├── README.md # This file
├── index.md # Main landing page (MkDocs compatible)
├── generation/ # Documentation generation files
│ ├── mkdocs.yml # MkDocs configuration
│ ├── markdown/ # Generated markdown documentation
│ │ └── api.md # API reference (processed by mkdocstrings)
│ ├── markdown/ # Documentation source files
│ │ ├── mkdocs.yml # MkDocs configuration
│ │ ├── tutorial/ # Tutorial content
│ │ ├── reference/ # API reference documentation
│ │ └── mathematical/ # Mathematical foundations
│ └── scripts/ # Documentation generation scripts
│ ├── generate_html.py # HTML documentation generator
│ └── preview_docs.sh # Preview server launcher
│ └── preview_html_docs.sh # Preview server launcher
├── images/ # Universal images and assets
│ ├── banner.svg # Main logo/banner for documentation
│ ├── fynx_icon.svg # Icon for favicons and logos
Expand All @@ -34,14 +36,14 @@ python docs/generation/scripts/generate_html.py
### Previewing Documentation

```bash
bash docs/generation/scripts/preview_docs.sh
bash docs/generation/scripts/preview_html_docs.sh
```

This will:
1. Build HTML documentation using MkDocs with mkdocstrings
2. Output to the `site/` directory
2. Start a local development server at http://localhost:8000

### Adding New Pages

1. Create markdown files directly in the `docs/` directory
2. Add entries to the `nav` section in `docs/build/mkdocs.yml`
1. Create markdown files in the appropriate subdirectory (`tutorial/`, `reference/`, or `mathematical/`)
2. Add entries to the `nav` section in `docs/generation/markdown/mkdocs.yml`
591 changes: 591 additions & 0 deletions docs/generation/markdown/assets/images/banner.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -13,4 +13,4 @@ window.MathJax = {

document$.subscribe(() => {
MathJax.typesetPromise?.(); // ensure Promise exists to avoid type errors
});
});
Loading
Loading