Capgemini / Capgemini/microsoft-team-labs
General Project and Development Hub Set Up
- Dominant language
- JavaScript
- Stars
- 3
- Forks
- 2
- PR merge metrics
- No merged PRs in 30d
Description
Development Hub will be great for running an efficient CI/CD. Overall though, it’s taken us a bit longer than we’d hoped to get up and running. Possibly some finger trouble at our end. The instructions are pretty good - here are just some suggested tweaks that might make it easier to follow.
1. The main issue is that the end-to-end series of steps from Yeoman install through to ADO integration is obviously quite long. The likelihood of making a mistake is high. The following could be provided at the start:
- Estimate of time involved.
- High-level summary of the stages with diagram.
1. Highlight the prerequisites that can be set up beforehand: Dev environment, Target environment, ADO and Approvals connections, ADO project, service principal, service account, local project folder, pac CLI, Yeoman.
1. Most of the parameters can then be gathered before diving in. Perhaps provide a check list of these at the start, indicating the stages where they are used? Then they can be simply pasted in in sequence.
1. Naming
- More self-explanatory names like DevEnv, TargetEnv, MyPackage, MySolution etc.
- Main not master for ADO branch
1. Statements to be run could be highlighted on a separate line from the rest of the text.
1. Add section in Project Generator instructions to check that install of Microsoft Xrm modules and the four cmdlets has succeeded. Get-Module, Get-Help “Crm”.
1. PowerShell version issue: we were seeing an alert about Import-CrmPackage not being compatible with PS Core.
1. There’s a prompt to enter the name of the pac auth connection, but this is not needed?
1. Deployment of the Development Hub can be independent of the Project Generator. Could these manual steps be provided as an alternative option as it’s the latter that is more time-consuming?
Contributor guide
No contributing guide indexed for this repository
Research direction
Start with the Development Hub instructions and the Project Generator instructions, tracing the full path from Yeoman installation through ADO integration. Document the requested prerequisites, parameters, naming and command formatting, PowerShell compatibility checks, and an independent manual deployment option, with the revised sequence and setup requirements clear to follow.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- powershell
- Domain
- devops, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100