Skip to content

draft: Bslv2 doc#85

Merged
hussainsultan merged 2 commits intobslv2from
bslv2-doc
Oct 30, 2025
Merged

draft: Bslv2 doc#85
hussainsultan merged 2 commits intobslv2from
bslv2-doc

Conversation

@boringdata
Copy link
Copy Markdown
Owner

No description provided.

Documentation Site:
- Build complete React documentation site with Vite, TypeScript, and Tailwind
- Add interactive BSL query examples with live results, SQL, and charts
- Implement collapsible code blocks for setup code
- Add syntax highlighting with Prism
- Add dark mode support with theme toggle
- Add left sidebar navigation with collapsible sections
- Remove right sidebar (Table of Contents)
- Add command palette for quick navigation
- Add responsive design for mobile and desktop

Documentation Content:
- Getting Started guide
- Building Semantic Tables (dimensions, measures, joins)
- Compose Models for multi-table queries
- YAML Configuration
- Query Methods (group_by, aggregate, filter, mutate, nest, window functions)
- as_table() documentation with problem/solution examples
- Charting with Altair and Plotly
- Advanced patterns: percentage of total, nested subtotals, bucketing, sessionized data, windowing
- Dimensional Indexing
- MCP Integration guide
- Complete API Reference

Features:
- Pre-compute query results at build time for fast page loads
- Execute Python code blocks and capture results, SQL, and charts
- Support for regularoutput component to show string/error results
- Markdown-based content with custom React components
- GitHub Pages deployment configuration
- CI workflow to test docs build

Bug Fixes:
- Fix as_table() bug: change 'dims' to 'dimensions' in expr.py
- Fix linting errors in build_data.py and chart.py
- Add proper exception handling and type hints

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
- Add custom BSL logo, favicon, and OG preview image
- Update meta tags to use new og-image.svg hosted on GitHub Pages
- Update canonical URL to point to boringdata.github.io
- Remove lovable-tagger dependency and references
- Clean up vite config by removing unused componentTagger plugin

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@hussainsultan hussainsultan merged commit d015069 into bslv2 Oct 30, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants