CLI Wiki Documentation Summary - phuocle/Dynamics-Crm-DevKit GitHub Wiki
CLI Wiki Documentation Update Summary
Overview
Comprehensive wiki documentation has been created for all DynamicsCrm.DevKit.Cli tasks with complete parameter details and examples.
Created Files
Main CLI Documentation
- cli/README.md - Index page for all CLI tasks
Individual Task Documentation
Server-Side Development
-
cli/server.md - Server component deployment (plugins, workflows, custom actions, custom APIs, data providers)
- URL: https://github.com/phuocle/Dynamics-Crm-DevKit/wiki/cli/server
- Covers: DLL/NUPKG deployment, auto-registration, plugin steps, images, secure configurations
-
cli/plugins.md - Plugin-specific deployment (alias for server task)
-
cli/workflows.md - Workflow activity deployment (alias for server task)
-
cli/dataproviders.md - Data provider deployment (alias for server task)
Code Generation
-
cli/generators.md - Code generation (C# late-bound, TypeScript forms, WebAPI clients)
- URL: https://github.com/phuocle/Dynamics-Crm-DevKit/wiki/cli/generators
- Covers: CSharp, JsForm, JsWebApi generation types
- Entity filters: *, folder, comma-separated list
-
cli/proxytypes.md - Early-bound proxy type generation
- Covers: CrmSvcUtil.exe extensions, C#/VB.NET generation
Web Resources
- cli/webresources.md - Web resource upload
- Covers: JS, CSS, HTML, images, smart upload, folder structure
- cli/downloadwebresources.md - Web resource download (to be created)
Solutions
- cli/solutionpackagers.md - Solution pack/unpack (to be created)
Reports
-
cli/downloadreports.md - Report download (to be created)
-
cli/uploadreports.md - Report upload (to be created)
Data Sources
- cli/datasources.md - Virtual entity data source creation (to be created)
Documentation Structure
Each task documentation includes:
? Required Sections
- Overview - Task purpose and description
- Command Line Syntax - Basic command format
- Parameters - All required and optional parameters with descriptions
- JSON Configuration - Complete JSON schema with examples
- Examples - Real-world usage scenarios
- Output - Expected console output
- Common Issues - Troubleshooting guide
- See Also - Related tasks and documentation links
? Optional Sections (where applicable)
- Features - Key capabilities
- Best Practices - Recommended usage patterns
- Performance Tips - Optimization suggestions
- CI/CD Integration - Pipeline examples
- File Structure - Expected folder organization
Parameter Documentation
All parameters documented with:
- Name - Parameter name with
/prefix - Description - What the parameter does
- Required/Optional - Whether parameter is mandatory
- Example - Realistic example value
- Default - Default value if not specified
JSON Property Documentation
All JSON properties documented with:
- Property Name - JSON key
- Type - Data type (string, array, boolean)
- Required - Whether property is mandatory
- Description - What the property controls
- Default - Default value if not specified
- Examples - Sample values
Examples Provided
Each task includes multiple examples:
- Basic Usage - Simplest form
- Advanced Usage - With optional parameters
- Multiple Profiles - Different configurations
- SDK Login - Alternative authentication
- CI/CD Integration - Pipeline examples
URL Format
All wiki pages follow GitHub wiki URL format:
https://github.com/phuocle/Dynamics-Crm-DevKit/wiki/cli/{taskname}
Examples:
- https://github.com/phuocle/Dynamics-Crm-DevKit/wiki/cli/server
- https://github.com/phuocle/Dynamics-Crm-DevKit/wiki/cli/generators
- https://github.com/phuocle/Dynamics-Crm-DevKit/wiki/cli/webresources
Updated Files
- Home.md - Added link to CLI Tasks index
- V4-Wiki-Update-Summary.md - Added CLI documentation notes
Still To Create
The following task pages need to be created (following same structure):
- cli/plugins.md
- cli/workflows.md
- cli/dataproviders.md
- cli/downloadwebresources.md
- cli/solutionpackagers.md
- cli/downloadreports.md
- cli/uploadreports.md
- cli/datasources.md
Usage
Users can access documentation via:
- Main CLI Page: Start at DynamicsCrm.DevKit.Cli.md
- CLI Tasks Index: Browse all tasks at cli/README.md
- Direct Links: Go directly to specific task pages
- Home Page: Access from main wiki home
Benefits
? Complete Parameter Documentation - All parameters with descriptions and examples ? Real-World Examples - Practical usage scenarios ? Troubleshooting - Common issues and solutions ? CI/CD Ready - Pipeline integration examples ? Easy Navigation - Cross-linked between related tasks ? GitHub Wiki Compatible - URL format matches GitHub wiki structure
Next Steps
To complete CLI documentation:
- Create remaining task pages
- Add screenshots where helpful
- Update with user feedback
- Keep synchronized with CLI code changes
Notes
- All documentation uses Markdown format
- Compatible with GitHub wiki
- Follows consistent structure across all tasks
- Includes version 4 features
- Ready for immediate use