Add documentation, pre-commit hook, more make commands and

Makefile

@@ -9,34 +9,54 @@ help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 	@echo "Additional Commands:"
 	@echo "  make test         - Run all tests in 'tests/' with pytest"
-	@echo "  make lint         - Run ruff linter and auto-fix issues"
+	@echo "  make ruff-check   - Run Ruff linting and formatting checks (safe)"
+	@echo "  make ruff-clean   - Auto-fix Ruff linting and formatting issues"
 	@echo "  make docs         - Generate documentation (same as 'make html')"
-	@echo "  make clean_docs   - Remove generated docs"
+	@echo "  make clean-docs   - Remove generated docs"
 	@echo "  make docker-run   - Run the Docker container"
+	@echo "  make show-docs    - Build and open the documentation in a browser"
+
+
 
 .PHONY: test
 test:
 	@echo "Running tests..."
 	@pytest tests --disable-warnings
 
-.PHONY: lint
-lint:
-	@echo "Linting with ruff..."
-	@ruff check --fix .
+
+.PHONY: ruff-check
+ruff-check:
+	@echo "Checking code style with Ruff (safe)..."
+	@ruff check .
+
+
+.PHONY: ruff-clean
+ruff-clean:
+	@echo "Fixing lint and formatting issues with Ruff..."
+	@ruff check . --fix
+	@ruff format .
+
 
 .PHONY: docs
 docs:
 	@echo "Building documentation..."
 	@$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)"
 
-.PHONY: clean_docs
-clean_docs:
+
+.PHONY: clean-docs
+clean-docs:
 	@echo "Cleaning up generated documentation files..."
 	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 	@rm -rf "$(SOURCEDIR)/autoapi/" "$(SOURCEDIR)/modules/autogen/"
 	@echo "Cleanup complete."
 
 
+.PHONY: show-docs
+show-docs:
+	@echo "Opening documentation in browser..."
+	@open "$(BUILDDIR)/html/index.html"
+
+
 # Run Docker with default settings
 .PHONY: docker-run
 docker-run: