-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Update CONTRIBUTING.md * Add CODEOWNERS check to pull request template * Update CONTRIBUTING.md Goals section * Update CONTRIBUTING.md Goals section * Fix typos * Update CONTRIBUTING.md Non-goals section * Update wording for Non-goals * Update CONTRIBUTING.md additional resources * Update CONTRIBUTING.md links
- Loading branch information
1 parent
ca61383
commit 7771f39
Showing
2 changed files
with
7 additions
and
15 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -7,3 +7,4 @@ | |
- [ ] I have read the [contribution guidelines](https://github.com/Azure/azureml-examples/blob/main/CONTRIBUTING.md) | ||
- [ ] I have coordinated with the docs team ([email protected]) if this PR deletes files or changes any file names or file extensions. | ||
- [ ] Pull request includes test coverage for the included changes. | ||
- [ ] This notebook or file is added to the [CODEOWNERS](https://github.com/Azure/azureml-examples/blob/main/.github/CODEOWNERS) file, pointing to the author or the author's team. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -20,12 +20,12 @@ contact [[email protected]](mailto:[email protected]) with any additio | |
|
||
## Goals | ||
|
||
- source for all code snippets in documentation | ||
This repository contains notebooks and sample code that demonstrate how to develop and manage ML workflows using Azure Machine Learning v2 SDK and CLI. Use the samples in this repository to try out AzureML SDK and CLI scenarios from your local machine. | ||
|
||
## Non-goals | ||
|
||
- serve as documentation (see https://docs.microsoft.com/azure/machine-learning) | ||
- serve as scenario-specific project templates (coming soon!) | ||
- This repository is not meant to serve as reference documentation. Small code examples that are just comprehensive enough to show how an object or function works are categorized as reference documentation and should be placed in the object or function docstring in the [azure-ai-ml folder of the azure-sdk-for-python repository](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/ml/azure-ai-ml) following [these guidelines](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/ml/azure-ai-ml/documentation_guidelines.md). | ||
- This repository is not the place for long-form textual documentation. Documentation resources containing minimal or no code should be added in the [azure-docs repository](https://github.com/MicrosoftDocs/azure-docs). | ||
|
||
## Issues | ||
|
||
|
@@ -71,7 +71,7 @@ This will also generate a GitHub Actions workflow file for any new examples in t | |
|
||
### Discoverability | ||
|
||
Examples in this repository can be index in the [Microsoft code samples browser](https://docs.microsoft.com/samples), enabling organic discoverability. To accomplish this: | ||
Examples in this repository can be indexed in the [Microsoft code samples browser](https://docs.microsoft.com/samples), enabling organic discoverability. To accomplish this: | ||
|
||
- add an excellent `README.md` file in the example directory | ||
- add required YAML frontmatter at the top of the `README.md` | ||
|
@@ -92,14 +92,5 @@ description: Example description. | |
|
||
**Edit the description** and update the languages as needed. | ||
|
||
### CLI 2.0 | ||
|
||
[CLI contributing guide.](cli/CONTRIBUTING.md) | ||
|
||
### Python SDK | ||
|
||
[Python SDK contributing guide.](python-sdk/CONTRIBUTING.md) | ||
|
||
### Notebooks | ||
|
||
[Notebooks contributing guide.](notebooks/CONTRIBUTING.md) | ||
### Other resources | ||
* [CLI contributing guide.](cli/CONTRIBUTING.md) |