Open Issues Need Help
View All on GitHubAI Summary: Create comprehensive documentation for contributing to the Annie.io project, including a style guide, writing guidelines, templates, image guidelines, local development setup instructions, a review checklist, accessibility guidelines, content lifecycle documentation, and maintenance procedures. This will improve the contributor experience and ensure consistent, high-quality documentation.
AI Summary: Integrate analytics (Plausible, PostHog) and user feedback mechanisms (ratings, forms) into the Annie.io documentation website to track user behavior, gather improvement suggestions, and identify content gaps. This involves adding analytics tracking to templates, creating feedback components, and potentially setting up dashboards for data visualization. A/B testing and user journey tracking are also desired.
AI Summary: Create a comprehensive FAQ and troubleshooting guide for the Annie library, including sections on installation, performance tuning, error messages, compatibility, resource usage, migration from other libraries, and integrate it with the issue template. This involves creating new markdown files (`docs/faq.md`, `docs/troubleshooting.md`), updating the navigation, and potentially creating a searchable knowledge base.
AI Summary: Automate the generation of comprehensive API documentation for a Rust-powered k-NN library. This involves creating or enhancing a Python script to parse Rust and Python docstrings, generating detailed API documentation with parameter types, return values, error handling, cross-references, and versioning information, and integrating this into the existing documentation build process.
AI Summary: Enhance the Annie.io documentation by adding interactive code examples and demos using Pyodide for in-browser Python execution, embedding Jupyter notebooks, creating visual ANN search demonstrations (e.g., with D3.js), adding "Try it" buttons, performance comparison visualizations, step-by-step tutorials, copy-to-clipboard functionality for code blocks, and parameter sliders for distance metric comparisons. This involves modifying `docs/examples.md`, `mkdocs.yml`, and creating new JS/HTML components.