Skip to content

feat(site): add docs portal and adopt new PL/SQL branding icon#2

Merged
bortoloso merged 2 commits into
mainfrom
site
May 3, 2026
Merged

feat(site): add docs portal and adopt new PL/SQL branding icon#2
bortoloso merged 2 commits into
mainfrom
site

Conversation

@bortoloso
Copy link
Copy Markdown
Owner

This PR introduces the documentation site foundation and applies the new selected v6 icon branding across the extension and docs.

What changed
Added a MkDocs Material documentation site structure with key project pages.
Added GitHub Pages workflow and local docs scripts for serve/build/test.
Updated docs visual styling for a cleaner landing-page experience.
Adopted the selected v6 icon as the canonical brand icon.
Applied icon assets to both extension and site (SVG + PNG).
Updated package metadata to 1.2.1.
Adjusted ignore rules so docs icon assets are tracked correctly.
Why
Improve project presentation and usability through a proper docs portal.
Keep branding consistent across Marketplace/VSIX and website.
Ensure icon rendering quality using finalized assets.
Validation performed
Ran docs validation build successfully.
Generated/validated icon assets in SVG and PNG.
Installed latest VSIX locally (1.2.1) with force update.
Confirmed clean git state after commit.
Commits included
aafce51 feat(site): add MkDocs Material site with GitHub Pages workflow and local dev scripts
a4eb2e4 feat(branding): adopt selected v6 icon across extension and docs

bortoloso added 2 commits May 2, 2026 22:01
…ocal dev scripts

- scaffold site structure in docs/ with 7 pages (index, overview, coverage, installation, roadmap, changelog, disclaimer)
- add custom CSS with hero layout, card grid, dark/light palette toggle
- add GitHub Pages deploy workflow (.github/workflows/pages.yml)
- add local dev scripts (serve-docs.sh, build-docs.sh, test-docs.sh) and requirements-docs.txt
- exclude site artifacts and venv from VSIX packaging and git
- add npm scripts for docs: docs:serve, docs:build, docs:test
- add extension marketplace metadata: icon, gallery banner, keywords
- add CI workflow for grammar validation (.github/workflows/ci.yml)
- bump version to 1.2.0 and add CHANGELOG entries
- set v6 as canonical icon in media (svg + png)
- add site icon assets under docs/assets (svg + png)
- update mkdocs branding to use svg icon assets
- keep docs assets tracked in gitignore rules
- include latest package metadata updates (version 1.2.1)
@bortoloso bortoloso merged commit 2dace58 into main May 3, 2026
1 check passed
@bortoloso bortoloso deleted the site branch May 3, 2026 01:43
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.

1 participant