Add public roadmap, VitePress documentation site, and GitHub Pages deployment#3
Conversation
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
|
用英文编写,诚恳地给最终用户看 @copilot |
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
|
@copilot 注意,这个文档是要给最终用户看的,不是内部文件 |
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
|
@copilot 现在初始化文档库,订立协议规范,基于这个文档库搭建vitepress |
Understood! I've completely rewritten it as a public roadmap for end users. Removed all internal details (team structure, budget, risk management) and focused on what users will get and when. The new Commit: 409bc37 |
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Completed! Initialized VitePress documentation site with full protocol specifications:
VitePress is running successfully. Start with: Commit: 49cc7ec |
|
@copilot docs在根目录就可以,然后编写自动化工作流把它发布成GitHub的网站 |
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Done! Moved docs to root directory and added automated GitHub Pages deployment:
The workflow will automatically deploy to GitHub Pages when changes are pushed to main. Site will be at: Commit: 9f1735e |
There was a problem hiding this comment.
Pull request overview
This PR establishes a comprehensive documentation infrastructure by creating a public roadmap document, initializing a VitePress documentation site with protocol specifications, and configuring automated GitHub Pages deployment for the Object UI project.
Changes:
- Created user-facing public roadmap (
docs/ROADMAP.md) outlining quarterly 2026 feature releases with practical examples and user-benefit focus - Initialized VitePress documentation site with homepage, guides, protocol specifications, and API references
- Set up automated GitHub Pages deployment workflow with pnpm caching and build optimization
Reviewed changes
Copilot reviewed 23 out of 25 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| docs/ROADMAP.md | 295-line English roadmap with Q1-Q4 2026 release timeline, feature examples, FAQ, and user-focused benefit statements |
| docs/.vitepress/config.mts | VitePress configuration with navigation, sidebar structure, search, and GitHub Pages base path |
| .github/workflows/deploy-docs.yml | GitHub Actions workflow for automated documentation deployment with Node 20 and pnpm 8 |
| docs/protocol/*.md | Eight protocol specification files (object, view, page, form, menu, app, report, overview) defining metadata schemas |
| docs/guide/*.md | Three guide files (introduction, quick-start, installation) for getting started documentation |
| docs/api/*.md | Four API reference files (core, react, components, designer) documenting package APIs |
| docs/index.md | VitePress homepage with hero section, features grid, and quick examples |
| docs/package.json | Workspace package configuration with VitePress 1.0.0 and dev/build/preview scripts |
| pnpm-workspace.yaml | Added docs directory to workspace packages |
| package.json | Added workspace entry and npm scripts for docs:dev, docs:build, docs:preview |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Introduces a new SVG logo in docs/public/logo.svg featuring a gradient background and UI layout symbols. This asset can be used for branding or documentation visuals.
- Fix handleExportCSV to guard on gridRef.current?.api (issue #1) - Add dedicated onContextMenuAction callback instead of overloading onCellClicked (issue #2) - Remove icon property from customItems to prevent HTML injection (issue #3) - Remove validation claim from README - only basic AG Grid editing (issue #4) - Add test assertions for all new inputs (editable, exportConfig, etc.) (issue #5) - Fix onExport type to only support 'csv' format (issue #6) - Remove unused ColumnConfig properties (autoSize, groupable) (issue #9) - Type schema props with proper interfaces instead of 'any' (issue #10) - Update export description to only mention CSV (issue #11) - Add AG Grid Community vs Enterprise section to docs (issue #8) - Update README and docs with new callback and clarifications All tests pass (8/8), lint clean (0 errors) Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
…warning, i18n fallback - Issue #1: Normalize `in`/`not in` operators to backend-compatible `or`/`and` of `=`/`!=` - Issue #2: Filter merging now validates and filters empty conditions - Issue #3: CSV export safely serializes arrays (semicolon-separated) and objects (JSON) - Issue #5: Request counter prevents stale data from overwriting latest results - Issue #6: PullToRefresh resets pull distance immediately to prevent UI lock - Issue #7: $top configurable via schema.pagination, data limit warning shown - Issue #8: Extended i18n fallback translations for all ListView labels - Issue #9: Defensive null checks in effectiveFields for mismatched objectDef - Issue #10: Added FilterNormalization, Export, and DataFetch test suites Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
Created a user-facing public roadmap document (
docs/ROADMAP.md) in English showing what features are coming and when users can expect them. Written sincerely for end users to help them evaluate Object UI and plan adoption.Additionally, initialized a complete VitePress documentation site with protocol specifications in the root
docs/directory and set up automated GitHub Pages deployment.Roadmap Document
Vision: Clear explanation of what Object UI is and who it's for ("JSON to world-class UI in minutes")
What Makes Us Different: User benefits explained simply (3x faster, 6x smaller bundles, easy to learn, full control)
Release Timeline: Quarterly feature releases (Q1-Q4 2026):
Feature Examples: Practical code snippets showing how to use each feature
What You Can Do Today: Available actions (try preview, star on GitHub, provide feedback)
Beyond 2026: Future vision (multi-framework, cross-platform, AI, 3D)
FAQ: 7 common questions answered (production-ready date, pricing, compatibility, migration)
Stay Updated: How to follow progress (GitHub, email)
296-line English markdown document focused entirely on user value. Each quarterly release includes practical examples and "What this means for you" benefit statements. Written in conversational, approachable language without internal planning details.
VitePress Documentation Site
Created a complete documentation site in the root
docs/directory with:Structure:
Features:
Commands:
pnpm docs:dev- Start development serverpnpm docs:build- Build for productionpnpm docs:preview- Preview production buildIntegration:
docs/directoryobject-ui-docspackagedocs/objectql/integratedGitHub Pages Deployment
Automated Workflow (
.github/workflows/deploy-docs.yml):mainbranch when docs changehttps://objectql.github.io/object-ui/Configuration:
/object-ui/for GitHub Pagesdocs/.vitepress/dist/.gitignoreRequirements:
The documentation site is now at the root level and will automatically deploy to GitHub Pages on every push to main! 🚀
Original prompt
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.