To address feedback about some confusion when following the guide (especially to do with service connections) I have refactored the document structure.
- Optional tasks / extra info has been moved down to either 'Further Exploration' (directly for getting started) or 'Next Steps' (specifically for integrating ML code.)
- Grammar fixes and simplified wording in parts
- Removed manual word wrapping to let autoformat do its thing
- Added a table of contents
- Update ARM service connection screenshot. Fixes#215
- Replace some outdated guide images. Fixes#210
* Rename pipeline and pipeline template YAMLs to new convention
* Rename references to pipelines and pipeline templates
* Sort pipeline entries in code_description.md
* State explicitly the flow order (Template as it is with Diabetes-> Bootstrap with your project code)
* Fix “multistage pipeline structure” explanation
* Clarify the R approach. It has only the model training. There is no evaluation/registration
* Fix the confusion with AzureResourceConnection and WORKSPACE_SVC_CONNECTION
* Explain using of a Docker image in the pipeline
* Link to bring-your-own-code (Bryan’s) article
* Fix broken links (e.g. diabetes_regression-ci-build-train.yml)
* Provide ML Service connection screenshot
* Explain explicit "diabetes" names. (e.g. The repo contains a sample “diabetes regression” project so here and there all names contain "diabetes")
* Clarify the folder structure (Common folders (e.g. .pipelines, ml_service) vs Project folders (e.g. diabetes_regression))