Repository navigation
Improve documentation website - #89
Merged
martinv13 merged 9 commits intoOct 25, 2026
Merged
Conversation
…e pages - pyproject: add keywords, Topic/Audience/Status classifiers and supported Python versions; describe the XSD-driven table generation in the summary. - README and docs home: add a worked example (XML to tables) and a "When to use xml2db" comparison with common alternatives. - New docs pages per backend (PostgreSQL, SQL Server, MySQL/MariaDB, DuckDB) covering connection, bulk loading, names and type advice. - New page on copying loaded tables from a DuckDB staging file to SQLite, Parquet, DuckLake and Delta Lake, with full and incremental copies (tested with DuckDB 2.0). - New "XSD to SQL tables" page on generating DDL from an XSD. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
- Introduction: add a "Load first, transform later" section, show the invoices XSD with the example, and use the same schema for the ERD. - New "Transform with dbt" page: raw schema as dbt sources, staging and flattening models, key-based incremental models, grain choice with deduplication, corrected records (tested with dbt-duckdb and dbt-postgres). - Other targets page: load into DuckDB, transform with SQL, then export the result; incremental Delta export filtered on the grain key; raw table copy kept as a secondary option. - README and DuckDB page: same ELT framing and links. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
Setting "reuse": False on the root table failed with an AttributeError while building the model. The root table is always deduplicated so that loads are idempotent, so raise a DataModelConfigError explaining it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
- Export page: drop SQLite; cover Parquet (with partitioning and object storage), loading into cloud warehouses from Parquet, Delta Lake, Iceberg, DuckLake, publishing transformed tables to a server database, DataFrames, and CSV/JSON/Excel extracts. Untested paths are worded as such. - Remove SQLite mentions from README, home page and DuckDB page. - Rephrase "X, not Y" style contrasts, and add a writing style rule against them in CLAUDE.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
Show the install command with duckdb_engine and pytz, the full test run against an in-memory DuckDB database, why TZ must be Europe/Paris, how to target another database, and the databases covered by CI. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
- Rename new pages to hyphenated, descriptive URLs before their first release: databases/sql-server, databases/export, xsd-to-sql. - Align page titles with search queries (home, getting started, CLI, how it works, XSD to SQL) and keep descriptions under 155 characters. - DuckDB page: add a section on reading XML with DuckDB extensions and when xml2db fits better. - Add Open Graph and Twitter tags for link previews. - Add internal links to the CLI, XSD to SQL, database and dbt pages. - Move the theme override out of docs/ so it is no longer published. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012tCdFJo9K4E39QdqU3Mxvv
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.