docs: add comprehensive documentation for TPPT, including installation, usage, and API reference

Author: ya7010

.gitignore

@@ -44,3 +44,6 @@ Thumbs.db
 # TypeScript
 node_modules/
 examples/*.pptx
+
+# Docs
+site/

docs/docs/api.md

@@ -0,0 +1,146 @@
+# API Reference
+
+## Presentation
+
+### Constructor
+
+```python
+Presentation(template: Optional[str] = None)
+```
+
+Creates a new presentation, optionally using a template.
+
+### Methods
+
+#### add_slide
+
+```python
+def add_slide(self, layout: Optional[str] = None) -> Slide
+```
+
+Adds a new slide to the presentation.
+
+#### save
+
+```python
+def save(self, filename: str, format: Optional[str] = None)
+```
+
+Saves the presentation to a file.
+
+## Slide
+
+### Methods
+
+#### add_title
+
+```python
+def add_title(self, text: str) -> Shape
+```
+
+Adds a title to the slide.
+
+#### add_text
+
+```python
+def add_text(self, text: str, x: Optional[float] = None, y: Optional[float] = None) -> Shape
+```
+
+Adds text to the slide at the specified position.
+
+#### add_image
+
+```python
+def add_image(
+    self,
+    image_path: str,
+    x: Optional[float] = None,
+    y: Optional[float] = None,
+    width: Optional[float] = None,
+    height: Optional[float] = None
+) -> Shape
+```
+
+Adds an image to the slide.
+
+#### add_table
+
+```python
+def add_table(
+    self,
+    data: List[List[Any]],
+    x: Optional[float] = None,
+    y: Optional[float] = None,
+    width: Optional[float] = None,
+    height: Optional[float] = None
+) -> Shape
+```
+
+Adds a table to the slide.
+
+#### add_shape
+
+```python
+def add_shape(
+    self,
+    shape_type: str,
+    x: float,
+    y: float,
+    width: float,
+    height: float
+) -> Shape
+```
+
+Adds a shape to the slide.
+
+## Shape
+
+### Properties
+
+- `fill_color: str` - The fill color of the shape
+- `line_color: str` - The line color of the shape
+- `line_width: float` - The line width of the shape
+- `text: str` - The text content of the shape
+- `font_name: str` - The font name for text
+- `font_size: float` - The font size for text
+- `font_bold: bool` - Whether the text is bold
+- `font_italic: bool` - Whether the text is italic
+
+### Methods
+
+#### set_position
+
+```python
+def set_position(self, x: float, y: float)
+```
+
+Sets the position of the shape.
+
+#### set_size
+
+```python
+def set_size(self, width: float, height: float)
+```
+
+Sets the size of the shape.
+
+## DataFrameSupport
+
+When using the pandas or polars support:
+
+### Methods
+
+#### add_dataframe
+
+```python
+def add_dataframe(
+    self,
+    df: Union[pd.DataFrame, pl.DataFrame],
+    x: Optional[float] = None,
+    y: Optional[float] = None,
+    width: Optional[float] = None,
+    height: Optional[float] = None
+) -> Shape
+```
+
+Adds a data frame as a table to the slide. 

docs/docs/contributing.md

@@ -0,0 +1,108 @@
+# Contributing to TPPT
+
+We welcome contributions to TPPT! This document provides guidelines and instructions for contributing to the project.
+
+## Development Setup
+
+1. Fork and clone the repository:
+```bash
+git clone https://github.com/yourusername/tppt.git
+cd tppt
+```
+
+2. Create a virtual environment and install dependencies:
+```bash
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+uv pip install -e ".[dev]"
+```
+
+## Development Tools
+
+TPPT uses several development tools:
+
+- **mypy**: Static type checking
+- **pyright**: Additional type checking
+- **ruff**: Code formatting and linting
+- **pytest**: Testing framework
+
+You can run all checks using:
+
+```bash
+task ci
+```
+
+Or run individual checks:
+
+```bash
+# Format code
+task format
+
+# Run linter
+task lint
+
+# Run type checker
+task typecheck
+
+# Run tests
+task test
+```
+
+## Pull Request Process
+
+1. Create a new branch for your feature:
+```bash
+git checkout -b feature/your-feature-name
+```
+
+2. Make your changes and commit them:
+```bash
+git add .
+git commit -m "Add your feature description"
+```
+
+3. Ensure all tests pass:
+```bash
+task ci
+```
+
+4. Push your changes and create a pull request:
+```bash
+git push origin feature/your-feature-name
+```
+
+5. Create a Pull Request on GitHub
+
+## Code Style
+
+- Follow PEP 8 guidelines
+- Use type hints for all function parameters and return values
+- Write docstrings for all public functions and classes
+- Keep functions focused and single-purpose
+- Write tests for new features
+
+## Testing
+
+- Write unit tests for new features
+- Ensure all tests pass before submitting a pull request
+- Add integration tests for complex features
+- Test edge cases and error conditions
+
+## Documentation
+
+When adding new features, please:
+
+1. Add docstrings to all new functions and classes
+2. Update the relevant documentation files
+3. Add examples if appropriate
+4. Update the changelog
+
+## Questions or Issues?
+
+If you have questions or run into issues:
+
+1. Check the existing issues on GitHub
+2. Create a new issue if needed
+3. Join our community discussions
+
+Thank you for contributing to TPPT!