diff --git a/.gitignore b/.gitignore index ba4e60c6b..3068af6bf 100644 --- a/.gitignore +++ b/.gitignore @@ -1,7 +1,3 @@ -# Project specific - -BuildArtifacts/ - # Created by https://www.gitignore.io/api/cake,visualstudio ### Cake ### @@ -304,4 +300,9 @@ __pycache__/ # By default, sensitive information, such as encrypted password # should be stored in the .pubxml.user file. -# End of https://www.gitignore.io/api/cake,visualstudio \ No newline at end of file +# End of https://www.gitignore.io/api/cake,visualstudio + +# Project specific + +BuildArtifacts/ +docs/.cache/ \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json index ff1570829..be2f7b909 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,3 +1,15 @@ { - "dotnet.defaultSolution": "src\\Cake.Issues.sln" + "dotnet.defaultSolution": "src\\Cake.Issues.sln", + "yaml.schemas": { + "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml" + }, + "yaml.customTags": [ + "!ENV scalar", + "!ENV sequence", + "!relative scalar", + "tag:yaml.org,2002:python/name:material.extensions.emoji.to_svg", + "tag:yaml.org,2002:python/name:material.extensions.emoji.twemoji", + "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format", + "tag:yaml.org,2002:python/object/apply:pymdownx.slugs.slugify mapping" + ] } \ No newline at end of file diff --git a/docs/docs/blog/index.md b/docs/docs/blog/index.md new file mode 100644 index 000000000..0e6302856 --- /dev/null +++ b/docs/docs/blog/index.md @@ -0,0 +1,2 @@ +# News + diff --git a/docs/input/news/2020-08-22-cake-issues-v0.9.0-released.md b/docs/docs/blog/posts/2020-08-22-cake-issues-v0.9.0-released.md similarity index 81% rename from docs/input/news/2020-08-22-cake-issues-v0.9.0-released.md rename to docs/docs/blog/posts/2020-08-22-cake-issues-v0.9.0-released.md index 086df590d..5f6390b54 100644 --- a/docs/input/news/2020-08-22-cake-issues-v0.9.0-released.md +++ b/docs/docs/blog/posts/2020-08-22-cake-issues-v0.9.0-released.md @@ -1,11 +1,13 @@ --- title: Cake Issues v0.9.0 Released -category: Release Notes +date: 2020-08-22 +categories: + - Release Notes --- Cake Issues version 0.9.0 has been released. This is a major release bringing a lot of new features across all addins. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -14,15 +16,15 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [AdmiringWorm](https://github.com/AdmiringWorm) -* [christianbumann](https://github.com/christianbumann) -* [eoehen](https://github.com/eoehen) -* [gep13](https://github.com/gep13) -* [janniksam](https://github.com/janniksam) -* [mholo65](https://github.com/mholo65) -* [pascalberger](https://github.com/pascalberger) -* [Speeedy01](https://github.com/Speeedy01) -* [jokay](https://github.com/jokay) +* [AdmiringWorm](https://github.com/AdmiringWorm){target="_blank"} +* [christianbumann](https://github.com/christianbumann){target="_blank"} +* [eoehen](https://github.com/eoehen){target="_blank"} +* [gep13](https://github.com/gep13){target="_blank"} +* [janniksam](https://github.com/janniksam){target="_blank"} +* [mholo65](https://github.com/mholo65){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [Speeedy01](https://github.com/Speeedy01){target="_blank"} +* [jokay](https://github.com/jokay){target="_blank"} ## Full cross-platform support @@ -31,10 +33,11 @@ While in previous versions most parts of Cake Issues was already targeting .NET .NET Core. With this release `Cake.Issues.Reporting.Generic` was ported to also run on .NET Core. -The migration was done by [gep13](https://github.com/gep13) on his [Twitch stream](https://www.twitch.tv/gep13) and you -can watch work done in [Stream 90 - Working on Cake.Issues.Recipe](https://www.youtube.com/watch?v=7roa5Q6KcrQ), -[Stream 91 - Working on Cake.Issues.Reporting.Generic and Gazorator](https://www.youtube.com/watch?v=ocacOz3CxME) and -[Stream 92 - Working on Cake.Issues.Reporting.Generic and Gazorator - Part 2](https://www.youtube.com/watch?v=P0IpkL9gUAE). +The migration was done by [gep13](https://github.com/gep13){target="_blank"} on his +[Twitch stream](https://www.twitch.tv/gep13){target="_blank"} and you +can watch work done in [Stream 90 - Working on Cake.Issues.Recipe](https://www.youtube.com/watch?v=7roa5Q6KcrQ){target="_blank"}, +[Stream 91 - Working on Cake.Issues.Reporting.Generic and Gazorator](https://www.youtube.com/watch?v=ocacOz3CxME){target="_blank"} and +[Stream 92 - Working on Cake.Issues.Reporting.Generic and Gazorator - Part 2](https://www.youtube.com/watch?v=P0IpkL9gUAE){target="_blank"}. ## Enhanced issue information @@ -137,7 +140,7 @@ across all runs. [Cake.Issues.Recipe], the Cake Recipe script which you can integrate into your build script for easy integration of full feature issue management, has been updated to version 0.4.0, bringing all the new features of Cake.Issues 0.9.0. -[Cake.Issues.Recipe]: ../docs/recipe/overview +[Cake.Issues.Recipe]: ../../documentation/recipe/overview.md ## Updating from previous versions @@ -149,7 +152,7 @@ This section documents the most common changes which might be required: Older version are still supported for deserialization. * Cake.Issues.Markdownlint * `MarkdownlintLogFileFormat` alias has been renamed to `MarkdownlintV1LogFileFormat` - ([#116](https://github.com/cake-contrib/Cake.Issues.Markdownlint/issues/116)). + ([#116](https://github.com/cake-contrib/Cake.Issues.Markdownlint/issues/116){target="_blank"}). * Cake.Issues.PullRequest * `ReportIssuesToPullRequest` alias which accepts an issue provider, or a list of issue providers, and settings requires now settings of type `IReportIssuesToPullRequestFromIssueProviderSettings` instead of `ReportIssuesToPullRequestSettings` to @@ -165,30 +168,30 @@ This section documents the most common changes which might be required: * `HtmlDxDataGridOption.FileLinkSettings` has been removed. File link settings can now be defined while reading the issues. For details see [File linking]. - ([#265](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/issues/265)). + ([#265](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/issues/265){target="_blank"}). * `HtmlDxDataGridOption.JSZipLocation` has been split into `HtmlDxDataGridOption.JsZipLocation` and `HtmlDxDataGridOption.JsZipVersion` - ([#320](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/issues/320)). + ([#320](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/issues/320){target="_blank"}). * Cake.Issues.Recipe * Cake.Issues.Recipe requires at least Cake 0.38.0 For details see release notes of the individual addins: -* [Cake.Issues 0.9.0](https://github.com/cake-contrib/Cake.Issues/releases/tag/0.9.0) -* [Cake.Issues.MsBuild 0.9.0](https://github.com/cake-contrib/Cake.Issues.MsBuild/releases/tag/0.9.0) -* [Cake.Issues.InspectCode 0.9.0](https://github.com/cake-contrib/Cake.Issues.InspectCode/releases/tag/0.9.0) -* [Cake.Issues.DupFinder 0.9.0](https://github.com/cake-contrib/Cake.Issues.DupFinder/releases/tag/0.9.0) -* [Cake.Issues.GitRepository 0.9.0](https://github.com/cake-contrib/Cake.Issues.GitRepository/releases/tag/0.9.0) -* [Cake.Issues.Markdownlint 0.9.0](https://github.com/cake-contrib/Cake.Issues.Markdownlint/releases/tag/0.9.0) -* [Cake.Issues.EsLint 0.9.0](https://github.com/cake-contrib/Cake.Issues.EsLint/releases/tag/0.9.0) -* [Cake.Issues.DocFx 0.9.0](https://github.com/cake-contrib/Cake.Issues.DocFx/releases/tag/0.9.0) -* [Cake.Issues.PullRequests 0.9.0](https://github.com/cake-contrib/Cake.Issues.PullRequests/releases/tag/0.9.0) -* [Cake.Issues.PullRequests.AzureDevOps 0.9.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AzureDevOps/releases/tag/0.9.0) -* [Cake.Issues.PullRequests.AppVeyor 0.9.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AppVeyor/releases/tag/0.9.0) -* [Cake.Issues.Reporting 0.9.0](https://github.com/cake-contrib/Cake.Issues.Reporting/releases/tag/0.9.0) -* [Cake.Issues.Reporting.Generic 0.9.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/releases/tag/0.9.0) -* [Cake.Issues.Reporting.Sarif 0.9.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Sarif/releases/tag/0.9.0) -* [Cake.Issues.Recipe 0.4.0](https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/0.4.0) +* [Cake.Issues 0.9.0](https://github.com/cake-contrib/Cake.Issues/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.MsBuild 0.9.0](https://github.com/cake-contrib/Cake.Issues.MsBuild/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.InspectCode 0.9.0](https://github.com/cake-contrib/Cake.Issues.InspectCode/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.DupFinder 0.9.0](https://github.com/cake-contrib/Cake.Issues.DupFinder/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.GitRepository 0.9.0](https://github.com/cake-contrib/Cake.Issues.GitRepository/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.Markdownlint 0.9.0](https://github.com/cake-contrib/Cake.Issues.Markdownlint/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.EsLint 0.9.0](https://github.com/cake-contrib/Cake.Issues.EsLint/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.DocFx 0.9.0](https://github.com/cake-contrib/Cake.Issues.DocFx/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.PullRequests 0.9.0](https://github.com/cake-contrib/Cake.Issues.PullRequests/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.PullRequests.AzureDevOps 0.9.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AzureDevOps/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.PullRequests.AppVeyor 0.9.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AppVeyor/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.Reporting 0.9.0](https://github.com/cake-contrib/Cake.Issues.Reporting/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.Reporting.Generic 0.9.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.Reporting.Sarif 0.9.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Sarif/releases/tag/0.9.0){target="_blank"} +* [Cake.Issues.Recipe 0.4.0](https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/0.4.0){target="_blank"} [File linking]: #file-linking [Support for passing additional run information]: #support-for-passing-additional-run-information diff --git a/docs/input/news/2020-09-19-cake-issues-v0.9.1-released.md b/docs/docs/blog/posts/2020-09-19-cake-issues-v0.9.1-released.md similarity index 82% rename from docs/input/news/2020-09-19-cake-issues-v0.9.1-released.md rename to docs/docs/blog/posts/2020-09-19-cake-issues-v0.9.1-released.md index f1c3a2458..c906d3160 100644 --- a/docs/input/news/2020-09-19-cake-issues-v0.9.1-released.md +++ b/docs/docs/blog/posts/2020-09-19-cake-issues-v0.9.1-released.md @@ -1,12 +1,14 @@ --- title: Cake Issues v0.9.1 Released -category: Release Notes +date: 2020-09-19 +categories: + - Release Notes --- Version 0.9.1 of Cake Issues and Cake.Issues.PullRequests.AzureDevOps have been released. These are minor releases containing improvements and bug fixes. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,10 +17,10 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [christianbumann](https://github.com/christianbumann) -* [janniksam](https://github.com/janniksam) -* [pascalberger](https://github.com/pascalberger) -* [jokay](https://github.com/jokay) +* [christianbumann](https://github.com/christianbumann){target="_blank"} +* [janniksam](https://github.com/janniksam){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [jokay](https://github.com/jokay){target="_blank"} ## Easier file linking for manually created issues @@ -31,7 +33,7 @@ it become much more complicated for issues created using the `NewIssue` alias, w Cake.Issues 0.9.1 adds an `WithFileLinkSettings` method to `IIssueBuilder` where a file link setting object can be passed which does resolve the URL. -[file link infrastructure was moved to Cake.Issues]: cake-issues-v0.9.0-released#file-linking +[file link infrastructure was moved to Cake.Issues]: 2020-08-22-cake-issues-v0.9.0-released.md#file-linking ## Line range and column support in Azure DevOps pull request integration diff --git a/docs/input/news/2020-09-24-annotations.png b/docs/docs/blog/posts/2020-09-24-annotations.png similarity index 100% rename from docs/input/news/2020-09-24-annotations.png rename to docs/docs/blog/posts/2020-09-24-annotations.png diff --git a/docs/input/news/2020-09-24-cake-issues-recipe-v0.4.2-released.md b/docs/docs/blog/posts/2020-09-24-cake-issues-recipe-v0.4.2-released.md similarity index 75% rename from docs/input/news/2020-09-24-cake-issues-recipe-v0.4.2-released.md rename to docs/docs/blog/posts/2020-09-24-cake-issues-recipe-v0.4.2-released.md index 53a1730ba..088d2b4e0 100644 --- a/docs/input/news/2020-09-24-cake-issues-recipe-v0.4.2-released.md +++ b/docs/docs/blog/posts/2020-09-24-cake-issues-recipe-v0.4.2-released.md @@ -1,11 +1,13 @@ --- title: Cake Issues Recipe v0.4.2 released, bringing support for GitHub Actions -category: Release Notes +date: 2020-09-24 +categories: + - Release Notes --- Version 0.4.2 of Cake Issues Recipe has been released bringing support for GitHub Actions. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -14,8 +16,8 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [admiringworm](https://github.com/admiringworm) -* [pascalberger](https://github.com/pascalberger) +* [admiringworm](https://github.com/admiringworm){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Support for GitHub Actions @@ -34,10 +36,9 @@ Having issues available as annotations also means that they will be shown in pul It's planned to support remaining features like providing full issue report as artifact in a future release. -:::{.alert .alert-info} -Support for GitHub Actions integration is currently only available in Cake.Issues.Recipe, but not as a standalone addin. -It's planned to additionally provide a standalone addin which can be used outside of Cake.Issues.Recipe in the future. -::: +!!! info + Support for GitHub Actions integration is currently only available in Cake.Issues.Recipe, but not as a standalone addin. + It's planned to additionally provide a standalone addin which can be used outside of Cake.Issues.Recipe in the future. ## Updating from previous versions diff --git a/docs/input/news/2020-09-24-log-output.png b/docs/docs/blog/posts/2020-09-24-log-output.png similarity index 100% rename from docs/input/news/2020-09-24-log-output.png rename to docs/docs/blog/posts/2020-09-24-log-output.png diff --git a/docs/input/news/2020-09-24-pullrequest-integration.png b/docs/docs/blog/posts/2020-09-24-pullrequest-integration.png similarity index 100% rename from docs/input/news/2020-09-24-pullrequest-integration.png rename to docs/docs/blog/posts/2020-09-24-pullrequest-integration.png diff --git a/docs/input/news/2020-09-27-github-actions-addin.md b/docs/docs/blog/posts/2020-09-27-github-actions-addin.md similarity index 53% rename from docs/input/news/2020-09-27-github-actions-addin.md rename to docs/docs/blog/posts/2020-09-27-github-actions-addin.md index 3efe52714..936d495c2 100644 --- a/docs/input/news/2020-09-27-github-actions-addin.md +++ b/docs/docs/blog/posts/2020-09-27-github-actions-addin.md @@ -1,23 +1,25 @@ --- title: New GitHub Actions addin -category: Release Notes +date: 2020-09-27 +categories: + - Release Notes --- A new [Cake.Issues.PullRequest.GitHubActions addin] has been released which brings integration with GitHub Actions and GitHub pull requests. - + [Cake.Issues.PullRequest.GitHubActions addin] creates annotations from issues when running on GitHub Actions: -![Annotations](../docs/pull-request-systems/github-actions/githubactions-annotations.png "Annotations") +![Annotations](../../documentation/pull-request-systems/github-actions/githubactions-annotations.png "Annotations") These annotations will also be shown in pull requests on the related file / position, bringing first class integration for GitHub pull requests to Cake.Issues: -![Pull request integration](../docs/pull-request-systems/github-actions/githubactions-pullrequest-integration.png "Pull request integration") +![Pull request integration](../../documentation/pull-request-systems/github-actions/githubactions-pullrequest-integration.png "Pull request integration") This integration was [first released in Cake.Issues.Recipe 0.4.2] and has now been moved to its own addin, which can also be used outside of Cake.Issues.Recipe. -[Cake.Issues.PullRequest.GitHubActions addin]: ../docs/pull-request-systems/github-actions/ -[first released in Cake.Issues.Recipe 0.4.2]: cake-issues-recipe-v0.4.2-released +[Cake.Issues.PullRequest.GitHubActions addin]: ../../documentation/pull-request-systems/github-actions/index.md +[first released in Cake.Issues.Recipe 0.4.2]: 2020-09-24-cake-issues-recipe-v0.4.2-released.md diff --git a/docs/input/news/2020-10-09-cake-issues-pullrequests-v0.9.1-released.md b/docs/docs/blog/posts/2020-10-09-cake-issues-pullrequests-v0.9.1-released.md similarity index 78% rename from docs/input/news/2020-10-09-cake-issues-pullrequests-v0.9.1-released.md rename to docs/docs/blog/posts/2020-10-09-cake-issues-pullrequests-v0.9.1-released.md index b28c70819..4555b3a48 100644 --- a/docs/input/news/2020-10-09-cake-issues-pullrequests-v0.9.1-released.md +++ b/docs/docs/blog/posts/2020-10-09-cake-issues-pullrequests-v0.9.1-released.md @@ -1,12 +1,14 @@ --- title: Cake Issues PullRequests v0.9.1 Released -category: Release Notes +date: 2020-10-09 +categories: + - Release Notes --- Version 0.9.1 of Cake.Issues.PullRequests has been released. This is a minor releases containing bug fixes. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,9 +17,9 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [janniksam](https://github.com/janniksam) -* [pascalberger](https://github.com/pascalberger) -* [phlorian](https://github.com/phlorian) +* [janniksam](https://github.com/janniksam){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [phlorian](https://github.com/phlorian){target="_blank"} ## Don't post issues if a provider limit is set to 0 diff --git a/docs/input/news/2020-10-20-cake-issues-msbuild-v0.9.1-released.md b/docs/docs/blog/posts/2020-10-20-cake-issues-msbuild-v0.9.1-released.md similarity index 69% rename from docs/input/news/2020-10-20-cake-issues-msbuild-v0.9.1-released.md rename to docs/docs/blog/posts/2020-10-20-cake-issues-msbuild-v0.9.1-released.md index 051b2c9c6..a7a4bfabb 100644 --- a/docs/input/news/2020-10-20-cake-issues-msbuild-v0.9.1-released.md +++ b/docs/docs/blog/posts/2020-10-20-cake-issues-msbuild-v0.9.1-released.md @@ -1,12 +1,14 @@ --- title: Cake Issues MsBuild v0.9.1 Released -category: Release Notes +date: 2020-10-20 +categories: + - Release Notes --- Version 0.9.1 of MsBuild support for Cake.Issues has been released. This is a minor release containing improvements. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,10 +17,10 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [cho-trackman](https://github.com/cho-trackman) -* [eoehen](https://github.com/eoehen) -* [pascalberger](https://github.com/pascalberger) -* [jokay](https://github.com/jokay) +* [cho-trackman](https://github.com/cho-trackman){target="_blank"} +* [eoehen](https://github.com/eoehen){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [jokay](https://github.com/jokay){target="_blank"} ## Support for reading of errors @@ -27,9 +29,8 @@ Starting with version 0.9.1 it will also return errors. Reading of errors has been implemented for `MsBuildBinaryLogFileFormat` and `MsBuildXmlFileLoggerFormat`. For errors `IIssue.Priority` will be set to `IssuePriority.Error`. -:::{.alert .alert-info} -To keep previous behavior result after reading the issues can be filtered for `IIssue.Priority == IIssuePriority.Warning`. -::: +!!! info + To keep previous behavior result after reading the issues can be filtered for `IIssue.Priority == IIssuePriority.Warning`. ## Updating from previous versions diff --git a/docs/input/news/2020-12-01-cake-issues-recipe-v0.4.4-released.md b/docs/docs/blog/posts/2020-12-01-cake-issues-recipe-v0.4.4-released.md similarity index 73% rename from docs/input/news/2020-12-01-cake-issues-recipe-v0.4.4-released.md rename to docs/docs/blog/posts/2020-12-01-cake-issues-recipe-v0.4.4-released.md index c85db7238..89fc88980 100644 --- a/docs/input/news/2020-12-01-cake-issues-recipe-v0.4.4-released.md +++ b/docs/docs/blog/posts/2020-12-01-cake-issues-recipe-v0.4.4-released.md @@ -1,26 +1,28 @@ --- title: Cake Issues Recipe v0.4.4 released, bringing support for ESLint -category: Release Notes +date: 2020-12-01 +categories: + - Release Notes --- Version 0.4.4 of Cake Issues Recipe has been released bringing support for ESLint. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). -For details see [full release notes](https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/0.4.4). +For details see [full release notes](https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/0.4.4){target="_blank"}. ❤ Huge thanks to our community! This release would not have been possible without your support and contributions! ❤ People working on this release: -* [pascalberger](https://github.com/pascalberger) +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Support for ESLint -This version of Cake.Issues.Recipe brings support for issues reported by [ESLint](https://eslint.org/). -Currently supported are files generated using the [ESLint json formatter](https://eslint.org/docs/user-guide/formatters/#json) +This version of Cake.Issues.Recipe brings support for issues reported by [ESLint](https://eslint.org/){target="_blank"}. +Currently supported are files generated using the [ESLint json formatter](https://eslint.org/docs/user-guide/formatters/#json){target="_blank"} ## Updating from previous versions diff --git a/docs/input/news/2021-07-27-terraform-addin.md b/docs/docs/blog/posts/2021-07-27-terraform-addin.md similarity index 82% rename from docs/input/news/2021-07-27-terraform-addin.md rename to docs/docs/blog/posts/2021-07-27-terraform-addin.md index 114329390..0f561888f 100644 --- a/docs/input/news/2021-07-27-terraform-addin.md +++ b/docs/docs/blog/posts/2021-07-27-terraform-addin.md @@ -1,11 +1,13 @@ --- title: New addin for Terraform support -category: Release Notes +date: 2021-07-27 +categories: + - Release Notes --- A new [Cake.Issues.Terraform addin] has been released which adds support for reading issues from Terraform `validate` command.. - + [Cake.Issues.Terraform addin] brings support for Terraform to the Cake.Issues ecosystem. It allows to read the output of the Terraform `validate` command. @@ -14,4 +16,4 @@ ensure quality standards by validating Terraform files before merging or deployi When using a pull requests workflow it is also possible to have the issues reported by Terraform validate automatically reported as comments to pull request. -[Cake.Issues.Terraform addin]: ../docs/issue-providers/terraform/ +[Cake.Issues.Terraform addin]: ../../documentation/issue-providers/terraform/index.md diff --git a/docs/input/news/2021-07-28-cake-issues-v1.0.0-released.md b/docs/docs/blog/posts/2021-07-28-cake-issues-v1.0.0-released.md similarity index 76% rename from docs/input/news/2021-07-28-cake-issues-v1.0.0-released.md rename to docs/docs/blog/posts/2021-07-28-cake-issues-v1.0.0-released.md index 8c0931525..ad658977b 100644 --- a/docs/input/news/2021-07-28-cake-issues-v1.0.0-released.md +++ b/docs/docs/blog/posts/2021-07-28-cake-issues-v1.0.0-released.md @@ -1,13 +1,15 @@ --- title: Cake Issues v1.0.0 Released -category: Release Notes +date: 2021-07-28 +categories: + - Release Notes --- -More than 4 years after the [first commit for Cake.Prca](https://github.com/cake-contrib/Cake.Prca/commit/438b3a1a609e5b9cc9e6f8f489a73988f9ed1f4d), +More than 4 years after the [first commit for Cake.Prca](https://github.com/cake-contrib/Cake.Prca/commit/438b3a1a609e5b9cc9e6f8f489a73988f9ed1f4d){target="_blank"}, the predecessor of Cake Issues, we're happy to announce that Cake Issues version 1.0.0 has been released. This is a major release bringing a lot of new features across all addins. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -16,11 +18,11 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [eoehen](https://github.com/eoehen) -* [janniksam](https://github.com/janniksam) -* [pascalberger](https://github.com/pascalberger) -* [phlorian](https://github.com/phlorian) -* [jokay](https://github.com/jokay) +* [eoehen](https://github.com/eoehen){target="_blank"} +* [janniksam](https://github.com/janniksam){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [phlorian](https://github.com/phlorian){target="_blank"} +* [jokay](https://github.com/jokay){target="_blank"} ## Support for Cake 1.0 @@ -44,8 +46,8 @@ of what exact version of dependencies should be used. In the future more Cake Issues addins might be released in Frosting specific packages. [Cake Frosting]: https://cakebuild.net/docs/running-builds/runners/cake-frosting -[Cake.Issues.Reporting.Generic addin]: /docs/report-formats/generic/ -[Cake.Issues.Reporting.Generic]: https://www.nuget.org/packages/Cake.Issues.Reporting.Generic/ +[Cake.Issues.Reporting.Generic addin]: ../../documentation/report-formats/generic/index.md +[Cake.Issues.Reporting.Generic]: https://cakebuild.net/extensions/cake-issues-reporting-generic/ [Cake.Frosting.Issues.Reporting.Generic]: https://www.nuget.org/packages/Cake.Frosting.Issues.Reporting.Generic/ ## Support for arbitrary values in an issue @@ -59,7 +61,7 @@ While there are aliases to get provider type name (e.g. [MsBuildIssuesProviderTy not available through the `IIssueProvider` interface. There is a new `IIssueProvider.ProviderType` property which can be used to retrieve the provider type. -[MsBuildIssuesProviderTypeName]: /api/Cake.Issues.MsBuild/MsBuildIssuesAliases/0A221402 +[MsBuildIssuesProviderTypeName]: https://cakebuild.net/api/Cake.Issues.MsBuild/MsBuildIssuesAliases/0A221402 ## PDF export @@ -87,24 +89,23 @@ This section documents the most common changes which might be required: For issue providers inheriting from `BaseIssueProvider` no action is required to keep the same behavior as with previous versions, with the type name used as provider type. -:::{.alert .alert-info} -Cake.Recipe has not been updated to 1.0 yet. -::: +!!! info + Cake.Recipe has not been updated to 1.0 yet. For details see release notes of the individual addins: -* [Cake.Issues 1.0.0](https://github.com/cake-contrib/Cake.Issues/releases/tag/1.0.0) -* [Cake.Issues.MsBuild 1.0.0](https://github.com/cake-contrib/Cake.Issues.MsBuild/releases/tag/1.0.0) -* [Cake.Issues.InspectCode 1.0.0](https://github.com/cake-contrib/Cake.Issues.InspectCode/releases/tag/1.0.0) -* [Cake.Issues.DupFinder 1.0.0](https://github.com/cake-contrib/Cake.Issues.DupFinder/releases/tag/1.0.0) -* [Cake.Issues.GitRepository 1.0.0](https://github.com/cake-contrib/Cake.Issues.GitRepository/releases/tag/1.0.0) -* [Cake.Issues.Markdownlint 1.0.0](https://github.com/cake-contrib/Cake.Issues.Markdownlint/releases/tag/1.0.0) -* [Cake.Issues.EsLint 1.0.0](https://github.com/cake-contrib/Cake.Issues.EsLint/releases/tag/1.0.0) -* [Cake.Issues.DocFx 1.0.0](https://github.com/cake-contrib/Cake.Issues.DocFx/releases/tag/1.0.0) -* [Cake.Issues.Terraform 1.0.0](https://github.com/cake-contrib/Cake.Issues.Terraform/releases/tag/1.0.0) -* [Cake.Issues.PullRequests 1.0.0](https://github.com/cake-contrib/Cake.Issues.PullRequests/releases/tag/1.0.0) -* [Cake.Issues.PullRequests.AzureDevOps 1.0.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AzureDevOps/releases/tag/1.0.0) -* [Cake.Issues.PullRequests.AppVeyor 1.0.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AppVeyor/releases/tag/1.0.0) -* [Cake.Issues.Reporting 1.0.0](https://github.com/cake-contrib/Cake.Issues.Reporting/releases/tag/1.0.0) -* [Cake.Issues.Reporting.Generic 1.0.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/releases/tag/1.0.0) -* [Cake.Issues.Reporting.Sarif 1.0.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Sarif/releases/tag/1.0.0) +* [Cake.Issues 1.0.0](https://github.com/cake-contrib/Cake.Issues/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.MsBuild 1.0.0](https://github.com/cake-contrib/Cake.Issues.MsBuild/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.InspectCode 1.0.0](https://github.com/cake-contrib/Cake.Issues.InspectCode/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.DupFinder 1.0.0](https://github.com/cake-contrib/Cake.Issues.DupFinder/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.GitRepository 1.0.0](https://github.com/cake-contrib/Cake.Issues.GitRepository/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.Markdownlint 1.0.0](https://github.com/cake-contrib/Cake.Issues.Markdownlint/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.EsLint 1.0.0](https://github.com/cake-contrib/Cake.Issues.EsLint/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.DocFx 1.0.0](https://github.com/cake-contrib/Cake.Issues.DocFx/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.Terraform 1.0.0](https://github.com/cake-contrib/Cake.Issues.Terraform/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.PullRequests 1.0.0](https://github.com/cake-contrib/Cake.Issues.PullRequests/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.PullRequests.AzureDevOps 1.0.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AzureDevOps/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.PullRequests.AppVeyor 1.0.0](https://github.com/cake-contrib/Cake.Issues.PullRequests.AppVeyor/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.Reporting 1.0.0](https://github.com/cake-contrib/Cake.Issues.Reporting/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.Reporting.Generic 1.0.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/releases/tag/1.0.0){target="_blank"} +* [Cake.Issues.Reporting.Sarif 1.0.0](https://github.com/cake-contrib/Cake.Issues.Reporting.Sarif/releases/tag/1.0.0){target="_blank"} diff --git a/docs/input/news/2021-07-30-cake-issues-eslint-v1.0.1-released.md b/docs/docs/blog/posts/2021-07-30-cake-issues-eslint-v1.0.1-released.md similarity index 79% rename from docs/input/news/2021-07-30-cake-issues-eslint-v1.0.1-released.md rename to docs/docs/blog/posts/2021-07-30-cake-issues-eslint-v1.0.1-released.md index 8413a1d15..056935dbf 100644 --- a/docs/input/news/2021-07-30-cake-issues-eslint-v1.0.1-released.md +++ b/docs/docs/blog/posts/2021-07-30-cake-issues-eslint-v1.0.1-released.md @@ -1,12 +1,14 @@ --- title: Cake Issues ESLint v1.0.1 Released -category: Release Notes +date: 2021-07-30 +categories: + - Release Notes --- Version 1.0.1 of ESLint support for Cake.Issues has been released. This is a minor release containing bug fixes. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,9 +17,9 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [eoehen](https://github.com/eoehen) -* [pascalberger](https://github.com/pascalberger) -* [Speeedy01](https://github.com/Speeedy01) +* [eoehen](https://github.com/eoehen){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [Speeedy01](https://github.com/Speeedy01){target="_blank"} ## Bug fix for issues with line, column or rule diff --git a/docs/input/news/2021-08-04-cake-issues-recipe-v1.0.0-released.md b/docs/docs/blog/posts/2021-08-04-cake-issues-recipe-v1.0.0-released.md similarity index 84% rename from docs/input/news/2021-08-04-cake-issues-recipe-v1.0.0-released.md rename to docs/docs/blog/posts/2021-08-04-cake-issues-recipe-v1.0.0-released.md index f7bd27c13..12841c9e3 100644 --- a/docs/input/news/2021-08-04-cake-issues-recipe-v1.0.0-released.md +++ b/docs/docs/blog/posts/2021-08-04-cake-issues-recipe-v1.0.0-released.md @@ -1,6 +1,8 @@ --- title: Cake Issues Recipe v1.0.0 Released, bringing support for Cake Frosting -category: Release Notes +date: 2021-08-04 +categories: + - Release Notes --- Hard on the heels of the [announcement for release 1.0 of Cake.Issues addins], @@ -8,9 +10,9 @@ we're happy to announce release 1.0 of the recipe script for Cake.Issues. This is a major release bringing support for Cake Frosting and other new features. -[announcement for release 1.0 of Cake.Issues addins]: /news/cake-issues-v1.0.0-released +[announcement for release 1.0 of Cake.Issues addins]: 2021-07-28-cake-issues-v1.0.0-released.md - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -19,7 +21,7 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [pascalberger](https://github.com/pascalberger) +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Support for Cake 1.0 @@ -37,7 +39,7 @@ See [Using Cake.Frosting.Issues.Recipe] for an example. [Cake Frosting]: https://cakebuild.net/docs/running-builds/runners/cake-frosting [Cake.Issues.Recipe]: https://www.nuget.org/packages/Cake.Issues.Recipe/ [Cake.Frosting.Issues.Recipe]: https://www.nuget.org/packages/Cake.Frosting.Issues.Recipe/ -[Using Cake.Frosting.Issues.Recipe]: /docs/recipe/usage/using-cake-frosting-issues-recipe +[Using Cake.Frosting.Issues.Recipe]: ../../documentation/recipe/usage/using-cake-frosting-issues-recipe.md ## Support for environments not compatible with Cake.Git addin @@ -46,7 +48,7 @@ While this works in most cases, there are some environments where [Cake.Git addi Starting with this version it is now possible to define if [Cake.Git addin] or Git CLI should be used. -See [Git repository information configuration](/docs/recipe/configuration#git-repository-information) for details. +See [Git repository information configuration](../../documentation/recipe/configuration.md#git-repository-information) for details. [Cake.Git addin]: https://cakebuild.net/extensions/cake-git/ @@ -81,6 +83,4 @@ This section documents the most common changes which might be required: IssuesParameters.InputFiles.AddMsBuildXmlFileLoggerLogFile(@"c:\build\msbuild.log"); ``` -For details see [full release notes]. - -[full release notes]: https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/1.0.0 +For details see [full release notes](https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/1.0.0){target="_blank"} diff --git a/docs/input/news/2021-08-11-cake-issues-recipe-v1.1.0-released.md b/docs/docs/blog/posts/2021-08-11-cake-issues-recipe-v1.1.0-released.md similarity index 92% rename from docs/input/news/2021-08-11-cake-issues-recipe-v1.1.0-released.md rename to docs/docs/blog/posts/2021-08-11-cake-issues-recipe-v1.1.0-released.md index 152faa0d8..a2ce616db 100644 --- a/docs/input/news/2021-08-11-cake-issues-recipe-v1.1.0-released.md +++ b/docs/docs/blog/posts/2021-08-11-cake-issues-recipe-v1.1.0-released.md @@ -1,11 +1,13 @@ --- title: Cake Issues Recipes v1.1.0 released -category: Release Notes +date: 2021-08-11 +categories: + - Release Notes --- Version 1.1.0 of Cake Issues recipes have been released adding support to customize report generation. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -14,7 +16,7 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [pascalberger](https://github.com/pascalberger) +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Report customization diff --git a/docs/input/news/2021-08-19-cake-issues-recipe-v1.2.0-released.md b/docs/docs/blog/posts/2021-08-19-cake-issues-recipe-v1.2.0-released.md similarity index 85% rename from docs/input/news/2021-08-19-cake-issues-recipe-v1.2.0-released.md rename to docs/docs/blog/posts/2021-08-19-cake-issues-recipe-v1.2.0-released.md index 2c270090e..1e7736dea 100644 --- a/docs/input/news/2021-08-19-cake-issues-recipe-v1.2.0-released.md +++ b/docs/docs/blog/posts/2021-08-19-cake-issues-recipe-v1.2.0-released.md @@ -1,11 +1,13 @@ --- title: Cake Issues Recipes v1.2.0 released -category: Release Notes +date: 2021-08-19 +categories: + - Release Notes --- Version 1.2.0 of Cake Issues recipes have been released adding support to customize issue reporting to pull requests. - + This post shows the highlights included in this release. For details see [full release notes]. @@ -15,7 +17,7 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [pascalberger](https://github.com/pascalberger) +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Customization of pull request integration @@ -40,5 +42,5 @@ context.Parameters.PullRequestSystem.MaxIssuesToPost = 20; Cake Issues recipes 1.2.0 are compatible with version 1.x without any breaking changes. To update to the new version bump the version in your build. -[Pull request integration parameters]: /docs/recipe/configuration#pull-request-integration +[Pull request integration parameters]: ../../documentation/recipe/configuration.md#pull-request-integration [full release notes]: https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/1.2.0 diff --git a/docs/input/news/2021-08-29-console-addin.md b/docs/docs/blog/posts/2021-08-29-console-addin.md similarity index 78% rename from docs/input/news/2021-08-29-console-addin.md rename to docs/docs/blog/posts/2021-08-29-console-addin.md index 5398da538..7f20ce3c8 100644 --- a/docs/input/news/2021-08-29-console-addin.md +++ b/docs/docs/blog/posts/2021-08-29-console-addin.md @@ -1,14 +1,16 @@ --- title: New addin for printing issues to console -category: Release Notes +date: 2021-08-29 +categories: + - Release Notes --- A new [Cake.Issues.Reporting.Console addin] has been released which allows to output issues to the console. - + [Cake.Issues.Reporting.Console addin] can be used to print issues to the console and is built on top -of the excellent [Errata library] by Patrik Svensson. +of the excellent [Errata library](https://github.com/spectreconsole/errata){target="_blank"} by Patrik Svensson. Its main focus is to annotate source code with issues: @@ -27,5 +29,4 @@ Another summary shows the number of issues by priority for every provider and ru ![Summary of priorities](2021-08-29-summary-of-priorities.png "Summary of priorities") -[Cake.Issues.Reporting.Console addin]: /docs/report-formats/console/ -[Errata library]: https://github.com/spectreconsole/errata +[Cake.Issues.Reporting.Console addin]: ../../documentation/report-formats/console/index.md diff --git a/docs/input/news/2021-08-29-diagnostics.png b/docs/docs/blog/posts/2021-08-29-diagnostics.png similarity index 100% rename from docs/input/news/2021-08-29-diagnostics.png rename to docs/docs/blog/posts/2021-08-29-diagnostics.png diff --git a/docs/input/news/2021-08-29-summary-by-provider.png b/docs/docs/blog/posts/2021-08-29-summary-by-provider.png similarity index 100% rename from docs/input/news/2021-08-29-summary-by-provider.png rename to docs/docs/blog/posts/2021-08-29-summary-by-provider.png diff --git a/docs/input/news/2021-08-29-summary-of-priorities.png b/docs/docs/blog/posts/2021-08-29-summary-of-priorities.png similarity index 100% rename from docs/input/news/2021-08-29-summary-of-priorities.png rename to docs/docs/blog/posts/2021-08-29-summary-of-priorities.png diff --git a/docs/input/news/2021-08-31-cake-issues-markdownlint-v1.1.0.md b/docs/docs/blog/posts/2021-08-31-cake-issues-markdownlint-v1.1.0.md similarity index 75% rename from docs/input/news/2021-08-31-cake-issues-markdownlint-v1.1.0.md rename to docs/docs/blog/posts/2021-08-31-cake-issues-markdownlint-v1.1.0.md index 3853e97e9..a63d6b2dc 100644 --- a/docs/input/news/2021-08-31-cake-issues-markdownlint-v1.1.0.md +++ b/docs/docs/blog/posts/2021-08-31-cake-issues-markdownlint-v1.1.0.md @@ -1,12 +1,14 @@ --- title: Cake Issues Markdownlint v1.1.0 Released -category: Release Notes +date: 2021-08-31 +categories: + - Release Notes --- Version 1.1.0 of Markdownlint support for Cake.Issues has been released. This is a minor release adding features and improvements. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,7 +17,7 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [pascalberger](https://github.com/pascalberger) +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Support for markdownlint-cli JSON format @@ -37,6 +39,6 @@ adding support for markdownlint-cli JSON files. Cake.Issues.Markdownlint 1.1.0 is compatible with version 1.0.0 without any breaking changes. To update to the new version bump the version of the addin. -[MarkdownlintCliJsonLogFileFormat]: /api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/36DE6F5F -[MarkdownlintCliLogFileFormat]: /api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/B518F49E -[Cake Issues recipes]: /docs/recipe/overview \ No newline at end of file +[MarkdownlintCliJsonLogFileFormat]: https://cakebuild.net/api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/36DE6F5F +[MarkdownlintCliLogFileFormat]: https://cakebuild.net/api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/B518F49E +[Cake Issues recipes]: ../../documentation/recipe/overview.md \ No newline at end of file diff --git a/docs/input/news/2021-09-05-cake-issues-reporting-0-3-0-released.md b/docs/docs/blog/posts/2021-09-05-cake-issues-reporting-0-3-0-released.md similarity index 82% rename from docs/input/news/2021-09-05-cake-issues-reporting-0-3-0-released.md rename to docs/docs/blog/posts/2021-09-05-cake-issues-reporting-0-3-0-released.md index ed8d34599..f075a75eb 100644 --- a/docs/input/news/2021-09-05-cake-issues-reporting-0-3-0-released.md +++ b/docs/docs/blog/posts/2021-09-05-cake-issues-reporting-0-3-0-released.md @@ -1,12 +1,14 @@ --- title: Cake Issues Reporting Console v0.3.0 released, adding support for all Cake runners -category: Release Notes +date: 2021-09-05 +categories: + - Release Notes --- Version 0.3.0 of [Cake.Issues.Reporting.Console] has been released. This is a minor release adding features and improvements. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,8 +17,8 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [pascalberger](https://github.com/pascalberger) -* [patriksvensson](https://github.com/patriksvensson) +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [patriksvensson](https://github.com/patriksvensson){target="_blank"} ## Support for all Cake runners @@ -38,5 +40,5 @@ Underlying [Errata] library has been updated to 0.6.0, containing additional bug [Cake.Issues.Reporting.Console] 0.3.0 is compatible with previous versions without any breaking changes. To update to the new version bump the version of the addin. -[Cake.Issues.Reporting.Console]: /docs/report-formats/console/ +[Cake.Issues.Reporting.Console]: ../../documentation/report-formats/console/index.md [Errata]: https://github.com/spectreconsole/errata diff --git a/docs/input/news/2021-09-05-summary-by-provider.png b/docs/docs/blog/posts/2021-09-05-summary-by-provider.png similarity index 100% rename from docs/input/news/2021-09-05-summary-by-provider.png rename to docs/docs/blog/posts/2021-09-05-summary-by-provider.png diff --git a/docs/input/news/2022-12-10-cake-issues-v2.0.0-released.md b/docs/docs/blog/posts/2022-12-10-cake-issues-v2.0.0-released.md similarity index 90% rename from docs/input/news/2022-12-10-cake-issues-v2.0.0-released.md rename to docs/docs/blog/posts/2022-12-10-cake-issues-v2.0.0-released.md index e14fc32ab..7f22b5f27 100644 --- a/docs/input/news/2022-12-10-cake-issues-v2.0.0-released.md +++ b/docs/docs/blog/posts/2022-12-10-cake-issues-v2.0.0-released.md @@ -1,12 +1,14 @@ --- title: Cake Issues v2.0.0 Released -category: Release Notes +date: 2022-12-10 +categories: + - Release Notes --- After several months with beta releases Cake Issues version 2.0.0 has been released. This is a major release, containing breaking changes beside bringing new features and bug fixes across all addins. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,11 +17,11 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [eoehen](https://github.com/eoehen) -* [KirillOsenkov](https://github.com/KirillOsenkov) -* [pascalberger](https://github.com/pascalberger) -* [twenzel](https://github.com/twenzel) -* [yansklyarenko](https://github.com/yansklyarenko) +* [eoehen](https://github.com/eoehen){target="_blank"} +* [KirillOsenkov](https://github.com/KirillOsenkov){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} +* [twenzel](https://github.com/twenzel){target="_blank"} +* [yansklyarenko](https://github.com/yansklyarenko){target="_blank"} ## Support for Cake 2.0 diff --git a/docs/input/news/2023-07-22-cake-issues-v3.0.0-released.md b/docs/docs/blog/posts/2023-07-22-cake-issues-v3.0.0-released.md similarity index 94% rename from docs/input/news/2023-07-22-cake-issues-v3.0.0-released.md rename to docs/docs/blog/posts/2023-07-22-cake-issues-v3.0.0-released.md index 59670d003..0e8218054 100644 --- a/docs/input/news/2023-07-22-cake-issues-v3.0.0-released.md +++ b/docs/docs/blog/posts/2023-07-22-cake-issues-v3.0.0-released.md @@ -1,12 +1,14 @@ --- title: Cake Issues v3.0.0 Released -category: Release Notes +date: 2023-07-22 +categories: + - Release Notes --- Cake Issues version 3.0.0 has been released. This is a major release, containing breaking changes beside bringing new features and bug fixes across all addins. - + This post shows the highlights included in this release. For update instructions skip to [Updating from previous versions](#updating-from-previous-versions). @@ -15,9 +17,9 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [DiDoHH](https://github.com/DiDoHH) -* [eoehen](https://github.com/eoehen) -* [pascalberger](https://github.com/pascalberger) +* [DiDoHH](https://github.com/DiDoHH){target="_blank"} +* [eoehen](https://github.com/eoehen){target="_blank"} +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Support for Cake 3.0 diff --git a/docs/input/news/2023-08-16-cake-issues-recipe-v3.1.0-released.md b/docs/docs/blog/posts/2023-08-16-cake-issues-recipe-v3.1.0-released.md similarity index 86% rename from docs/input/news/2023-08-16-cake-issues-recipe-v3.1.0-released.md rename to docs/docs/blog/posts/2023-08-16-cake-issues-recipe-v3.1.0-released.md index 29b2e760f..2a9458668 100644 --- a/docs/input/news/2023-08-16-cake-issues-recipe-v3.1.0-released.md +++ b/docs/docs/blog/posts/2023-08-16-cake-issues-recipe-v3.1.0-released.md @@ -1,11 +1,13 @@ --- title: Cake Issues Recipes v3.1.0 released -category: Release Notes +date: 2023-08-16 +categories: + - Release Notes --- Version 3.1.0 of Cake Issues recipes have been released adding support for creating of reports in SARIF format. - + This post shows the highlights included in this release. For details see [full release notes]. @@ -15,7 +17,7 @@ For update instructions skip to [Updating from previous versions](#updating-from People working on this release: -* [pascalberger](https://github.com/pascalberger) +* [pascalberger](https://github.com/pascalberger){target="_blank"} ## Reports in SARIF format @@ -32,6 +34,6 @@ Cake Issues recipes 3.1.0 are compatible with version 3.x without any breaking c To update to the new version bump the version in your build. [full release notes]: https://github.com/cake-contrib/Cake.Issues.Recipe/releases/tag/3.1.0 -[Report parameters]: /docs/recipe/configuration#report-creation +[Report parameters]: ../../documentation/recipe/configuration.md#report-creation [SARIF format]: https://sarifweb.azurewebsites.net/ [SARIF SAST Scans Tab extension]: https://marketplace.visualstudio.com/items?itemName=sariftools.scans diff --git a/docs/input/docs/contributing/how-to-build.md b/docs/docs/documentation/contributing/how-to-build.md similarity index 55% rename from docs/input/docs/contributing/how-to-build.md rename to docs/docs/documentation/contributing/how-to-build.md index 0e256a7e2..a9100d7b2 100644 --- a/docs/input/docs/contributing/how-to-build.md +++ b/docs/docs/documentation/contributing/how-to-build.md @@ -1,8 +1,8 @@ --- -Order: 30 -Title: How to build addins -Description: Instructions how to build individual Cake Issues addins. +title: How to build addins +description: Instructions how to build individual Cake Issues addins. --- + To build this a package we are using Cake. On Windows PowerShell run: @@ -14,4 +14,5 @@ On Windows PowerShell run: On OSX/Linux run: ```bash -./build.sh \ No newline at end of file +./build.sh +``` diff --git a/docs/input/docs/contributing/how-to-contribute.md b/docs/docs/documentation/contributing/how-to-contribute.md similarity index 69% rename from docs/input/docs/contributing/how-to-contribute.md rename to docs/docs/documentation/contributing/how-to-contribute.md index 8004ea3dd..52db0222f 100644 --- a/docs/input/docs/contributing/how-to-contribute.md +++ b/docs/docs/documentation/contributing/how-to-contribute.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: How to contribute -Description: Instructions how to contribute to Cake Issues addins. +title: How to contribute +description: Instructions how to contribute to Cake Issues addins. --- + The repositories are using [GitFlow] with default configuration. Development is happening on `develop` branch. @@ -16,4 +16,4 @@ To contribute: For getting started see issues marked with `Up-for-grabs` in the individual repositories. -[GitFlow]: (http://nvie.com/posts/a-successful-git-branching-model/) \ No newline at end of file +[GitFlow]: https://nvie.com/posts/a-successful-git-branching-model/ diff --git a/docs/input/docs/contributing/how-to-release.md b/docs/docs/documentation/contributing/how-to-release.md similarity index 53% rename from docs/input/docs/contributing/how-to-release.md rename to docs/docs/documentation/contributing/how-to-release.md index fd8031546..6ff7b63a7 100644 --- a/docs/input/docs/contributing/how-to-release.md +++ b/docs/docs/documentation/contributing/how-to-release.md @@ -1,8 +1,8 @@ --- -Order: 40 -Title: How to release addins -Description: Instructions how to release individual Cake Issues addins. +title: How to release addins +description: Instructions how to release individual Cake Issues addins. --- + See [Cake.Recipe documentation] how to create a new release of this addin. -[Cake.Recipe documentation]: https://cake-contrib.github.io/Cake.Recipe/docs/usage/creating-release \ No newline at end of file +[Cake.Recipe documentation]: https://cake-contrib.github.io/Cake.Recipe/docs/usage/creating-release diff --git a/docs/input/docs/contributing/index.cshtml b/docs/docs/documentation/contributing/index.cshtml similarity index 100% rename from docs/input/docs/contributing/index.cshtml rename to docs/docs/documentation/contributing/index.cshtml diff --git a/docs/input/docs/contributing/issues.cshtml b/docs/docs/documentation/contributing/issues.cshtml similarity index 100% rename from docs/input/docs/contributing/issues.cshtml rename to docs/docs/documentation/contributing/issues.cshtml diff --git a/docs/docs/documentation/extending/fundamentals.md b/docs/docs/documentation/extending/fundamentals.md new file mode 100644 index 000000000..ccc3a991a --- /dev/null +++ b/docs/docs/documentation/extending/fundamentals.md @@ -0,0 +1,10 @@ +--- +title: Fundamentals +description: Fundamentals to extend Cake Issues ecosystem. +--- + +You can easily extend Cake Issues with additional [Issue Provider], [Report Formats] and [Pull Request System integrations]. + +[Issue Provider]: issue-provider/overview.md +[Report Formats]: report-format/overview.md +[Pull Request System integrations]: pull-request-system/overview.md \ No newline at end of file diff --git a/docs/docs/documentation/extending/index.md b/docs/docs/documentation/extending/index.md new file mode 100644 index 000000000..d8d0c3b46 --- /dev/null +++ b/docs/docs/documentation/extending/index.md @@ -0,0 +1,4 @@ +--- +title: Extending +description: Instructions how to add support for additional analyzers, report formats and pull request system to the Cake Issues Addin. +--- diff --git a/docs/docs/documentation/extending/issue-provider/categories.md b/docs/docs/documentation/extending/issue-provider/categories.md new file mode 100644 index 000000000..828617af6 --- /dev/null +++ b/docs/docs/documentation/extending/issue-provider/categories.md @@ -0,0 +1,21 @@ +--- +title: Alias categories +description: Instructions how to set the alias category. +--- + +Issue provider aliases should use the [IssuesAliasConstants.MainCakeAliasCategory](https://cakebuild.net/api/Cake.Issues/IssuesAliasConstants/41CCADF8){target="_blank"} +and [IssuesAliasConstants.IssueProviderCakeAliasCategory](https://cakebuild.net/api/Cake.Issues/IssuesAliasConstants/D265B28D){target="_blank"} +constants for defining their category: + +```csharp +[CakeAliasCategory(IssuesAliasConstants.MainCakeAliasCategory)] +public static class MyIssueProviderAliases +{ + [CakeMethodAlias] + [CakeAliasCategory(IssuesAliasConstants.IssueProviderCakeAliasCategory)] + public static IIssueProvider MyIssueProvider( + this ICakeContext context) + { + } +} +``` diff --git a/docs/input/docs/extending/issue-provider/helper.md b/docs/docs/documentation/extending/issue-provider/helper.md similarity index 56% rename from docs/input/docs/extending/issue-provider/helper.md rename to docs/docs/documentation/extending/issue-provider/helper.md index e2c4e3b1c..6e444efe3 100644 --- a/docs/input/docs/extending/issue-provider/helper.md +++ b/docs/docs/documentation/extending/issue-provider/helper.md @@ -1,16 +1,16 @@ --- -Order: 50 -Title: Helper -Description: Overview of different helper classes for implementing issue providers. +title: Helper +description: Overview of different helper classes for implementing issue providers. --- + The following helpers are provider by `Cake.Issues` for simplifying implementation of issue providers: -| Helper | Description | -|--------------------------|--------------------------------------------------------------------------------| -| [StringPathExtensions] | Extensions for string for handling paths. | -| [ByteArrayExtensions] | Extensions for converting between strings an byte arrays. | +| Helper | Description | +|------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------| +| [StringPathExtensions](https://cakebuild.net/api/Cake.Issues/StringPathExtensions/){target="_blank"} | Extensions for string for handling paths. | +| [ByteArrayExtensions](https://cakebuild.net/api/Cake.Issues/ByteArrayExtensions/){target="_blank"} | Extensions for converting between strings an byte arrays. | -# File linking +## File linking Cake.Issues provides infrastructure to get links to files on source code hosts like GitHub or Azure Repos. This infrastructure can be used inside issue providers to generate file links which can be used inside the issue messages: @@ -44,6 +44,3 @@ protected override IEnumerable InternalReadIssues() return result; } ``` - -[StringPathExtensions]: ../../../api/Cake.Issues/StringPathExtensions/ -[ByteArrayExtensions]: ../../../api/Cake.Issues/ByteArrayExtensions/ \ No newline at end of file diff --git a/docs/docs/documentation/extending/issue-provider/overview.md b/docs/docs/documentation/extending/issue-provider/overview.md new file mode 100644 index 000000000..3a9925425 --- /dev/null +++ b/docs/docs/documentation/extending/issue-provider/overview.md @@ -0,0 +1,21 @@ +--- +title: Overview +description: Overview how to implement support for an analyzer or linter. +--- + +Issue providers need to implement the [IIssueProvider](https://cakebuild.net/api/Cake.Issues/IIssueProvider/){target="_blank"} +interface. + +## Base classes + +For simplifying implementation there exists base classes from which concrete implementation can be inherited. + +| Base Class | Use case | Tutorial | +|--------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------|-------------------------------------| +| [BaseIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseIssueProvider/){target="_blank"} | Base class for a simple issue provider implementation. | [Simple provider] | +| [BaseConfigurableIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseConfigurableIssueProvider_1/){target="_blank"} | Base class for a issue provider with issue provider specific settings. | [Provider settings] | +| [BaseMultiFormatIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseMultiFormatIssueProvider_2/){target="_blank"} | Base class for issue providers supporting multiple log formats. | [Multiple log file formats support] | + +[Simple provider]: tutorials/simple.md +[Provider settings]: tutorials/settings.md +[Multiple log file formats support]: tutorials/logfile-format.md diff --git a/docs/input/docs/extending/issue-provider/tutorials/logfile-format.md b/docs/docs/documentation/extending/issue-provider/tutorials/logfile-format.md similarity index 87% rename from docs/input/docs/extending/issue-provider/tutorials/logfile-format.md rename to docs/docs/documentation/extending/issue-provider/tutorials/logfile-format.md index 2bbd0d283..b9f671672 100644 --- a/docs/input/docs/extending/issue-provider/tutorials/logfile-format.md +++ b/docs/docs/documentation/extending/issue-provider/tutorials/logfile-format.md @@ -1,16 +1,18 @@ --- -Order: 30 -Title: Multiple log file formats -Description: Instructions how to implement an issue provider with support for multiple log file formats. +title: Multiple log file formats +description: Instructions how to implement an issue provider with support for multiple log file formats. --- + A single issue provider might support reading issues from multiple different log file formats. -For these cases the `Cake.Issue` addin provides the [BaseMultiFormatIssueProvider], [BaseMultiFormatIssueProviderSettings] -and [BaseLogFileFormat] classes for simplifying implementation in the issue provider addin. +For these cases the `Cake.Issue` addin provides the [BaseMultiFormatIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseMultiFormatIssueProvider_2/){target="_blank"}, +[BaseMultiFormatIssueProviderSettings](https://cakebuild.net/api/Cake.Issues/BaseMultiFormatIssueProviderSettings_2/){target="_blank"} +and [BaseLogFileFormat](https://cakebuild.net/api/Cake.Issues/BaseLogFileFormat_2/){target="_blank"} +classes for simplifying implementation in the issue provider addin. -# Implementing issue provider +## Implementing issue provider -A concrete class inheriting from [BaseMultiFormatIssueProvider] needs to be implemented defining the -concrete types. +A concrete class inheriting from [BaseMultiFormatIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseMultiFormatIssueProvider_2/){target="_blank"} +needs to be implemented defining the concrete types. ```csharp /// @@ -33,8 +35,8 @@ public class MyIssuesProvider : BaseMultiFormatIssueProvider @@ -92,7 +94,7 @@ public abstract class MyLogFileFormat : BaseLogFileFormat @@ -51,7 +55,8 @@ internal class MyRuleUrlResolver : BaseUrlResolver } ``` -To use the URL resolver the [ResolveRuleUrl] method needs to be called: +To use the URL resolver the [ResolveRuleUrl](https://cakebuild.net/api/Cake.Issues/BaseRuleUrlResolver_1/6B23EC74){target="_blank"} +method needs to be called: ```csharp var resolver = new MyRuleUrlResolver(); @@ -84,10 +89,10 @@ internal class MyRuleUrlResolver : BaseUrlResolver } ``` -# Support custom URL resolvers +## Support custom URL resolvers -The [AddUrlResolver] method can also be called from an Cake alias to allow users of the addin to -register custom resolvers. +The [AddUrlResolver](https://cakebuild.net/api/Cake.Issues/BaseRuleUrlResolver_1/AAA4FB20){target="_blank"} +method can also be called from an Cake alias to allow users of the addin to register custom resolvers. For this the URL resolver class needs to be implemented as a singleton: ```csharp @@ -126,9 +131,3 @@ public static class MyIssueProviderAliases MyRuleUrlResolver.Instance.AddUrlResolver(resolver); } ``` - -[BaseRuleDescription]: ../../../../api/Cake.Issues/BaseRuleDescription/ -[BaseRuleUrlResolver]: ../../../../api/Cake.Issues/BaseRuleUrlResolver_1/ -[TryGetRuleDescription]: ../../../../api/Cake.Issues/BaseRuleUrlResolver_1/D9DB5D44 -[AddUrlResolver]: ../../../../api/Cake.Issues/BaseRuleUrlResolver_1/AAA4FB20 -[ResolveRuleUrl]: ../../../../api/Cake.Issues/BaseRuleUrlResolver_1/6B23EC74 \ No newline at end of file diff --git a/docs/input/docs/extending/issue-provider/tutorials/settings.md b/docs/docs/documentation/extending/issue-provider/tutorials/settings.md similarity index 89% rename from docs/input/docs/extending/issue-provider/tutorials/settings.md rename to docs/docs/documentation/extending/issue-provider/tutorials/settings.md index bafba5633..b94f5de62 100644 --- a/docs/input/docs/extending/issue-provider/tutorials/settings.md +++ b/docs/docs/documentation/extending/issue-provider/tutorials/settings.md @@ -1,16 +1,17 @@ --- -Order: 20 -Title: Provider settings -Description: Instructions how to implement an issue provider with specific settings. +title: Provider settings +description: Instructions how to implement an issue provider with specific settings. --- + Often issue providers require specific settings. -For these cases the `Cake.Issue` addin provides the [BaseConfigurableIssueProvider] and [IssueProviderSettings] classes +For these cases the `Cake.Issue` addin provides the [BaseConfigurableIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseConfigurableIssueProvider_1/){target="_blank"} +and [IssueProviderSettings](https://cakebuild.net/api/Cake.Issues/IssueProviderSettings/){target="_blank"} classes for simplifying implementation in the issue provider addin. -# Implementing issue provider +## Implementing issue provider -A concrete class inheriting from [BaseConfigurableIssueProvider] needs to be implemented defining the -concrete settings class to use: +A concrete class inheriting from [BaseConfigurableIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseConfigurableIssueProvider_1/){target="_blank"} +needs to be implemented defining the concrete settings class to use: ```csharp /// @@ -49,7 +50,8 @@ public class MyIssuesProvider : BaseConfigurableIssueProvider } ``` -Also a concrete class inheriting from [IssueProviderSettings] needs to be implemented. +Also a concrete class inheriting from [IssueProviderSettings](https://cakebuild.net/api/Cake.Issues/IssueProviderSettings/){target="_blank"} +needs to be implemented. Based on the capabilities of the issue provider the appropriate constructors for reading from the file system or memory can be made public: @@ -83,7 +85,7 @@ public class MyIssuesSettings : IssueProviderSettings } ``` -# Aliases +## Aliases An alias for reading issues with the provider should be provided: @@ -200,6 +202,3 @@ public static string MyIssuesProviderTypeName( return typeof(MyIssuesProvider).FullName; } ``` - -[BaseConfigurableIssueProvider]: ../../../../api/Cake.Issues/BaseConfigurableIssueProvider_1/ -[IssueProviderSettings ]: ../../../../api/Cake.Issues/IssueProviderSettings/ \ No newline at end of file diff --git a/docs/input/docs/extending/issue-provider/tutorials/simple.md b/docs/docs/documentation/extending/issue-provider/tutorials/simple.md similarity index 84% rename from docs/input/docs/extending/issue-provider/tutorials/simple.md rename to docs/docs/documentation/extending/issue-provider/tutorials/simple.md index b84d429df..d6b2b156b 100644 --- a/docs/input/docs/extending/issue-provider/tutorials/simple.md +++ b/docs/docs/documentation/extending/issue-provider/tutorials/simple.md @@ -1,14 +1,16 @@ --- -Order: 10 -Title: Simple issue provider -Description: Instructions how to implement a simple issue provider. +title: Simple issue provider +description: Instructions how to implement a simple issue provider. --- -This tutorial explains how to implement a simple issue provider using the [BaseIssueProvider] class -from the `Cake.Issue` addin. -# Implementing issue provider +This tutorial explains how to implement a simple issue provider using the +[BaseIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseIssueProvider/){target="_blank"} +class from the `Cake.Issue` addin. -A concrete class inheriting from [BaseIssueProvider] needs to be implemented: +## Implementing issue provider + +A concrete class inheriting from [BaseIssueProvider](https://cakebuild.net/api/Cake.Issues/BaseIssueProvider/){target="_blank"} +needs to be implemented: ```csharp /// @@ -46,7 +48,7 @@ public class MyIssuesProvider : BaseIssueProvider } ``` -# Aliases +## Aliases An alias for reading issues with the provider should be provided: @@ -96,5 +98,3 @@ public static string MyIssuesProviderTypeName( return typeof(MyIssuesProvider).FullName; } ``` - -[BaseIssueProvider]: ../../../../api/Cake.Issues/BaseIssueProvider/ \ No newline at end of file diff --git a/docs/input/docs/extending/pull-request-system/categories.md b/docs/docs/documentation/extending/pull-request-system/categories.md similarity index 97% rename from docs/input/docs/extending/pull-request-system/categories.md rename to docs/docs/documentation/extending/pull-request-system/categories.md index c375b8316..c8dbcc0ce 100644 --- a/docs/input/docs/extending/pull-request-system/categories.md +++ b/docs/docs/documentation/extending/pull-request-system/categories.md @@ -1,8 +1,8 @@ --- -Order: 30 Title: Alias categories Description: Instructions how to set the alias category. --- + Pull request system aliases should use the [IssuesAliasConstants.MainCakeAliasCategory] and [PullRequestsAliasConstants.PullRequestSystemCakeAliasCategory] constants for defining their category: @@ -20,4 +20,4 @@ public static class MyPullRequestSystemAliases ``` [IssuesAliasConstants.MainCakeAliasCategory]: ../../../api/Cake.Issues/IssuesAliasConstants/41CCADF8 -[PullRequestsAliasConstants.PullRequestSystemCakeAliasCategory]: ../../../api/Cake.Issues.PullRequests/PullRequestsAliasConstants/B4C013A1 \ No newline at end of file +[PullRequestsAliasConstants.PullRequestSystemCakeAliasCategory]: ../../../api/Cake.Issues.PullRequests/PullRequestsAliasConstants/B4C013A1 diff --git a/docs/input/docs/extending/pull-request-system/overview.md b/docs/docs/documentation/extending/pull-request-system/overview.md similarity index 92% rename from docs/input/docs/extending/pull-request-system/overview.md rename to docs/docs/documentation/extending/pull-request-system/overview.md index 3fbf0a88e..542225bf0 100644 --- a/docs/input/docs/extending/pull-request-system/overview.md +++ b/docs/docs/documentation/extending/pull-request-system/overview.md @@ -1,11 +1,11 @@ --- -Order: 20 -Title: Overview -Description: Overview how to implement support for a pull request system. +title: Overview +description: Overview how to implement support for a pull request system. --- + Pull Request Systems need to implement the [IPullRequestSystem] interface. -# BaseClasses +## BaseClasses For simplifying implementation there exists base classes from which concrete implementation can be inherited. [BasePullRequestSystem] is the main base class with the required functionality for a pull request system implementation. @@ -23,4 +23,4 @@ in a pull request system implementation. [BasePullRequestSystem]: ../../../api/Cake.Issues.PullRequests/BasePullRequestSystem [BaseCheckingCommitIdCapability]: ../../../api/Cake.Issues.PullRequests/BaseCheckingCommitIdCapability_1 [BaseDiscussionThreadsCapability]: ../../../api/Cake.Issues.PullRequests/BaseDiscussionThreadsCapability_1 -[BaseFilteringByModifiedFilesCapability]: ../../../api/Cake.Issues.PullRequests/BaseFilteringByModifiedFilesCapability_1 \ No newline at end of file +[BaseFilteringByModifiedFilesCapability]: ../../../api/Cake.Issues.PullRequests/BaseFilteringByModifiedFilesCapability_1 diff --git a/docs/input/docs/extending/report-format/categories.md b/docs/docs/documentation/extending/report-format/categories.md similarity index 81% rename from docs/input/docs/extending/report-format/categories.md rename to docs/docs/documentation/extending/report-format/categories.md index fd9b0a477..340444c56 100644 --- a/docs/input/docs/extending/report-format/categories.md +++ b/docs/docs/documentation/extending/report-format/categories.md @@ -1,8 +1,8 @@ --- -Order: 30 -Title: Alias categories -Description: Instructions how to set the alias category. +title: Alias categories +description: Instructions how to set the alias category. --- + Report format aliases should use the [IssuesAliasConstants.MainCakeAliasCategory] and [ReportingAliasConstants.ReportingFormatCakeAliasCategory] constants for defining their category: @@ -20,4 +20,4 @@ public static class MyReportFormatAliases ``` [IssuesAliasConstants.MainCakeAliasCategory]: ../../../api/Cake.Issues/IssuesAliasConstants/41CCADF8 -[ReportingAliasConstants.ReportingFormatCakeAliasCategory]: ../../../api/Cake.Issues.Reporting/ReportingAliasConstants/979CDCAF \ No newline at end of file +[ReportingAliasConstants.ReportingFormatCakeAliasCategory]: ../../../api/Cake.Issues.Reporting/ReportingAliasConstants/979CDCAF diff --git a/docs/input/docs/extending/report-format/overview.md b/docs/docs/documentation/extending/report-format/overview.md similarity index 78% rename from docs/input/docs/extending/report-format/overview.md rename to docs/docs/documentation/extending/report-format/overview.md index 179d63030..5d6f6bbbf 100644 --- a/docs/input/docs/extending/report-format/overview.md +++ b/docs/docs/documentation/extending/report-format/overview.md @@ -1,10 +1,10 @@ --- -Order: 20 -Title: Overview -Description: Overview how to implement support for a report output format. +title: Overview +description: Overview how to implement support for a report output format. --- + Report formats need to implement the [IIssueReportFormat] interface. For simplifying implementation there exists an abstract [IssueReportFormat] base class from which concrete implementation can be inherited. [IIssueReportFormat]: ../../../api/Cake.Issues.Reporting/IIssueReportFormat/ -[IssueReportFormat]: ../../../api/Cake.Issues.Reporting/IssueReportFormat/ \ No newline at end of file +[IssueReportFormat]: ../../../api/Cake.Issues.Reporting/IssueReportFormat/ diff --git a/docs/input/docs/extending/testing.md b/docs/docs/documentation/extending/testing.md similarity index 73% rename from docs/input/docs/extending/testing.md rename to docs/docs/documentation/extending/testing.md index 9d96b697f..a9927180c 100644 --- a/docs/input/docs/extending/testing.md +++ b/docs/docs/documentation/extending/testing.md @@ -1,8 +1,8 @@ --- -Order: 40 -Title: Testing -Description: Instructions how to write test cases for Cake Issues addins. +title: Testing +description: Instructions how to write test cases for Cake Issues addins. --- + The `Cake.Issues.Testing` provides different helper classes for writing test cases for issue provider, report format or pull request system addins. diff --git a/docs/input/docs/fundamentals/architecture.md b/docs/docs/documentation/fundamentals/architecture.md similarity index 89% rename from docs/input/docs/fundamentals/architecture.md rename to docs/docs/documentation/fundamentals/architecture.md index 3e8641927..8ea4d8258 100644 --- a/docs/input/docs/fundamentals/architecture.md +++ b/docs/docs/documentation/fundamentals/architecture.md @@ -1,6 +1,6 @@ --- -Order: 10 -Description: Architecture overview. +title: Architecture +description: Architecture overview. --- The Cake Issues addins are built in a modular architecture, allowing to easily @@ -16,6 +16,6 @@ The core consists of the following addins: | Cake.Issues.Reporting | Provides aliases for creating reports for issues. Support for different report formats can be provided through additional [report format] addins. | | Cake.Issues.PullRequests | Provides aliases for reporting issues as comments to pull requests. Support for different pull request systems can be provided through additional [pull request system] addins. | -[issue provider]: issue-provider -[report format]: report-format -[pull request system]: pull-request-system +[issue provider]: issue-provider.md +[report format]: report-format.md +[pull request system]: pull-request-system.md diff --git a/docs/input/docs/fundamentals/issue-provider.md b/docs/docs/documentation/fundamentals/issue-provider.md similarity index 84% rename from docs/input/docs/fundamentals/issue-provider.md rename to docs/docs/documentation/fundamentals/issue-provider.md index 170e2cc60..81f20209c 100644 --- a/docs/input/docs/fundamentals/issue-provider.md +++ b/docs/docs/documentation/fundamentals/issue-provider.md @@ -1,7 +1,8 @@ --- -Order: 40 -Description: Overview about issue providers. +title: Issue Provider +description: Overview about issue providers. --- + Issue provider addins are responsible for providing the output of an analyzer or linter to the Cake Issues addin. See [Issue Provider] for a list of currently supported analyzers and linters. @@ -9,4 +10,4 @@ See [Issue Provider] for a list of currently supported analyzers and linters. See [How to implement issue providers] for instruction on how to implement support for additional issue providers. [Issue Provider]: ../../addins/issue-provider/ -[How to implement issue providers]: ../extending/issue-provider/ \ No newline at end of file +[How to implement issue providers]: ../extending/issue-provider/overview.md diff --git a/docs/input/docs/fundamentals/overview.png b/docs/docs/documentation/fundamentals/overview.png similarity index 100% rename from docs/input/docs/fundamentals/overview.png rename to docs/docs/documentation/fundamentals/overview.png diff --git a/docs/input/docs/fundamentals/pull-request-system.md b/docs/docs/documentation/fundamentals/pull-request-system.md similarity index 81% rename from docs/input/docs/fundamentals/pull-request-system.md rename to docs/docs/documentation/fundamentals/pull-request-system.md index 2615a4bfb..5eb30a370 100644 --- a/docs/input/docs/fundamentals/pull-request-system.md +++ b/docs/docs/documentation/fundamentals/pull-request-system.md @@ -1,7 +1,8 @@ --- -Order: 60 -Description: Overview about pull request system implementations. +title: Pull Request System +description: Overview about pull request system implementations. --- + Pull request addins implement specific Pull Request Systems and allow the Cake Issues addin to write found issues as comments to pull requests. @@ -11,4 +12,4 @@ See [How to implement pull request systems] for instruction on how to implement additional pull request systems. [Pull Request Systems]: ../../addins/pull-request-system/ -[How to implement pull request systems]: ../extending/pull-request-system/ +[How to implement pull request systems]: ../extending/pull-request-system/overview.md diff --git a/docs/input/docs/fundamentals/recipe.md b/docs/docs/documentation/fundamentals/recipe.md similarity index 74% rename from docs/input/docs/fundamentals/recipe.md rename to docs/docs/documentation/fundamentals/recipe.md index 635cc08ac..7ba6bc66f 100644 --- a/docs/input/docs/fundamentals/recipe.md +++ b/docs/docs/documentation/fundamentals/recipe.md @@ -1,9 +1,10 @@ --- -Order: 30 -Description: Pre-made recipe script. +title: Recipe +description: Pre-made recipe script. --- + Recipes are pre-made Cake scripts which you can use in your project specific Cake script to get you quickly up and running. See [Recipe] for detailed documentation of the available recipe for Cake.Issues. -[Recipe]: ../recipe/ \ No newline at end of file +[Recipe]: ../recipe/ diff --git a/docs/input/docs/fundamentals/report-format.md b/docs/docs/documentation/fundamentals/report-format.md similarity index 70% rename from docs/input/docs/fundamentals/report-format.md rename to docs/docs/documentation/fundamentals/report-format.md index a5f0e806a..5dfceba5c 100644 --- a/docs/input/docs/fundamentals/report-format.md +++ b/docs/docs/documentation/fundamentals/report-format.md @@ -1,7 +1,8 @@ --- -Order: 50 -Description: Overview about report format implementations. +title: Report Format +description: Overview about report format implementations. --- + Report format addins implement specific report formats and allow the Cake Issues addin to create reports in the specific format. @@ -11,4 +12,4 @@ See [How to implement report format] for instruction on how to implement support additional report formats. [Report Formats]: ../../addins/report-format/ -[How to implement report format]: ../extending/report-format/ +[How to implement report format]: ../extending/report-format/overview.md diff --git a/docs/input/docs/fundamentals/versioning.md b/docs/docs/documentation/fundamentals/versioning.md similarity index 55% rename from docs/input/docs/fundamentals/versioning.md rename to docs/docs/documentation/fundamentals/versioning.md index 23111623f..0e119588f 100644 --- a/docs/input/docs/fundamentals/versioning.md +++ b/docs/docs/documentation/fundamentals/versioning.md @@ -1,24 +1,21 @@ --- -Order: 20 -Description: Compatible versions. +title: Versioning +description: Compatible versions. --- + The core addins and all issue providers and pull request systems need to be build against a compatible core API. You can check the required dependencies in the release notes of the addin. This means that it's not possible to use a version of an issue provider build against `Cake.Issues` 1.0.0 together with a version of a pull request system build against `Cake.Issues` 2.0.0. -We use strict [semantic versioning]. +We use strict [semantic versioning](http://semver.org/){target="_blank"}. Therefore it's possible to use issue provider and pull request system built against `Cake.Issues` 1.0.0 together with `Cake.Issues` 1.1.0. -:::{.alert .alert-info} -Please note that versions below 1.0.0 are not considered stable and their API will break regularly. -Expect breaking changes in each minor version. - -Therefore we strongly advise to pin to specific versions of the addins to avoid breaking builds -once we update the addin. -::: - +!!! info + Please note that versions below 1.0.0 are not considered stable and their API will break regularly. + Expect breaking changes in each minor version. -[semantic versioning]: http://semver.org/ \ No newline at end of file + Therefore we strongly advise to pin to specific versions of the addins to avoid breaking builds + once we update the addin. diff --git a/docs/input/docs/issue-providers/docfx/examples.md b/docs/docs/documentation/issue-providers/docfx/examples.md similarity index 52% rename from docs/input/docs/issue-providers/docfx/examples.md rename to docs/docs/documentation/issue-providers/docfx/examples.md index bd2225cfb..00f2d7ee7 100644 --- a/docs/input/docs/issue-providers/docfx/examples.md +++ b/docs/docs/documentation/issue-providers/docfx/examples.md @@ -1,11 +1,13 @@ --- -Order: 30 -Title: Examples -Description: Examples for using the Cake.Issues.DocFx addin. +title: Examples +description: Examples for using the Cake.Issues.DocFx addin. --- -The following example will call [DocFx] to generate the documentation and outputs the number of warnings. -To call [DocFx] from a Cake script you can use the [Cake.DocFx] addin. +The following example will call [DocFx](https://dotnet.github.io/docfx/){target="_blank"} to +generate the documentation and outputs the number of warnings. + +To call [DocFx](https://dotnet.github.io/docfx/){target="_blank"} from a Cake script you can +use the [Cake.DocFx](https://cakebuild.net/extensions/cake-docfx/){target="_blank"} addin. ```csharp #addin "Cake.DocFx" @@ -18,12 +20,11 @@ To read issues from DocFx log files you need to import the core addin and the Do #addin "Cake.Issues.DocFx" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. We need some global variables: @@ -33,7 +34,7 @@ var repoRootPath = @"c:\repo"; var docRootPath = @"docs"; ``` -The following task will build the [DocFx] project and write a log file: +The following task will build the [DocFx](https://dotnet.github.io/docfx/){target="_blank"} project and write a log file: ```csharp Task("Build-Documentation").Does(() => @@ -62,6 +63,3 @@ Task("Read-Issues") Information("{0} issues are found.", issues.Count()); }); ``` - -[DocFx]: https://dotnet.github.io/docfx/ -[Cake.DocFx]: https://www.nuget.org/packages/Cake.DocFx/ diff --git a/docs/docs/documentation/issue-providers/docfx/features.md b/docs/docs/documentation/issue-providers/docfx/features.md new file mode 100644 index 000000000..4de379006 --- /dev/null +++ b/docs/docs/documentation/issue-providers/docfx/features.md @@ -0,0 +1,39 @@ +--- +title: Features +description: Features of the Cake.Issues.DocFx addin. +--- + +The [Cake.Issues.DocFx addin](https://cakebuild.net/extensions/cake-issues-docfx/){target="_blank"} +provides the following features. + +## Basic features + +* Reads warnings from [DocFx](https://dotnet.github.io/docfx/){target="_blank"} log files. + +!!! info + [DocFx](https://dotnet.github.io/docfx/){target="_blank"} can be run with + [Cake.DocFx](https://cakebuild.net/extensions/cake-docfx/){target="_blank"} addin. + +## Supported IIssue properties + +| | Property | Remarks | +|------------------|-----------------------------------|---------------------------------| +| :material-check: | `IIssue.ProviderType` | | +| :material-check: | `IIssue.ProviderName` | | +| | `IIssue.Run` | Can be set while reading issues | +| :material-check: | `IIssue.Identifier` | Set to `IIssue.MessageText` | +| | `IIssue.ProjectName` | | +| | `IIssue.ProjectFileRelativePath` | | +| :material-check: | `IIssue.AffectedFileRelativePath` | | +| :material-check: | `IIssue.Line` | | +| | `IIssue.EndLine` | | +| | `IIssue.Column` | | +| | `IIssue.EndColumn` | | +| | `IIssue.FileLink` | Can be set while reading issues | +| :material-check: | `IIssue.MessageText` | | +| | `IIssue.MessageHtml` | | +| | `IIssue.MessageMarkdown` | | +| :material-check: | `IIssue.Priority` | | +| :material-check: | `IIssue.PriorityName` | | +| :material-check: | `IIssue.Rule` | | +| :material-check: | `IIssue.RuleUrl` | | diff --git a/docs/docs/documentation/issue-providers/docfx/index.md b/docs/docs/documentation/issue-providers/docfx/index.md new file mode 100644 index 000000000..764fc8fbd --- /dev/null +++ b/docs/docs/documentation/issue-providers/docfx/index.md @@ -0,0 +1,7 @@ +--- +title: DocFx +description: Issue provider which allows you to read warnings logged by DocFx. +--- + +Support for reading warnings reported by [DocFx](https://dotnet.github.io/docfx/){target="_blank"} is implemented in the +[Cake.Issues.DocFx addin](https://cakebuild.net/extensions/cake-issues-docfx/){target="_blank"}. diff --git a/docs/docs/documentation/issue-providers/eslint/features.md b/docs/docs/documentation/issue-providers/eslint/features.md new file mode 100644 index 000000000..6718c1038 --- /dev/null +++ b/docs/docs/documentation/issue-providers/eslint/features.md @@ -0,0 +1,42 @@ +--- +title: Features +description: Features of the Cake.Issues.EsLint addin. +--- + +The [Cake.Issues.EsLint addin](https://cakebuild.net/extensions/cake-issues-eslint/){target="_blank"} provides the following features. + +## Basic features + +* Reads issues reported by ESLint. +* Provides URLs for all issues. +* Support for custom URL resolving using the [EsLintAddRuleUrlResolver](https://cakebuild.net/api/Cake.Issues.EsLint/EsLintIssuesAliases/0F6CCE21){target="_blank"} + alias. + +## Supported log file formats + +* [EsLintJsonFormat](https://cakebuild.net/api/Cake.Issues.EsLint/EsLintIssuesAliases/230C6E27){target="_blank"} + alias for reading issues from log files created by + [ESLint json formatter](https://eslint.org/docs/user-guide/formatters/#json){target="_blank"}. + +## Supported IIssue properties + +| | Property | Remarks | +|------------------|-----------------------------------|---------------------------------| +| :material-check: | `IIssue.ProviderType` | | +| :material-check: | `IIssue.ProviderName` | | +| | `IIssue.Run` | Can be set while reading issues | +| :material-check: | `IIssue.Identifier` | Set to `IIssue.MessageText` | +| | `IIssue.ProjectName` | | +| | `IIssue.ProjectFileRelativePath` | | +| :material-check: | `IIssue.AffectedFileRelativePath` | | +| :material-check: | `IIssue.Line` | | +| | `IIssue.EndLine` | | +| :material-check: | `IIssue.Column` | | +| | `IIssue.EndColumn` | | +| :material-check: | `IIssue.MessageText` | | +| | `IIssue.MessageHtml` | | +| | `IIssue.MessageMarkdown` | | +| :material-check: | `IIssue.Priority` | | +| :material-check: | `IIssue.PriorityName` | | +| :material-check: | `IIssue.Rule` | | +| :material-check: | `IIssue.RuleUrl` | Support for custom rules can be added through a custom [EsLintAddRuleUrlResolver](https://cakebuild.net/api/Cake.Issues.EsLint/EsLintIssuesAliases/0F6CCE21){target="_blank"} | diff --git a/docs/docs/documentation/issue-providers/eslint/index.md b/docs/docs/documentation/issue-providers/eslint/index.md new file mode 100644 index 000000000..a233ea84a --- /dev/null +++ b/docs/docs/documentation/issue-providers/eslint/index.md @@ -0,0 +1,7 @@ +--- +title: ESLint +description: Issue provider which allows you to read issues logged by ESLint. +--- + +Support for reading issues reported by [ESLint](https://eslint.org/){target="_blank"} +is implemented in the [Cake.Issues.EsLint addin](https://cakebuild.net/extensions/cake-issues-eslint/){target="_blank"}. diff --git a/docs/input/docs/issue-providers/gitrepository/examples.md b/docs/docs/documentation/issue-providers/gitrepository/examples.md similarity index 53% rename from docs/input/docs/issue-providers/gitrepository/examples.md rename to docs/docs/documentation/issue-providers/gitrepository/examples.md index 28c116f38..d055e4159 100644 --- a/docs/input/docs/issue-providers/gitrepository/examples.md +++ b/docs/docs/documentation/issue-providers/gitrepository/examples.md @@ -1,13 +1,14 @@ --- -Order: 30 -Title: Examples -Description: Examples for using the Cake.Issues.GitRepository addin. +title: Examples +description: Examples for using the Cake.Issues.GitRepository addin. --- -The following example prints the number of binary files which are not tracked by [Git Large File Storage] in a repository. -:::{.alert .alert-warning} -Checking binary files requires Git and [Git Large File Storage] available on the local machine. -::: +The following example prints the number of binary files which are not tracked by +[Git Large File Storage](https://git-lfs.github.com/){target="_blank"} in a repository. + +!!! warning + Checking binary files requires Git and [Git Large File Storage](https://git-lfs.github.com/){target="_blank"} + available on the local machine. To analyze Git repositories you need to import the core addin and the Git repository support: @@ -16,12 +17,11 @@ To analyze Git repositories you need to import the core addin and the Git reposi #addin "Cake.Issues.GitRepository" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. We need some global variables: @@ -50,5 +50,3 @@ Task("Analyze-Repo") Information("{0} issues are found.", issues.Count()); }); ``` - -[Git Large File Storage]: https://git-lfs.github.com/ \ No newline at end of file diff --git a/docs/docs/documentation/issue-providers/gitrepository/features.md b/docs/docs/documentation/issue-providers/gitrepository/features.md new file mode 100644 index 000000000..a108b8f41 --- /dev/null +++ b/docs/docs/documentation/issue-providers/gitrepository/features.md @@ -0,0 +1,39 @@ +--- +title: Features +description: Features of the Cake.Issues.GitRepository addin. +--- + +The [Cake.Issues.GitRepository addin](https://cakebuild.net/extensions/cake-issues-gitrepository/){target="_blank"} +provides the following features. + +## Basic features + +* Checks path length of files. See [FilePathTooLong] for details. +* Checks if binary files are tracked by Git LFS. See [BinaryFileNotTrackedByLfs] for details. + +## Supported IIssue properties + +| | Property | Remarks | +|------------------|-----------------------------------|---------------------------------| +| :material-check: | `IIssue.ProviderType` | | +| :material-check: | `IIssue.ProviderName` | | +| | `IIssue.Run` | Can be set while reading issues | +| :material-check: | `IIssue.Identifier` | Set to `IIssue.MessageText` | +| | `IIssue.ProjectName` | | +| | `IIssue.ProjectFileRelativePath` | | +| :material-check: | `IIssue.AffectedFileRelativePath` | | +| | `IIssue.Line` | | +| | `IIssue.EndLine` | | +| | `IIssue.Column` | | +| | `IIssue.EndColumn` | | +| | `IIssue.FileLink` | Can be set while reading issues | +| :material-check: | `IIssue.MessageText` | | +| :material-check: | `IIssue.MessageHtml` | | +| :material-check: | `IIssue.MessageMarkdown` | | +| :material-check: | `IIssue.Priority` | | +| :material-check: | `IIssue.PriorityName` | | +| :material-check: | `IIssue.Rule` | | +| :material-check: | `IIssue.RuleUrl` | | + +[FilePathTooLong]: rules/FilePathTooLong.md +[BinaryFileNotTrackedByLfs]: rules/BinaryFileNotTrackedByLfs.md diff --git a/docs/docs/documentation/issue-providers/gitrepository/index.md b/docs/docs/documentation/issue-providers/gitrepository/index.md new file mode 100644 index 000000000..897680de1 --- /dev/null +++ b/docs/docs/documentation/issue-providers/gitrepository/index.md @@ -0,0 +1,7 @@ +--- +title: Git Repository +description: Issue provider which allows you to analyzing Git repositories and create issues resulting from it. +--- + +Support for analyzing Git repositories is implemented in the +[Cake.Issues.GitRepository addin](https://cakebuild.net/extensions/cake-issues-gitrepository/){target="_blank"}. diff --git a/docs/docs/documentation/issue-providers/gitrepository/rules/BinaryFileNotTrackedByLfs.md b/docs/docs/documentation/issue-providers/gitrepository/rules/BinaryFileNotTrackedByLfs.md new file mode 100644 index 000000000..acafd93a5 --- /dev/null +++ b/docs/docs/documentation/issue-providers/gitrepository/rules/BinaryFileNotTrackedByLfs.md @@ -0,0 +1,28 @@ +--- +title: BinaryFileNotTrackedByLfs +description: A binary file is not tracked by Git LFS. +--- + +| Metadata | | +|--------------|---------------------------| +| Rule Id | BinaryFileNotTrackedByLfs | +| Priority | Warning | +| Available in | 0.7.0 or higher | + +## Cause + +A binary file in the repository is not tracked by [Git Large File Storage](https://git-lfs.github.com/){target="_blank"}. + +## Rule description + +By its nature Git repositories cannot handle binary files well and will keep a full copy of that file in the repository every time a change to that file is committed. +Considering that you always clone the full history of a repository, and not only the latest version, using binary files in a repository considerably slow downs the operation. +[Git Large File Storage](https://git-lfs.github.com/){target="_blank"} replaces large files with small text pointers inside the Git repository, while storing the file contents on a remote server. + +!!! info + The rule assumes that all files, which are not text files are binary files. + This also includes for example empty files. + +## How to fix violations + +Track the file with [Git Large File Storage](https://git-lfs.github.com/){target="_blank"}. diff --git a/docs/input/docs/issue-providers/gitrepository/rules/FilePathTooLong.md b/docs/docs/documentation/issue-providers/gitrepository/rules/FilePathTooLong.md similarity index 58% rename from docs/input/docs/issue-providers/gitrepository/rules/FilePathTooLong.md rename to docs/docs/documentation/issue-providers/gitrepository/rules/FilePathTooLong.md index e3eb20e67..ac7dfb3db 100644 --- a/docs/input/docs/issue-providers/gitrepository/rules/FilePathTooLong.md +++ b/docs/docs/documentation/issue-providers/gitrepository/rules/FilePathTooLong.md @@ -1,15 +1,13 @@ --- -Title: FilePathTooLong -Description: The path of a file is too long. +title: FilePathTooLong +description: The path of a file is too long. --- - - - +| Metadata | | +|--------------|-----------------| +| Rule Id | FilePathTooLong | +| Priority | Warning | +| Available in | 0.7.3 or higher | ## Cause diff --git a/docs/docs/documentation/issue-providers/index.md b/docs/docs/documentation/issue-providers/index.md new file mode 100644 index 000000000..66eff4003 --- /dev/null +++ b/docs/docs/documentation/issue-providers/index.md @@ -0,0 +1,4 @@ +--- +title: Issue Providers +description: Documentation of the different issue provider addins. +--- diff --git a/docs/input/docs/issue-providers/inspectcode/examples.md b/docs/docs/documentation/issue-providers/inspectcode/examples.md similarity index 76% rename from docs/input/docs/issue-providers/inspectcode/examples.md rename to docs/docs/documentation/issue-providers/inspectcode/examples.md index 5d9dbaf9e..2e535381e 100644 --- a/docs/input/docs/issue-providers/inspectcode/examples.md +++ b/docs/docs/documentation/issue-providers/inspectcode/examples.md @@ -1,8 +1,8 @@ --- -Order: 30 -Title: Examples -Description: Examples for using the Cake.Issues.InspectCode addin. +title: Examples +description: Examples for using the Cake.Issues.InspectCode addin. --- + The following example will call [JetBrains InspectCode] and output the number of warnings. To call [JetBrains InspectCode] from a Cake script you need to add the `JetBrains.ReSharper.CommandLineTools`: @@ -18,12 +18,11 @@ To read issues from InspectCode log files you need to import the core addin and #addin "Cake.Issues.InspectCode" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the packages. +!!! warning + Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the packages. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. We need some global variables: diff --git a/docs/docs/documentation/issue-providers/inspectcode/features.md b/docs/docs/documentation/issue-providers/inspectcode/features.md new file mode 100644 index 000000000..d04c5170e --- /dev/null +++ b/docs/docs/documentation/issue-providers/inspectcode/features.md @@ -0,0 +1,38 @@ +--- +title: Features +description: Features of the Cake.Issues.InspectCode addin. +--- + +The [Cake.Issues.InspectCode addin] provides the following features: + +## Basic features + +* Reads warnings from [JetBrains InsepectCode] log files. +* Provides URLs for issues containing a Wiki URL. + +## Supported IIssue properties + +| | Property | Remarks | +|------------------|-----------------------------------|----------------------------------| +| :material-check: | `IIssue.ProviderType` | | +| :material-check: | `IIssue.ProviderName` | | +| | `IIssue.Run` | Can be set while reading issues | +| :material-check: | `IIssue.Identifier` | Set to `IIssue.MessageText` | +| :material-check: | `IIssue.ProjectName` | | +| | `IIssue.ProjectFileRelativePath` | | +| :material-check: | `IIssue.AffectedFileRelativePath` | | +| :material-check: | `IIssue.Line` | | +| | `IIssue.EndLine` | | +| | `IIssue.Column` | | +| | `IIssue.EndColumn` | | +| | `IIssue.FileLink` | Can be set while reading issues | +| :material-check: | `IIssue.MessageText` | | +| | `IIssue.MessageHtml` | | +| | `IIssue.MessageMarkdown` | | +| :material-check: | `IIssue.Priority` | | +| :material-check: | `IIssue.PriorityName` | | +| :material-check: | `IIssue.Rule` | | +| :material-check: | `IIssue.RuleUrl` | For issues containing a Wiki Url | + +[JetBrains InsepectCode]: https://www.jetbrains.com/help/resharper/2017.1/InspectCode.html +[Cake.Issues.InspectCode addin]: https://www.nuget.org/packages/Cake.Issues.InspectCode diff --git a/docs/docs/documentation/issue-providers/inspectcode/index.md b/docs/docs/documentation/issue-providers/inspectcode/index.md new file mode 100644 index 000000000..41d8d068e --- /dev/null +++ b/docs/docs/documentation/issue-providers/inspectcode/index.md @@ -0,0 +1,7 @@ +--- +title: InspectCode +description: Issue provider which allows you to read issues logged by JetBrains Inspect Code. +--- + +Support for reading issues reported by [JetBrains Inspect Code](https://www.jetbrains.com/help/resharper/2017.1/InspectCode.html) +is implemented in the [Cake.Issues.InspectCode addin](https://www.nuget.org/packages/Cake.Issues.InspectCode). diff --git a/docs/input/docs/issue-providers/markdownlint/examples.md b/docs/docs/documentation/issue-providers/markdownlint/examples.md similarity index 79% rename from docs/input/docs/issue-providers/markdownlint/examples.md rename to docs/docs/documentation/issue-providers/markdownlint/examples.md index b81ddec24..02e9c56ec 100644 --- a/docs/input/docs/issue-providers/markdownlint/examples.md +++ b/docs/docs/documentation/issue-providers/markdownlint/examples.md @@ -1,8 +1,8 @@ --- -Order: 30 -Title: Examples -Description: Examples for using the Cake.Issues.Markdownlint addin. +title: Examples +description: Examples for using the Cake.Issues.Markdownlint addin. --- + The following example will call [markdownlint-cli] to lint some markdown files and outputs the number of warnings. To call [markdownlint-cli] from a Cake script you can use the [Cake.Markdownlint] addin. @@ -18,12 +18,11 @@ To read issues from markdownlint-cli log files you need to import the core addin #addin "Cake.Issues.Markdownlint" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. We need some global variables: diff --git a/docs/docs/documentation/issue-providers/markdownlint/features.md b/docs/docs/documentation/issue-providers/markdownlint/features.md new file mode 100644 index 000000000..71b134597 --- /dev/null +++ b/docs/docs/documentation/issue-providers/markdownlint/features.md @@ -0,0 +1,55 @@ +--- +title: Features +description: Features of the Cake.Issues.Markdownlint addin. +--- + +The [Cake.Issues.Markdownlint addin] provides the following features. + +## Basic features + +* Reads warnings from [Markdownlint] logfiles. +* Provides URLs for all issues. +* Support for custom URL resolving using the [MarkdownlintAddRuleUrlResolver] alias (except for [MarkdownlintCliJsonLogFileFormat]). + +## Supported log file formats + +* [MarkdownlintLogFileFormat] alias for reading issues from [Markdownlint] output generated with `options.resultVersion` set to 1. +* [MarkdownlintCliLogFileFormat] alias for reading issues from [markdownlint-cli] log files. +* [MarkdownlintCliJsonLogFileFormat] alias for reading issues from [markdownlint-cli] log files created with the `--json` parameter. + +!!! tip + [markdownlint-cli] can be run with the [Cake.Markdownlint] addin. + +## Supported IIssue properties + +| | Property | Remarks | +|------------------|-----------------------------------|-----------------------------------------| +| :material-check: | `IIssue.ProviderType` | | +| :material-check: | `IIssue.ProviderName` | | +| | `IIssue.Run` | Can be set while reading issues | +| :material-check: | `IIssue.Identifier` | Set to `IIssue.MessageText` | +| | `IIssue.ProjectName` | | +| | `IIssue.ProjectFileRelativePath` | | +| :material-check: | `IIssue.AffectedFileRelativePath` | | +| :material-check: | `IIssue.Line` | | +| | `IIssue.EndLine` | | +| :material-check: | `IIssue.Column` | Only for [MarkdownlintCliLogFileFormat] | +| | `IIssue.EndColumn` | | +| | `IIssue.FileLink` | Can be set while reading issues | +| :material-check: | `IIssue.MessageText` | | +| | `IIssue.MessageHtml` | | +| | `IIssue.MessageMarkdown` | | +| :material-check: | `IIssue.Priority` | Always [IssuePriority.Warning] | +| :material-check: | `IIssue.PriorityName` | Always `Warning` | +| :material-check: | `IIssue.Rule` | | +| :material-check: | `IIssue.RuleUrl` | Support for custom rules can be added through a custom [MarkdownlintAddRuleUrlResolver] except for [MarkdownlintCliJsonLogFileFormat] | + +[Cake.Issues.Markdownlint addin]: https://www.nuget.org/packages/Cake.Issues.Markdownlint +[Markdownlint]: https://github.com/DavidAnson/markdownlint +[markdownlint-cli]: https://github.com/igorshubovych/markdownlint-cli +[Cake.Markdownlint]: https://www.nuget.org/packages/Cake.Markdownlint/ +[MarkdownlintAddRuleUrlResolver]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/2EE35F55 +[MarkdownlintLogFileFormat]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/EBFF674A +[MarkdownlintCliLogFileFormat]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/B518F49E +[MarkdownlintCliJsonLogFileFormat]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/36DE6F5F +[IssuePriority.Warning]: ../../../api/Cake.Issues/IssuePriority/7A0CE07F diff --git a/docs/docs/documentation/issue-providers/markdownlint/index.md b/docs/docs/documentation/issue-providers/markdownlint/index.md new file mode 100644 index 000000000..a47bf5b78 --- /dev/null +++ b/docs/docs/documentation/issue-providers/markdownlint/index.md @@ -0,0 +1,7 @@ +--- +title: markdownlint +description: Issue provider which allows you to read issues logged by markdownlint. +--- + +Support for reading issues reported by [markdownlint](https://github.com/DavidAnson/markdownlint) +is implemented in the [Cake.Issues.Markdownlint addin](https://www.nuget.org/packages/Cake.Issues.Markdownlint). diff --git a/docs/input/docs/issue-providers/msbuild/examples.md b/docs/docs/documentation/issue-providers/msbuild/examples.md similarity index 81% rename from docs/input/docs/issue-providers/msbuild/examples.md rename to docs/docs/documentation/issue-providers/msbuild/examples.md index b00940182..2c9154a57 100644 --- a/docs/input/docs/issue-providers/msbuild/examples.md +++ b/docs/docs/documentation/issue-providers/msbuild/examples.md @@ -1,8 +1,8 @@ --- -Order: 30 -Title: Examples -Description: Examples for using the Cake.Issues.MsBuild addin. +title: Examples +description: Examples for using the Cake.Issues.MsBuild addin. --- + The following example will call MsBuild to build the solution and outputs the number of warnings. To read issues from MsBuild log files you need to import the core addin and the MsBuild support: @@ -19,12 +19,11 @@ In order to use the above logger, the following line will download and install t #tool "nuget:?package=MSBuild.Extension.Pack" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the packages. +!!! warning + Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the packages. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. We need some global variables: diff --git a/docs/docs/documentation/issue-providers/msbuild/features.md b/docs/docs/documentation/issue-providers/msbuild/features.md new file mode 100644 index 000000000..88b66e6da --- /dev/null +++ b/docs/docs/documentation/issue-providers/msbuild/features.md @@ -0,0 +1,47 @@ +--- +title: Features +description: Features of the Cake.Issues.MsBuild addin. +--- + +The [Cake.Issues.MsBuild addin] provides the following features. + +## Basic features + +* Reads errors and warnings from MSBuild log files. +* Provides URLs for all code analysis (`CA*`) and StyleCop (`SA*`) warnings. +* Support for custom URL resolving using the [MsBuildAddRuleUrlResolver] alias. + +## Supported log file formats + +* [MsBuildBinaryLogFileFormat] alias for reading issues from binary log files. +* [MsBuildXmlFileLoggerFormat] alias for reading issues from log files created by [MSBuild Extension Pack XmlFileLogger]. + +## Supported IIssue properties + +| | Property | Remarks | +|------------------|-----------------------------------|---------------------------------------| +| :material-check: | `IIssue.ProviderType` | | +| :material-check: | `IIssue.ProviderName` | | +| | `IIssue.Run` | Can be set while reading issues | +| :material-check: | `IIssue.Identifier` | Set to `IIssue.MessageText` | +| :material-check: | `IIssue.ProjectName` | | +| :material-check: | `IIssue.ProjectFileRelativePath` | | +| :material-check: | `IIssue.AffectedFileRelativePath` | | +| :material-check: | `IIssue.Line` | | +| | `IIssue.EndLine` | | +| :material-check: | `IIssue.Column` | Only for [MsBuildXmlFileLoggerFormat] | +| | `IIssue.EndColumn` | | +| | `IIssue.FileLink` | Can be set while reading issues | +| :material-check: | `IIssue.MessageText` | | +| | `IIssue.MessageHtml` | | +| | `IIssue.MessageMarkdown` | | +| :material-check: | `IIssue.Priority` | | +| :material-check: | `IIssue.PriorityName` | | +| :material-check: | `IIssue.Rule` | | +| :material-check: | `IIssue.RuleUrl` | For code analysis (`CA*`) and StyleCop (`SA*`) warnings. Support for additional rules can be added through a custom [MsBuildAddRuleUrlResolver] | + +[Cake.Issues.MsBuild addin]: https://www.nuget.org/packages/Cake.Issues.MsBuild +[MSBuild Extension Pack XmlFileLogger]: https://github.com/mikefourie-zz/MSBuildExtensionPack/blob/master/Solutions/Main/Loggers/Framework/XmlFileLogger.cs +[MsBuildAddRuleUrlResolver]: ../../../api/Cake.Issues.MsBuild/MsBuildIssuesAliases/93C21487 +[MsBuildBinaryLogFileFormat]: ../../../api/Cake.Issues.MsBuild/MsBuildIssuesAliases/AD50C7E1 +[MsBuildXmlFileLoggerFormat]: ../../../api/Cake.Issues.MsBuild/MsBuildIssuesAliases/051D7B6E diff --git a/docs/docs/documentation/issue-providers/msbuild/index.md b/docs/docs/documentation/issue-providers/msbuild/index.md new file mode 100644 index 000000000..6a139dd47 --- /dev/null +++ b/docs/docs/documentation/issue-providers/msbuild/index.md @@ -0,0 +1,7 @@ +--- +title: MsBuild +description: Issue provider which allows you to read warnings logged by MsBuild. +--- + +Support for reading warnings reported by MsBuild is implemented in the +[Cake.Issues.MsBuild](https://www.nuget.org/packages/Cake.Issues.MsBuild). diff --git a/docs/docs/documentation/issue-providers/terraform/features.md b/docs/docs/documentation/issue-providers/terraform/features.md new file mode 100644 index 000000000..ce1361efc --- /dev/null +++ b/docs/docs/documentation/issue-providers/terraform/features.md @@ -0,0 +1,37 @@ +--- +title: Features +description: Features of the Cake.Issues.Terraform addin. +--- + +The [Cake.Issues.Terraform addin] provides the following features: + +## Basic features + +* Reads warnings from [Terraform validate command]. + +## Supported IIssue properties + +| | Property | Remarks | +|------------------|-----------------------------------|----------------------------------| +| :material-check: | `IIssue.ProviderType` | | +| :material-check: | `IIssue.ProviderName` | | +| | `IIssue.Run` | Can be set while reading issues | +| :material-check: | `IIssue.Identifier` | Set to `IIssue.MessageText` | +| | `IIssue.ProjectName` | | +| | `IIssue.ProjectFileRelativePath` | | +| :material-check: | `IIssue.AffectedFileRelativePath` | | +| :material-check: | `IIssue.Line` | | +| :material-check: | `IIssue.EndLine` | | +| :material-check: | `IIssue.Column` | | +| :material-check: | `IIssue.EndColumn` | | +| | `IIssue.FileLink` | Can be set while reading issues | +| :material-check: | `IIssue.MessageText` | | +| | `IIssue.MessageHtml` | | +| | `IIssue.MessageMarkdown` | | +| :material-check: | `IIssue.Priority` | | +| :material-check: | `IIssue.PriorityName` | | +| :material-check: | `IIssue.Rule` | | +| | `IIssue.RuleUrl` | | + +[Terraform validate command]: https://www.terraform.io/docs/cli/commands/validate.html +[Cake.Issues.Terraform addin]: https://cakebuild.net/extensions/cake-issues-terraform/ diff --git a/docs/docs/documentation/issue-providers/terraform/index.md b/docs/docs/documentation/issue-providers/terraform/index.md new file mode 100644 index 000000000..5d0982d3c --- /dev/null +++ b/docs/docs/documentation/issue-providers/terraform/index.md @@ -0,0 +1,7 @@ +--- +title: Terraform +description: Issue provider which allows you to read issues from Terraform validate command. +--- + +Support for reading issues reported by [Terraform validate command](https://www.terraform.io/docs/cli/commands/validate.html) +is implemented in the [Cake.Issues.Terraform addin](https://cakebuild.net/extensions/cake-issues-terraform/). diff --git a/docs/input/docs/overview/features.md b/docs/docs/documentation/overview/features.md similarity index 93% rename from docs/input/docs/overview/features.md rename to docs/docs/documentation/overview/features.md index cb1def00a..09bae27f2 100644 --- a/docs/input/docs/overview/features.md +++ b/docs/docs/documentation/overview/features.md @@ -1,20 +1,21 @@ --- -Order: 20 -Description: Overview about core features. +title: Features +description: Overview about core features. --- + The Cake Issues addins for Cake allows you to read issues from any analyzer or linter, create reports or write issues to comments in pull requests. -# Recipe Functionality +## Recipe Functionality See [Supported Tools] for a list of tools supported by [Cake.Issues.Recipe]. -# Supported Core Functionality +## Supported Core Functionality The core addins provide a modular architecture, allowing to easily enhance it for supporting additional analyzers, linters, report formats and code review systems. -## Cake.Issues +### Cake.Issues Addin for creating and reading issues providing the following functionality: @@ -25,14 +26,14 @@ Addin for creating and reading issues providing the following functionality: * Support for creating links to file & location on source code hosting system (GitHub, Azure Repos, etc). * Support for passing additional run information to identify specific runs. -## Cake.Issues.Reporting +### Cake.Issues.Reporting Addin for creating reports providing the following functionality: * [CreateIssueReport] aliases for creating reports about issues. * Support for creating reports with issues from multiple issue providers. -## Cake.Issues.PullRequests +### Cake.Issues.PullRequests Addin for writing issues as comments to pull requests providing the following functionality: @@ -55,15 +56,15 @@ Concrete pull request systems can implement optional capabilities which will pro * Automatic reopening of still existing issues which are already closed on pull request. * Comparing issues by identifier to not rely on message or line numbers. -# Supported Issue Providers +## Supported Issue Providers See [Issue Provider Addins] for a list of currently supported analyzers and linters. -# Supported Report Formats +## Supported Report Formats See [Report Format Addins] for a list of currently supported report output formats. -# Supported Pull Request Systems +## Supported Pull Request Systems See [Pull Request System Addins] for a list of currently supported pull request systems. diff --git a/docs/input/docs/overview/introduction.md b/docs/docs/documentation/overview/introduction.md similarity index 62% rename from docs/input/docs/overview/introduction.md rename to docs/docs/documentation/overview/introduction.md index 62ba24292..11256d3dd 100644 --- a/docs/input/docs/overview/introduction.md +++ b/docs/docs/documentation/overview/introduction.md @@ -1,7 +1,8 @@ --- -Order: 10 -Description: Introduction +title: Introduction +description: Introduction --- + Do you want to break your build on JetBrains InspectCode issues? Do you want to create nice reports for StyleCop issues in your code? Do you want to have ESLint issues reported as comments to pull requests? @@ -22,18 +23,14 @@ working together and providing over 75 aliases which can be used in Cake build s The addins are built in a [modular architecture] and are providing different [extension points] which allows to easily enhance them for supporting additional analyzers, linters, report formats and code review systems. -:::{.alert .alert-success} -To get started you can use one of the [Cake.Issues recipes], which bring support for different linters and -integration with build and pull request systems out-of-the box in a single and easy to use NuGet package. -::: - - - Presentation - - - Tutorials - - -[modular architecture]: /docs/fundamentals/architecture -[extension points]: /docs/extending/ -[Cake.Issues recipes]: /docs/recipe/overview +!!! tip + To get started you can use one of the [Cake.Issues recipes], which bring support for different linters and + integration with build and pull request systems out-of-the box in a single and easy to use NuGet package. + +[:fontawesome-solid-video: Presentation](https://gitpitch.com/pascalberger/Cake.Issues-Presentation){ .md-button } + +[:fontawesome-solid-graduation-cap: Tutorials](../../usage){ .md-button } + +[modular architecture]: ../../fundamentals/architecture +[extension points]: ../../extending/ +[Cake.Issues recipes]: ../../recipe/overview diff --git a/docs/docs/documentation/overview/requirements.md b/docs/docs/documentation/overview/requirements.md new file mode 100644 index 000000000..0c67ccd3c --- /dev/null +++ b/docs/docs/documentation/overview/requirements.md @@ -0,0 +1,8 @@ +--- +title: Requirements +description: Requirements for using Cake.Issues. +--- + +The requirements are listed in the [release notes] for any specific version + +[Release notes]: https://github.com/cake-contrib/Cake.Issues/releases diff --git a/docs/input/docs/pull-request-systems/appveyor/appveyor-messages.png b/docs/docs/documentation/pull-request-systems/appveyor/appveyor-messages.png similarity index 100% rename from docs/input/docs/pull-request-systems/appveyor/appveyor-messages.png rename to docs/docs/documentation/pull-request-systems/appveyor/appveyor-messages.png diff --git a/docs/input/docs/pull-request-systems/appveyor/examples/github-pullrequest-integration.md b/docs/docs/documentation/pull-request-systems/appveyor/examples/github-pullrequest-integration.md similarity index 87% rename from docs/input/docs/pull-request-systems/appveyor/examples/github-pullrequest-integration.md rename to docs/docs/documentation/pull-request-systems/appveyor/examples/github-pullrequest-integration.md index 2620901b5..f4449a404 100644 --- a/docs/input/docs/pull-request-systems/appveyor/examples/github-pullrequest-integration.md +++ b/docs/docs/documentation/pull-request-systems/appveyor/examples/github-pullrequest-integration.md @@ -1,8 +1,8 @@ --- -Order: 20 -Title: GitHub pull request integration -Description: Example how to write AppVeyor message to GitHub pull requests. +title: GitHub pull request integration +description: Example how to write AppVeyor message to GitHub pull requests. --- + This example shows how to write AppVeyor messages created by Cake.Issues to GitHub pull requests. Issues reported as messages to AppVeyor builds can be written to a GitHub pull request using [GitHub Pull Request Notification] @@ -21,4 +21,4 @@ The output will look similar to this: ![GitHub pull request integration](github-pullrequest-integration.png "GitHub pull request integration") -[GitHub Pull Request Notification]: https://www.appveyor.com/docs/notifications/#github-pull-request \ No newline at end of file +[GitHub Pull Request Notification]: https://www.appveyor.com/docs/notifications/#github-pull-request diff --git a/docs/input/docs/pull-request-systems/appveyor/examples/github-pullrequest-integration.png b/docs/docs/documentation/pull-request-systems/appveyor/examples/github-pullrequest-integration.png similarity index 100% rename from docs/input/docs/pull-request-systems/appveyor/examples/github-pullrequest-integration.png rename to docs/docs/documentation/pull-request-systems/appveyor/examples/github-pullrequest-integration.png diff --git a/docs/docs/documentation/pull-request-systems/appveyor/examples/index.md b/docs/docs/documentation/pull-request-systems/appveyor/examples/index.md new file mode 100644 index 000000000..4fd332421 --- /dev/null +++ b/docs/docs/documentation/pull-request-systems/appveyor/examples/index.md @@ -0,0 +1,8 @@ +--- +title: Examples +description: Examples for using the Cake.Issues.PullRequests.AppVeyor addin. +--- + +!!! info + There's a [demo repository](https://github.com/pascalberger/Cake.Issues-Demo) + available which you can fork and to which you can create pull requests to test the integration functionality. diff --git a/docs/input/docs/pull-request-systems/appveyor/examples/write-messages.md b/docs/docs/documentation/pull-request-systems/appveyor/examples/write-messages.md similarity index 70% rename from docs/input/docs/pull-request-systems/appveyor/examples/write-messages.md rename to docs/docs/documentation/pull-request-systems/appveyor/examples/write-messages.md index 10cccdfb4..e09d56ccc 100644 --- a/docs/input/docs/pull-request-systems/appveyor/examples/write-messages.md +++ b/docs/docs/documentation/pull-request-systems/appveyor/examples/write-messages.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: Writing message to AppVeyor -Description: Example how to write issues as messages to an AppVeyor build. +title: Writing message to AppVeyor +description: Example how to write issues as messages to an AppVeyor build. --- + This example shows how to report issues as messages to an AppVeyor build. To report issues as messages to an AppVeyor build you need to import the core addin, @@ -16,12 +16,11 @@ in this example for JetBrains InspectCode: #addin "Cake.Issues.PullRequests.AppVeyor" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. In the following task we'll first determine the remote repository URL and source branch of the pull request and with this information call the [AppVeyorBuilds] alias: @@ -43,4 +42,4 @@ The output will look similar to this: ![AppVeyor messages](../appveyor-messages.png "AppVeyor messages") -[AppVeyorBuilds]: ../../../../api/Cake.Issues.PullRequests.AppVeyor/AppVeyorBuildsAliases/ \ No newline at end of file +[AppVeyorBuilds]: ../../../../api/Cake.Issues.PullRequests.AppVeyor/AppVeyorBuildsAliases/ diff --git a/docs/docs/documentation/pull-request-systems/appveyor/features.md b/docs/docs/documentation/pull-request-systems/appveyor/features.md new file mode 100644 index 000000000..ae9c6de5a --- /dev/null +++ b/docs/docs/documentation/pull-request-systems/appveyor/features.md @@ -0,0 +1,31 @@ +--- +title: Features +description: Features of the Cake.Issues.PullRequests.AppVeyor addin. +--- + +The [Cake.Issues.PullRequests.AppVeyor addin] reports issues as messages to AppVeyor builds. + +![AppVeyor messages](appveyor-messages.png "AppVeyor messages") + +!!! info + There's a [demo repository] available which you can fork and to which you can create pull requests to test the integration functionality. + +## Basic features + +* Reports issues as messages to AppVeyor builds. +* Messages can be written as comment to GitHub pull requests. + See [GitHub pull request integration] for an example. + +## Supported capabilities + +The [Cake.Issues.PullRequests.AppVeyor addin] doesn't support any additional capabilities. + +| | Capability | Remarks | +|------------------|--------------------------------|--------------------------------| +| | Checking commit ID | | +| | Discussion threads | | +| | Filtering by modified files | | + +[demo repository]: https://github.com/pascalberger/Cake.Issues-Demo +[Cake.Issues.PullRequests.AppVeyor addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.AppVeyor +[GitHub pull request integration]: ./examples/github-pullrequest-integration diff --git a/docs/docs/documentation/pull-request-systems/appveyor/index.md b/docs/docs/documentation/pull-request-systems/appveyor/index.md new file mode 100644 index 000000000..3d0b41007 --- /dev/null +++ b/docs/docs/documentation/pull-request-systems/appveyor/index.md @@ -0,0 +1,7 @@ +--- +title: AppVeyor +description: Support for AppVeyor. +--- + +Support for AppVeyor is implemented in the +[Cake.Issues.PullRequests.AppVeyor addin](https://www.nuget.org/packages/Cake.Issues.PullRequests.AppVeyor). diff --git a/docs/input/docs/pull-request-systems/azure-devops/cake.issues.pullrequests.azuredevops.png b/docs/docs/documentation/pull-request-systems/azure-devops/cake.issues.pullrequests.azuredevops.png similarity index 100% rename from docs/input/docs/pull-request-systems/azure-devops/cake.issues.pullrequests.azuredevops.png rename to docs/docs/documentation/pull-request-systems/azure-devops/cake.issues.pullrequests.azuredevops.png diff --git a/docs/input/docs/pull-request-systems/azure-devops/examples/azure-pipelines.md b/docs/docs/documentation/pull-request-systems/azure-devops/examples/azure-pipelines.md similarity index 78% rename from docs/input/docs/pull-request-systems/azure-devops/examples/azure-pipelines.md rename to docs/docs/documentation/pull-request-systems/azure-devops/examples/azure-pipelines.md index 6078ba5ac..18a8fe2ac 100644 --- a/docs/input/docs/pull-request-systems/azure-devops/examples/azure-pipelines.md +++ b/docs/docs/documentation/pull-request-systems/azure-devops/examples/azure-pipelines.md @@ -1,8 +1,8 @@ --- -Order: 30 -Title: Using with Azure Pipelines -Description: Example how to use the Cake.Issues.PullRequests.AzureDevOps addin from an Azure Pipelines build. +title: Using with Azure Pipelines +description: Example how to use the Cake.Issues.PullRequests.AzureDevOps addin from an Azure Pipelines build. --- + This example shows how to write issues as comments to an Azure DevOps pull request from an Azure Pipelines build. To write issues as comments to Azure DevOps pull requests you need to import the core addin, @@ -17,23 +17,21 @@ in this example for JetBrains InspectCode: #addin "Cake.AzureDevOps" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. In the following task we'll first determine if the build is running on Azure DevOps and for a pull request, -then read the remote repository URL and pull request id from environment variables set by the Azure Pipelines build +then read the remote repository URL and pull request id from environment variables set by the Azure Pipelines build and finally call the [AzureDevOpsPullRequests] alias using the OAuth token provided by the Azure Pipeline build. -:::{.alert .alert-info} -Please note that you'll need to setup your Azure Pipelines build to allow scripts to -access the OAuth token and need to setup proper permissions. +!!! info + Please note that you'll need to setup your Azure Pipelines build to [Allow scripts to access the OAuth token] + and need to setup proper permissions. -See [OAuth authentication from Azure Pipelines] for details. -::: + See [OAuth authentication from Azure Pipelines] for details. ```csharp Task("ReportIssuesToPullRequest").Does(() => @@ -80,4 +78,4 @@ Task("ReportIssuesToPullRequest").Does(() => [AzureDevOpsPullRequests]: ../../../../api/Cake.Issues.PullRequests.AzureDevOps/AzureDevOpsPullRequestSystemAliases/64912B0A [Allow scripts to access the OAuth token]: https://docs.microsoft.com/en-us/azure/devops/pipelines/build/options#allow-scripts-to-access-the-oauth-token -[OAuth authentication from Azure Pipelines]: ../setup#oauth-authentication-from-azure-pipelines +[OAuth authentication from Azure Pipelines]: ../../setup#oauth-authentication-from-azure-pipelines diff --git a/docs/docs/documentation/pull-request-systems/azure-devops/examples/index.md b/docs/docs/documentation/pull-request-systems/azure-devops/examples/index.md new file mode 100644 index 000000000..1ec97dfb9 --- /dev/null +++ b/docs/docs/documentation/pull-request-systems/azure-devops/examples/index.md @@ -0,0 +1,8 @@ +--- +title: Examples +description: Examples for using the Cake.Issues.PullRequests.AzureDevOps addin. +--- + +!!! info + There's a [demo repository](https://dev.azure.com/pberger/Cake.Issues-Demo){target="_blank"} + available which you can fork and to which you can create pull requests to test the integration functionality. diff --git a/docs/input/docs/pull-request-systems/azure-devops/examples/pullrequest-id.md b/docs/docs/documentation/pull-request-systems/azure-devops/examples/pullrequest-id.md similarity index 79% rename from docs/input/docs/pull-request-systems/azure-devops/examples/pullrequest-id.md rename to docs/docs/documentation/pull-request-systems/azure-devops/examples/pullrequest-id.md index 843390dfc..af54c2490 100644 --- a/docs/input/docs/pull-request-systems/azure-devops/examples/pullrequest-id.md +++ b/docs/docs/documentation/pull-request-systems/azure-devops/examples/pullrequest-id.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: Using with pull request id -Description: Example how to use the Cake.Issues.PullRequests.AzureDevOps addin with pull request id. +title: Using with pull request id +description: Example how to use the Cake.Issues.PullRequests.AzureDevOps addin with pull request id. --- + This example shows how to write issues as comments to an Azure DevOps pull request while using pull request id. To determine the remote repository URL you need the [Cake.Git] addin: @@ -23,12 +23,11 @@ in this example for JetBrains InspectCode: #addin "Cake.AzureDevOps" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. In the following task we'll first determine the remote repository URL and with this information call the [AzureDevOpsPullRequests] alias, diff --git a/docs/input/docs/pull-request-systems/azure-devops/examples/repository-information.md b/docs/docs/documentation/pull-request-systems/azure-devops/examples/repository-information.md similarity index 79% rename from docs/input/docs/pull-request-systems/azure-devops/examples/repository-information.md rename to docs/docs/documentation/pull-request-systems/azure-devops/examples/repository-information.md index 804ef7cfd..6cf51220f 100644 --- a/docs/input/docs/pull-request-systems/azure-devops/examples/repository-information.md +++ b/docs/docs/documentation/pull-request-systems/azure-devops/examples/repository-information.md @@ -1,8 +1,8 @@ --- -Order: 20 -Title: Using with repository remote url and source branch name -Description: Example how to use the Cake.Issues.PullRequests.AzureDevOps addin with repository remote url and source branch name. +title: Using with repository remote url and source branch name +description: Example how to use the Cake.Issues.PullRequests.AzureDevOps addin with repository remote url and source branch name. --- + This example shows how to write issues as comments to an Azure DevOps pull request while using repository information. To determine the remote repository URL and source branch of the pull request you need the [Cake.Git] addin: @@ -23,12 +23,11 @@ in this example for JetBrains InspectCode: #addin "Cake.AzureDevOps" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. In the following task we'll first determine the remote repository URL and source branch of the pull request and with this information call the [AzureDevOpsPullRequests] alias, diff --git a/docs/docs/documentation/pull-request-systems/azure-devops/features.md b/docs/docs/documentation/pull-request-systems/azure-devops/features.md new file mode 100644 index 000000000..0140ee257 --- /dev/null +++ b/docs/docs/documentation/pull-request-systems/azure-devops/features.md @@ -0,0 +1,47 @@ +--- +title: Features +description: Features of the Cake.Issues.PullRequests.AzureDevOps addin. +--- + +The [Cake.Issues.PullRequests.AzureDevOps addin] provides the following features. + +!!! info + There's a [demo repository] available which you can fork and to which you can create pull requests to test the integration functionality. + +## Basic features + +* Writes issues as comments to [Azure DevOps] pull requests. +* Identification of pull requests through source branch or pull request ID. +* Comments written by the addin will be rendered with a specific icon corresponding to the state of the issue. +* Adds rule number and, if provided by the issue provider, link to the rule description to the comment. +* Support for issues messages formatted in Markdown format. + +## Supported capabilities + +The [Cake.Issues.PullRequests.AzureDevOps addin] supports all [Core features]. + +| | Capability | Remarks | +|------------------|--------------------------------|--------------------------------| +| :material-check: | Checking commit ID | | +| :material-check: | Discussion threads | | +| :material-check: | Filtering by modified files | | + +## Supported authentication methods + +| Azure DevOps Server | Azure DevOps Service | Authentication method | +|---------------------|----------------------|--------------------------------| +| :material-check: | | NTLM | +| :material-check: | | Basic authentication | +| :material-check: | :material-check: | Personal access token | +| | :material-check: | OAuth | +| | :material-check: | Azure Active Directory | + +For detailed instructions how to connect using the different methods see [Setup instructions]. + +![Cake.Issues.PullRequests.AzureDevOps](cake.issues.pullrequests.azuredevops.png "Cake.Issues.PullRequests.AzureDevOps") + +[demo repository]: https://dev.azure.com/pberger/Cake.Issues-Demo +[Cake.Issues.PullRequests.AzureDevOps addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.AzureDevOps +[Azure DevOps]: https://azure.microsoft.com/en-us/services/devops/ +[Core features]: ../../overview/features#supported-core-functionality +[Setup instructions]: setup diff --git a/docs/docs/documentation/pull-request-systems/azure-devops/index.md b/docs/docs/documentation/pull-request-systems/azure-devops/index.md new file mode 100644 index 000000000..14f386e65 --- /dev/null +++ b/docs/docs/documentation/pull-request-systems/azure-devops/index.md @@ -0,0 +1,7 @@ +--- +title: Azure DevOps +description: Support for Azure DevOps. +--- + +Support for Azure DevOps is implemented in the +[Cake.Issues.PullRequests.AzureDevOps addin](https://www.nuget.org/packages/Cake.Issues.PullRequests.AzureDevOps). diff --git a/docs/input/docs/pull-request-systems/azure-devops/setup.md b/docs/docs/documentation/pull-request-systems/azure-devops/setup.md similarity index 80% rename from docs/input/docs/pull-request-systems/azure-devops/setup.md rename to docs/docs/documentation/pull-request-systems/azure-devops/setup.md index ac9f128bb..1067affcf 100644 --- a/docs/input/docs/pull-request-systems/azure-devops/setup.md +++ b/docs/docs/documentation/pull-request-systems/azure-devops/setup.md @@ -1,34 +1,32 @@ --- -Order: 30 -Title: Setup -Description: Instructions how to setup the Cake.Issues.PullRequests.AzureDevOps addin. +title: Setup +description: Instructions how to setup the Cake.Issues.PullRequests.AzureDevOps addin. --- + This page describes the different ways how the [Cake.Issues.PullRequests.AzureDevOps addin] can be setup. -# NTLM authentication +## NTLM authentication -:::{.alert .alert-info} -NTLM authentication is only available for on-premise Azure DevOps Server. -::: +!!! info + NTLM authentication is only available for on-premise Azure DevOps Server. To authenticate with NTLM you can use the [AzureDevOpsAuthenticationNtlm] alias from the [Cake.AzureDevOps addin]. The user needs to have `Contribute to pull requests` permission for the specific repository to allow [Cake.Issues.PullRequests.AzureDevOps addin] to post issues as comments to pull requests. -# Basic authentication +## Basic authentication -:::{.alert .alert-info} -Basic authentication is only available for on-premise Azure DevOps Server. -::: +!!! info + Basic authentication is only available for on-premise Azure DevOps Server. To authenticate with basic authentication you can use the [AzureDevOpsAuthenticationBasic] alias from the [Cake.AzureDevOps addin] and -need to [Configure AzureDevOps Server to use Basic Authentication]. +need to [Configure Azure DevOps Server to use Basic Authentication]. The user needs to have `Contribute to pull requests` permission for the specific repository to allow [Cake.Issues.PullRequests.AzureDevOps addin] to post issues as comments to pull requests. -# Personal access token +## Personal access token To authenticate with an personal access token you can use the [AzureDevOpsAuthenticationPersonalAccessToken] alias from the [Cake.AzureDevOps addin]. @@ -39,11 +37,10 @@ a personal access token. The access token needs to have the scope `Code (read and write)` set and the user needs to have `Contribute to pull requests` permission for the specific repository to allow [Cake.Issues.PullRequests.AzureDevOps addin] to post issues as comments to pull requests. -# OAuth authentication from Azure Pipelines +## OAuth authentication from Azure Pipelines -:::{.alert .alert-info} -OAuth authentication is only available for Azure DevOps Service. -::: +!!! info + OAuth authentication is only available for Azure DevOps Service. If you want to use the [Cake.Issues.PullRequests.AzureDevOps addin] from an Azure Pipelines you can authenticate using the OAuth token provided to the build. @@ -55,11 +52,10 @@ The user under which the build runs, named ` Build Service (    `OutputDirectory` | `IssuesContext.Parameters.`
    `OutputDirectory` | `BuildArtifacts` | Path to the output directory. A relative path will be relative to the current working directory. | | `IssuesParameters.`
    `BuildIdentifier` | `IssuesContext.Parameters.`
    `BuildIdentifier` | `string.Empty` | Identifier for the build run. If set this identifier will be used to identify to artifacts provided by the build if building on multiple configurations. | -# Input files +## Input files | Cake.Issues.Recipe Methods | Cake.Frosting.Issues.Recipe Methods | Description | |------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------| @@ -53,7 +52,7 @@ By default [Cake.Git addin] will be used. [ESLint json formatter]: https://eslint.org/docs/user-guide/formatters/#json -# Report creation +## Report creation | Cake.Issues.Recipe Property | Cake.Frosting.Issues.Recipe Property | Default Value | Description | |-------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| @@ -65,7 +64,7 @@ By default [Cake.Git addin] will be used. [Template Gallery]: /docs/report-formats/generic/templates/ -# Build server integration +## Build server integration | Cake.Issues.Recipe Property | Cake.Frosting.Issues.Recipe Property | Default Value | Description | |-----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|---------------|------------------------------------------------------------------------------------------------| @@ -74,7 +73,7 @@ By default [Cake.Git addin] will be used. | `IssuesParameters.BuildServer.`
    `ShouldPublishSarifReport` | `IssuesContext.Parameters.BuildServer.`
    `ShouldPublishSarifReport` | `true` | Indicates whether report int SARIF format shoudl be published as artifact to the build system. | | `IssuesParameters.BuildServer.`
    `ShouldCreateSummaryIssuesReport` | `IssuesContext.Parameters.BuildServer.`
    `ShouldCreateSummaryIssuesReport` | `true` | Indicates whether summary issues report should be created. | -# Pull request integration +## Pull request integration | Cake.Issues.Recipe Property | Cake.Frosting.Issues.Recipe Property | Default Value | Description | |----------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/docs/input/docs/recipe/demos.md b/docs/docs/documentation/recipe/demos.md similarity index 91% rename from docs/input/docs/recipe/demos.md rename to docs/docs/documentation/recipe/demos.md index b8cca3e9b..36fa3c149 100644 --- a/docs/input/docs/recipe/demos.md +++ b/docs/docs/documentation/recipe/demos.md @@ -1,7 +1,6 @@ --- -Order: 40 -Title: Demos -Description: Demo setups for Cake.Issues recipes. +title: Demos +description: Demo setups for Cake.Issues recipes. --- There are demo setups available for different combinations of build servers and repositories which you can fork and to which you can create pull requests diff --git a/docs/input/docs/recipe/index.cshtml b/docs/docs/documentation/recipe/index.cshtml similarity index 100% rename from docs/input/docs/recipe/index.cshtml rename to docs/docs/documentation/recipe/index.cshtml diff --git a/docs/input/docs/recipe/overview.md b/docs/docs/documentation/recipe/overview.md similarity index 98% rename from docs/input/docs/recipe/overview.md rename to docs/docs/documentation/recipe/overview.md index b7b44b218..8b304df54 100644 --- a/docs/input/docs/recipe/overview.md +++ b/docs/docs/documentation/recipe/overview.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: Overview -Description: Overview about Cake.Issues recipes. +title: Overview +description: Overview about Cake.Issues recipes. --- + Cake.Issues recipes provide build scripts, delivered as a NuGet package, which can be used inside your projects Cake build to add issue management. Integration of code analyzing and linting tools into a build pipeline often looks the similar, and differentiates mainly on the used linters, build and pull request systems. @@ -14,11 +14,11 @@ There are two flavors available: * [Cake.Issues.Recipe]: For [Cake .NET Tool], [Cake runner for .NET Framework] or [Cake runner for .NET Core] * [Cake.Frosting.Issues.Recipe]: For [Cake Frosting] -# Supported tools +## Supported tools See [supported tools] for a list of supported linters, build servers and pull request systems. -# Bundled addins +## Bundled addins Cake.Issues recipes will add the following addins to your build: diff --git a/docs/input/docs/recipe/supported-tools.md b/docs/docs/documentation/recipe/supported-tools.md similarity index 66% rename from docs/input/docs/recipe/supported-tools.md rename to docs/docs/documentation/recipe/supported-tools.md index e62805806..0b8a30fa7 100644 --- a/docs/input/docs/recipe/supported-tools.md +++ b/docs/docs/documentation/recipe/supported-tools.md @@ -1,12 +1,11 @@ --- -Order: 30 -Title: Supported tools -Description: Tools supported by Cake.Issues recipes. +title: Supported tools +description: Tools supported by Cake.Issues recipes. --- Cake.Issues recipes support reading issues from different tools and integrates with different build and pull request systems. -# Tools +## Tools Cake.Issues recipes support reading issues from output of the following tools: @@ -28,21 +27,21 @@ Cake.Issues recipes support reading issues from output of the following tools: [json formatter]: https://eslint.org/docs/user-guide/formatters/#json [SARIF]: https://sarifweb.azurewebsites.net/ -# Build systems +## Build systems Cake.Issues recipes integrates with the following build systems: -| Build System | Write issues to build server | Issues summary | Full issues report | -|--------------------------------|-----------------------------------------------------------------------------------|--------------------------------------------------------------------|--------------------------------------------------------------------| -| AppVeyor | | | | -| Azure Pipelines (Azure DevOps) | (Only first 10) | | | -| GitHub Actions | | | | +| Build System | Write issues to build server | Issues summary | Full issues report | +|--------------------------------|----------------------------------|--------------------|--------------------| +| AppVeyor | :material-check: | | :material-check: | +| Azure Pipelines (Azure DevOps) | :material-check: (Only first 10) | :material-check: | :material-check: | +| GitHub Actions | :material-check: | | | -# Pull request systems +## Pull request systems Cake.Issues recipes integrates with the following pull request systems: -| Pull Request System | Write issues to pull requests | Set pull request status | -|----------------------------|----------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| -| Azure Repos (Azure DevOps) | | | -| GitHub | (When build from GitHub Actions) | | +| Pull Request System | Write issues to pull requests | Set pull request status | +|----------------------------|---------------------------------------------------|-------------------------| +| Azure Repos (Azure DevOps) | :material-check: | :material-check: | +| GitHub | :material-check: (When build from GitHub Actions) | | diff --git a/docs/input/docs/recipe/tasks.md b/docs/docs/documentation/recipe/tasks.md similarity index 97% rename from docs/input/docs/recipe/tasks.md rename to docs/docs/documentation/recipe/tasks.md index 1af33410c..040353b1a 100644 --- a/docs/input/docs/recipe/tasks.md +++ b/docs/docs/documentation/recipe/tasks.md @@ -1,7 +1,6 @@ --- -Order: 60 -Title: Tasks -Description: Tasks provided by Cake.Issues recipes. +title: Tasks +description: Tasks provided by Cake.Issues recipes. --- Cake.Issues recipes provide the following tasks to your build script: diff --git a/docs/docs/documentation/recipe/usage/index.md b/docs/docs/documentation/recipe/usage/index.md new file mode 100644 index 000000000..ba4113ced --- /dev/null +++ b/docs/docs/documentation/recipe/usage/index.md @@ -0,0 +1,4 @@ +--- +title: Usage +description: How to use Cake.Issues recipes in your build script. +--- diff --git a/docs/input/docs/recipe/usage/using-cake-frosting-issues-recipe.md b/docs/docs/documentation/recipe/usage/using-cake-frosting-issues-recipe.md similarity index 86% rename from docs/input/docs/recipe/usage/using-cake-frosting-issues-recipe.md rename to docs/docs/documentation/recipe/usage/using-cake-frosting-issues-recipe.md index 7a3715520..415a8c94d 100644 --- a/docs/input/docs/recipe/usage/using-cake-frosting-issues-recipe.md +++ b/docs/docs/documentation/recipe/usage/using-cake-frosting-issues-recipe.md @@ -1,17 +1,16 @@ --- -Order: 20 -Title: Using Cake.Frosting.Issues.Recipe -Description: Basic usage of Cake.Frosting.Issues.Recipe. +title: Using Cake.Frosting.Issues.Recipe +description: Basic usage of Cake.Frosting.Issues.Recipe. --- + The [Cake.Frosting.Issues.Recipe] package can be used to easily add issue management functionality to your Cake Frosting build. -:::{.alert .alert-info} -See [Setting Up A New Frosting Project] for instructions how to create a new Cake Frosting project. -::: +!!! info + See [Setting Up A New Frosting Project] for instructions how to create a new Cake Frosting project. [Setting Up A New Frosting Project]: https://cakebuild.net/docs/getting-started/setting-up-a-new-frosting-project -# Add Cake.Frosting.Issues.Recipe to your Cake Frosting build +## Add Cake.Frosting.Issues.Recipe to your Cake Frosting build To use [Cake.Frosting.Issues.Recipe] in your Cake Frosting build you need to first add the NuGet package in your `.csproj` file: @@ -19,11 +18,10 @@ To use [Cake.Frosting.Issues.Recipe] in your Cake Frosting build you need to fir ``` -:::{.alert .alert-warning} -Replace the version (`1.0.0`) with the version of Cake.Frosting.Issues.Recipe you want to use. -::: +!!! warning + Replace the version (`1.0.0`) with the version of Cake.Frosting.Issues.Recipe you want to use. -# Register Cake.Issues tasks +## Register Cake.Issues tasks To make Cake Issues tasks available to your Cake Frosting build you need to register them. @@ -54,7 +52,7 @@ public static class Program } ``` -# Create build context +## Create build context [Cake.Frosting.Issues.Recipe] provides a build context from which you need to inherit your custom build context. The build context contains configuration parameters, but also the state of the current running build, @@ -73,7 +71,7 @@ public class BuildContext : IssuesContext } ``` -# Passing issues to Cake.Frosting.Issues.Recipe +## Passing issues to Cake.Frosting.Issues.Recipe To make issues available to [Cake.Frosting.Issues.Recipe] you need pass the log files through the corresponding methods. The tasks need to also be a dependency of `ReadIssuesTask` provided by [Cake.Frosting.Issues.Recipe]. @@ -104,7 +102,7 @@ public class RunInspectCodeTask : FrostingTask See [configuration] for a full list of available configuration parameters. -# Calling issues tasks +## Calling issues tasks [Cake.Frosting.Issues.Recipe] will add a bunch of [tasks] to your build script. diff --git a/docs/input/docs/recipe/usage/using-cake-issues-recipe.md b/docs/docs/documentation/recipe/usage/using-cake-issues-recipe.md similarity index 77% rename from docs/input/docs/recipe/usage/using-cake-issues-recipe.md rename to docs/docs/documentation/recipe/usage/using-cake-issues-recipe.md index 71cbc419a..3e4b25150 100644 --- a/docs/input/docs/recipe/usage/using-cake-issues-recipe.md +++ b/docs/docs/documentation/recipe/usage/using-cake-issues-recipe.md @@ -1,11 +1,11 @@ --- -Order: 10 -Title: Using Cake.Issues.Recipe -Description: Basic usage of Cake.Issues.Recipe. +title: Using Cake.Issues.Recipe +description: Basic usage of Cake.Issues.Recipe. --- + The [Cake.Issues.Recipe] package can be used to easily add issue management functionality to your build script. -# Add Cake.Issues.Recipe to your build script +## Add Cake.Issues.Recipe to your build script To use Cake.Issues.Recipe in your build script you need to first load the NuGet package: @@ -13,14 +13,13 @@ To use Cake.Issues.Recipe in your build script you need to first load the NuGet #load nuget:package=Cake.Issues.Recipe ``` -:::{.alert .alert-warning} -Please note that you always should pin NuGet packages to a specific version to make sure your builds are deterministic and -won't break due to updates to Cake.Issues.Recipe. +!!! warning + Please note that you always should pin NuGet packages to a specific version to make sure your builds are deterministic and + won't break due to updates to Cake.Issues.Recipe. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -# Configuring Cake.Issues.Recipe +## Configuring Cake.Issues.Recipe To make issues available to Cake.Issues.Recipe you need to set the corresponding configuration parameters. @@ -41,7 +40,7 @@ Task("Configure-CakeIssuesRecipe") See [configuration] for a full list of available configuration parameters. -# Calling issues tasks +## Calling issues tasks Cake.Issues.Recipe will add a bunch of [tasks] to your build script. diff --git a/docs/input/docs/report-formats/console/examples.md b/docs/docs/documentation/report-formats/console/examples.md similarity index 77% rename from docs/input/docs/report-formats/console/examples.md rename to docs/docs/documentation/report-formats/console/examples.md index ea9f76c5d..5089d4ba0 100644 --- a/docs/input/docs/report-formats/console/examples.md +++ b/docs/docs/documentation/report-formats/console/examples.md @@ -1,16 +1,15 @@ --- -Order: 30 -Title: Examples -Description: Examples for using the Cake.Issues.Reporting.Console addin. +title: Examples +description: Examples for using the Cake.Issues.Reporting.Console addin. --- + The following example will print issues logged as warnings by MsBuild to the console. -:::{.alert .alert-warning} -Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the packages. +!!! warning + Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the packages. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. ```csharp #tool "nuget:?package=MSBuild.Extension.Pack" diff --git a/docs/input/docs/report-formats/console/features.md b/docs/docs/documentation/report-formats/console/features.md similarity index 57% rename from docs/input/docs/report-formats/console/features.md rename to docs/docs/documentation/report-formats/console/features.md index 77b9ec143..45d0210ef 100644 --- a/docs/input/docs/report-formats/console/features.md +++ b/docs/docs/documentation/report-formats/console/features.md @@ -1,14 +1,16 @@ --- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.Reporting.Console addin. +title: Features +description: Features of the Cake.Issues.Reporting.Console addin. --- + The [Cake.Issues.Reporting.Console addin] provides the following features: * Prints issues containing line and column information. * Group issues by rule -* Reports: - * Number of issues by provider - * Number of issues by priority for every provider and run + +Reports: + +* Number of issues by provider +* Number of issues by priority for every provider and run [Cake.Issues.Reporting.Console addin]: https://www.nuget.org/packages/Cake.Issues.Reporting.Console diff --git a/docs/docs/documentation/report-formats/console/index.md b/docs/docs/documentation/report-formats/console/index.md new file mode 100644 index 000000000..6faf24b3e --- /dev/null +++ b/docs/docs/documentation/report-formats/console/index.md @@ -0,0 +1,7 @@ +--- +title: Console +description: Report format to print issues to the console. +--- + +Support for printing issues to the console is implemented in the +a [Cake.Issues.Reporting.Console addin](https://www.nuget.org/packages/Cake.Issues.Reporting.Console). diff --git a/docs/input/docs/report-formats/generic/examples/custom-template.md b/docs/docs/documentation/report-formats/generic/examples/custom-template.md similarity index 75% rename from docs/input/docs/report-formats/generic/examples/custom-template.md rename to docs/docs/documentation/report-formats/generic/examples/custom-template.md index 8f3bbf242..893d0b076 100644 --- a/docs/input/docs/report-formats/generic/examples/custom-template.md +++ b/docs/docs/documentation/report-formats/generic/examples/custom-template.md @@ -1,21 +1,19 @@ --- -Order: 20 -Title: Custom template -Description: Example how to create a report using a custom template +title: Custom template +description: Example how to create a report using a custom template --- -:::{.alert .alert-info} -If you create a universally usable custom template we're happy to package it with the addin. -To have it included in the addin please [create a pull request] with your contribution. -::: + +!!! info + If you create a universally usable custom template we're happy to package it with the addin. + To have it included in the addin please [create a pull request] with your contribution. The following example will create a HTML report for issues logged as warnings by MsBuild using a custom template. -:::{.alert .alert-warning} -Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the packages. +!!! warning + Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the packages. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. ```csharp #tool "nuget:?package=MSBuild.Extension.Pack" @@ -101,16 +99,14 @@ Task("Create-IssueReport").Does(() => The template retrieves an `IEnumerable` as model. -:::{.alert .alert-info} -In custom templates functionality from the following assemblies are available: - -* System.dll -* System.Core.dll -* netstandard.dll -* Cake.Core.dll -* Cake.Issues.dll -* Cake.Issues.Reporting.Generic.dll +!!! info + In custom templates functionality from the following assemblies are available: -::: + * System.dll + * System.Core.dll + * netstandard.dll + * Cake.Core.dll + * Cake.Issues.dll + * Cake.Issues.Reporting.Generic.dll [create a pull request]: https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/CONTRIBUTING.md diff --git a/docs/input/docs/report-formats/generic/examples/default-template.md b/docs/docs/documentation/report-formats/generic/examples/default-template.md similarity index 75% rename from docs/input/docs/report-formats/generic/examples/default-template.md rename to docs/docs/documentation/report-formats/generic/examples/default-template.md index 7da2601bb..1d51365f5 100644 --- a/docs/input/docs/report-formats/generic/examples/default-template.md +++ b/docs/docs/documentation/report-formats/generic/examples/default-template.md @@ -1,16 +1,15 @@ --- -Order: 10 -Title: Embedded default template -Description: Example how to create a report using an embedded default template. +title: Embedded default template +description: Example how to create a report using an embedded default template. --- + The following example will create a HTML report for issues logged as warnings by MsBuild. -:::{.alert .alert-warning} -Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the packages. +!!! warning + Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the packages. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. ```csharp #tool "nuget:?package=MSBuild.Extension.Pack" @@ -48,4 +47,4 @@ Task("Create-IssueReport").Does(() => repoRootFolder, @"c:\report.html"); }); -``` \ No newline at end of file +``` diff --git a/docs/input/docs/report-formats/generic/examples/index.cshtml b/docs/docs/documentation/report-formats/generic/examples/index.cshtml similarity index 100% rename from docs/input/docs/report-formats/generic/examples/index.cshtml rename to docs/docs/documentation/report-formats/generic/examples/index.cshtml diff --git a/docs/input/docs/report-formats/generic/features.md b/docs/docs/documentation/report-formats/generic/features.md similarity index 86% rename from docs/input/docs/report-formats/generic/features.md rename to docs/docs/documentation/report-formats/generic/features.md index 247752c6e..768fb58bf 100644 --- a/docs/input/docs/report-formats/generic/features.md +++ b/docs/docs/documentation/report-formats/generic/features.md @@ -10,9 +10,8 @@ The [Cake.Issues.Reporting.Generic addin] provides the following features: * Possibility to use custom templates using Razor * File linking support for different hosting providers (e.g. [GitHub], [Azure DevOps]) -:::{.alert .alert-info} -See [Template Gallery] for a list of available out of the box and 3rd party templates. -::: +!!! info + See [Template Gallery] for a list of available out of the box and 3rd party templates. [Cake.Issues.Reporting.Generic addin]: https://www.nuget.org/packages/Cake.Issues.Reporting.Generic [Template Gallery]: templates/ diff --git a/docs/docs/documentation/report-formats/generic/index.md b/docs/docs/documentation/report-formats/generic/index.md new file mode 100644 index 000000000..0f41812d7 --- /dev/null +++ b/docs/docs/documentation/report-formats/generic/index.md @@ -0,0 +1,7 @@ +--- +title: Generic +description: Report format to create reports in any text based format (HTML, Markdown, ...). +--- + +Support for creating reports in any text based format like HTML or Markdown is implemented in the +[Cake.Issues.Reporting.Generic addin](https://www.nuget.org/packages/Cake.Issues.Reporting.Generic). diff --git a/docs/input/docs/report-formats/generic/templates/htmldatatable-demo-default.html b/docs/docs/documentation/report-formats/generic/templates/htmldatatable-demo-default.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldatatable-demo-default.html rename to docs/docs/documentation/report-formats/generic/templates/htmldatatable-demo-default.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldatatable.md b/docs/docs/documentation/report-formats/generic/templates/htmldatatable.md similarity index 78% rename from docs/input/docs/report-formats/generic/templates/htmldatatable.md rename to docs/docs/documentation/report-formats/generic/templates/htmldatatable.md index 68653531b..072f2d6a6 100644 --- a/docs/input/docs/report-formats/generic/templates/htmldatatable.md +++ b/docs/docs/documentation/report-formats/generic/templates/htmldatatable.md @@ -1,13 +1,13 @@ --- -Order: 20 -Title: HTML Data Table -Description: Template for a HTML report containing a rich data table view with sorting and search functionality. +title: HTML Data Table +description: Template for a HTML report containing a rich data table view with sorting and search functionality. --- + Template for a HTML report containing a rich data table view with sorting and search functionality powered by [Simple-DataTables]. ![HTML Data Table](htmldatatable01.png "HTML Data Table") -# Features +## Features * Separate table for issues of each issue provider. * Table with `Severity`, `Project`, `Path`, `File`, `Location`, `Rule`, `Message`. @@ -16,11 +16,11 @@ Template for a HTML report containing a rich data table view with sorting and se * Client-side full text search. * No internet access required for displaying. -# Requirements +## Requirements * Cake.Issues.Reporting.Generic 0.2.1 or higher -# Usage +## Usage To create a report using the HTML Data Table template you can use the [GenericIssueReportTemplate.HtmlDataTable] enum value: @@ -32,23 +32,22 @@ CreateIssueReport( @"c:\report.html"); ``` -# Options +## Options This template doesn't support any options. -# Demos +## Demos -* Default +* [Default](htmldatatable-demo-default.html){target="_blank"} -# Source Code +## Source Code -:::{.alert .alert-info} -You can use the source code as a template for your [custom template]. -::: +!!! info + You can use the source code as a template for your [custom template]. Source code is available on [GitHub]. [Simple-DataTables]: https://github.com/fiduswriter/Simple-DataTables [GenericIssueReportTemplate.HtmlDataTable]: ../../../../../Cake.Issues.Website/api/Cake.Issues.Reporting.Generic/GenericIssueReportTemplate/62ADE81F -[custom template]: ../examples/custom-template +[custom template]: ../examples/custom-template.md [GitHub]: https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/src/Cake.Issues.Reporting.Generic/Templates/DataTable.cshtml diff --git a/docs/input/docs/report-formats/generic/templates/htmldatatable01.png b/docs/docs/documentation/report-formats/generic/templates/htmldatatable01.png similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldatatable01.png rename to docs/docs/documentation/report-formats/generic/templates/htmldatatable01.png diff --git a/docs/input/docs/report-formats/generic/templates/htmldiagnostic-demo-default.html b/docs/docs/documentation/report-formats/generic/templates/htmldiagnostic-demo-default.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldiagnostic-demo-default.html rename to docs/docs/documentation/report-formats/generic/templates/htmldiagnostic-demo-default.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldiagnostic.md b/docs/docs/documentation/report-formats/generic/templates/htmldiagnostic.md similarity index 73% rename from docs/input/docs/report-formats/generic/templates/htmldiagnostic.md rename to docs/docs/documentation/report-formats/generic/templates/htmldiagnostic.md index 8e3b8f023..1aedd739a 100644 --- a/docs/input/docs/report-formats/generic/templates/htmldiagnostic.md +++ b/docs/docs/documentation/report-formats/generic/templates/htmldiagnostic.md @@ -1,22 +1,22 @@ --- -Order: 30 -Title: HTML Diagnostic -Description: Template for a HTML report containing a list of all issues with all properties. +title: HTML Diagnostic +description: Template for a HTML report containing a list of all issues with all properties. --- + Template for a HTML report containing a list of all issues with all properties. ![HTML Diagnostic](htmldiagnostic01.png "HTML Diagnostic") -# Features +## Features * Unstyled table listing all properties of [IIssue] * No internet access required for displaying. -# Requirements +## Requirements * No additional requirements. -# Usage +## Usage To create a report using the HTML diagnostic template you can use the [GenericIssueReportTemplate.HtmlDiagnostic] enum value: @@ -28,23 +28,22 @@ CreateIssueReport( @"c:\report.html"); ``` -# Options +## Options This template doesn't support any options. -# Demos +## Demos -* Default +* [Default](htmldiagnostic-demo-default.html){target="_blank"} -# Source Code +## Source Code -:::{.alert .alert-info} -You can use the source code as a template for your [custom template]. -::: +!!! info + You can use the source code as a template for your [custom template]. Source code is available on [GitHub]. [IIssue]: ../../../../../Cake.Issues.Website/api/Cake.Issues/IIssue/ [GenericIssueReportTemplate.HtmlDiagnostic]: ../../../../../Cake.Issues.Website/api/Cake.Issues.Reporting.Generic/GenericIssueReportTemplate/4F88BD05 -[custom template]: ../examples/custom-template +[custom template]: ../examples/custom-template.md [GitHub]: https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/src/Cake.Issues.Reporting.Generic/Templates/Diagnostic.cshtml \ No newline at end of file diff --git a/docs/input/docs/report-formats/generic/templates/htmldiagnostic01.png b/docs/docs/documentation/report-formats/generic/templates/htmldiagnostic01.png similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldiagnostic01.png rename to docs/docs/documentation/report-formats/generic/templates/htmldiagnostic01.png diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-additionalcolumns.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-additionalcolumns.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-additionalcolumns.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-additionalcolumns.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-changetitle.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-changetitle.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-changetitle.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-changetitle.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-columnhiding.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-columnhiding.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-columnhiding.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-columnhiding.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-customexportfilename.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-customexportfilename.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-customexportfilename.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-customexportfilename.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-customscriptlocation.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-customscriptlocation.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-customscriptlocation.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-customscriptlocation.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-default.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-default.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-default.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-default.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disablefiltering.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disablefiltering.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disablefiltering.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disablefiltering.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disablegrouping.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disablegrouping.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disablegrouping.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disablegrouping.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disableheader.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disableheader.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disableheader.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disableheader.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disablesearching.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disablesearching.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-disablesearching.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-disablesearching.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-enableexporting.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-enableexporting.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-enableexporting.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-enableexporting.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-pdf.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-pdf.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-pdf.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-pdf.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-xlsx.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-xlsx.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-xlsx.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-exportformat-xlsx.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-grouping.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-grouping.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-grouping.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-grouping.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-sorting.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-sorting.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-sorting.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-sorting.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-carmine.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-carmine.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-carmine.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-carmine.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrast.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrast.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrast.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrast.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrastcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrastcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrastcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-contrastcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-dark.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-dark.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-dark.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-dark.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkmoon.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkmoon.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkmoon.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkmoon.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkviolet.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkviolet.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkviolet.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-darkviolet.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-greenmist.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-greenmist.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-greenmist.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-greenmist.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-light.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-light.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-light.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-light.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-lightcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-lightcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-lightcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-lightcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedark.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedark.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedark.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedark.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedarkcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedarkcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedarkcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluedarkcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelight.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelight.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelight.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelight.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelightcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelightcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelightcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialbluelightcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedark.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedark.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedark.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedark.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedarkcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedarkcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedarkcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimedarkcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelight.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelight.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelight.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelight.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelightcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelightcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelightcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materiallimelightcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedark.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedark.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedark.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedark.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedarkcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedarkcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedarkcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangedarkcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelight.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelight.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelight.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelight.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelightcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelightcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelightcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialorangelightcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledark.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledark.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledark.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledark.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledarkcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledarkcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledarkcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurpledarkcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelight.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelight.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelight.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelight.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelightcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelightcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelightcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialpurplelightcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdark.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdark.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdark.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdark.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdarkcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdarkcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdarkcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialtealdarkcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallight.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallight.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallight.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallight.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallightcompact.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallightcompact.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallightcompact.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-materialteallightcompact.html diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-softblue.html b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-softblue.html similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid-demo-theme-softblue.html rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid-demo-theme-softblue.html diff --git a/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid.md b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid.md new file mode 100644 index 000000000..4c14ccd54 --- /dev/null +++ b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid.md @@ -0,0 +1,239 @@ +--- +title: HTML DevExtreme Data Grid +description: Template for a HTML report containing a rich data grid with sorting, filtering, grouping and search capabilities. +--- + +Template for a HTML report containing a rich data grid with sorting, filtering, grouping and search capabilities powered by [DevExtreme]. + +![HTML DevExtreme Data Grid](htmldxdatagrid01.png "HTML DevExtreme Data Grid") + +## Features + +* Table with `Provider`, `Severity`, `Project`, `Path`, `File`, `Location`, `Rule`, `Message` by default. +* Support for grouping by multiple columns by user. +* Total number of issues by each group level. +* Each column sortable by user. +* Data can be filtered by any column by user. +* Paged view. +* Client-side full text search. +* Client-side export to Microsoft Excel or PDF. +* Fully customizable through [options](#options). + +## Requirements + +* Cake.Issues.Reporting.Generic 0.3.1 or higher + +## Usage + +To create a report using the HTML DevExtreme Data Grid template you can use the [GenericIssueReportTemplate.HtmlDxDataGrid] enum value: + +```csharp +CreateIssueReport( + issues, + GenericIssueReportFormatFromEmbeddedTemplate(GenericIssueReportTemplate.HtmlDxDataGrid), + @"c:\repo", + @"c:\report.html"); +``` + +## Options + +See [HtmlDxDataGridOption] for a list of possible options. + +## Demos + +The following demo shows the template with its default options: + +* [Default](htmldxdatagrid-demo-default.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-default.cake){target="_blank"}) + +### Themes + +The template supports the teams defined in the [DevExtremeTheme] enumeration which can be set using the [HtmlDxDataGridOption.Theme]: + +```csharp +CreateIssueReport( + issues, + GenericIssueReportFormatFromEmbeddedTemplate( + GenericIssueReportTemplate.HtmlDxDataGrid, + settings => settings.WithOption(HtmlDxDataGridOption.Theme, DevExtremeTheme.MaterialBlueLight)), + @"c:\repo", + @"c:\report.html"); +``` + +* [Light Theme](htmldxdatagrid-demo-theme-light.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-light.cake){target="_blank"}) +* [Dark Theme](htmldxdatagrid-demo-theme-dark.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-dark.cake){target="_blank"}) +* [Contrast Theme](htmldxdatagrid-demo-theme-contrast.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-contrast.cake){target="_blank"}) +* [Carmine Theme](htmldxdatagrid-demo-theme-carmine.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-carmine.cake){target="_blank"}) +* [Dark Moon Theme](htmldxdatagrid-demo-theme-darkmoon.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-darkmoon.cake){target="_blank"}) +* [Soft Blue Theme](htmldxdatagrid-demo-theme-softblue.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-softblue.cake){target="_blank"}) +* [Dark Violet Theme](htmldxdatagrid-demo-theme-darkviolet.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-darkviolet.cake){target="_blank"}) +* [Green Mist Theme](htmldxdatagrid-demo-theme-greenmist.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-greenmist.cake){target="_blank"}) +* [Light Compact Theme](htmldxdatagrid-demo-theme-lightcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-lightcompact.cake){target="_blank"}) +* [Dark Compact Theme](htmldxdatagrid-demo-theme-darkcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-darkcompact.cake){target="_blank"}) +* [Contrast Compact Theme](htmldxdatagrid-demo-theme-contrastcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-contrastcompact.cake){target="_blank"}) +* [Material Blue Light Theme](htmldxdatagrid-demo-theme-materialbluelight.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialbluelight.cake){target="_blank"}) +* [Material Lime Light Theme](htmldxdatagrid-demo-theme-materiallimelight.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materiallimelight.cake){target="_blank"}) +* [Material Orange Light Theme](htmldxdatagrid-demo-theme-materialorangelight.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialorangelight.cake){target="_blank"}) +* [Material Purple Light Theme](htmldxdatagrid-demo-theme-materialpurplelight.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialpurplelight.cake){target="_blank"}) +* [Material Teal Light Theme](htmldxdatagrid-demo-theme-materialteallight.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialteallight.cake){target="_blank"}) +* [Material Blue Dark Theme](htmldxdatagrid-demo-theme-materialbluedark.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialbluedark.cake){target="_blank"}) +* [Material Lime Dark Theme](htmldxdatagrid-demo-theme-materiallimedark.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materiallimedark.cake){target="_blank"}) +* [Material Orange Dark Theme](htmldxdatagrid-demo-theme-materialorangedark.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialorangedark.cake){target="_blank"}) +* [Material Purple Dark Theme](htmldxdatagrid-demo-theme-materialpurpledark.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialpurpledark.cake){target="_blank"}) +* [Material Teal Dark Theme](htmldxdatagrid-demo-theme-materialtealdark.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialtealdark.cake){target="_blank"}) +* [Material Blue Light Compact Theme](htmldxdatagrid-demo-theme-materialbluelightcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialbluelightcompact.cake){target="_blank"}) +* [Material Lime Light Compact Theme](htmldxdatagrid-demo-theme-materiallimelightcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materiallimelightcompact.cake){target="_blank"}) +* [Material Orange Light Compact Theme](htmldxdatagrid-demo-theme-materialorangelightcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialorangelightcompact.cake){target="_blank"}) +* [Material Purple Light Compact Theme](htmldxdatagrid-demo-theme-materialpurplelightcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialpurplelightcompact.cake){target="_blank"}) +* [Material Teal Light Compact Theme](htmldxdatagrid-demo-theme-materialteallightcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialteallightcompact.cake){target="_blank"}) +* [Material Blue Dark Compact Theme](htmldxdatagrid-demo-theme-materialbluedarkcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialbluedarkcompact.cake){target="_blank"}) +* [Material Lime Dark Compact Theme](htmldxdatagrid-demo-theme-materiallimedarkcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materiallimedarkcompact.cake){target="_blank"}) +* [Material Orange Dark Compact Theme](htmldxdatagrid-demo-theme-materialorangedarkcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialorangedarkcompact.cake){target="_blank"}) +* [Material Purple Dark Compact Theme](htmldxdatagrid-demo-theme-materialpurpledarkcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialpurpledarkcompact.cake){target="_blank"}) +* [Material Teal Dark Compact Theme](htmldxdatagrid-demo-theme-materialtealdarkcompact.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-theme-materialtealdarkcompact.cake){target="_blank"}) + +### Column visibility + +Visible columns can be defined using the `ColumnNameVisible` option: + +```csharp +CreateIssueReport( + issues, + GenericIssueReportFormatFromEmbeddedTemplate( + GenericIssueReportTemplate.HtmlDxDataGrid, + settings => settings.WithOption(HtmlDxDataGridOption.LineVisible, false)), + @"c:\repo", + @"c:\report.html"); +``` + +Additional columns can be added using the [HtmlDxDataGridOption.AdditionalColumns] option. + +* [Show and hide columns](htmldxdatagrid-demo-columnhiding.html) + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-hide-columns.cake)) +* [Add additional columns](htmldxdatagrid-demo-additionalcolumns.html) + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-additional-columns.cake)) + +### Sorting + +Sorted columns can be defined using the [HtmlDxDataGridOption.SortedColumns] and the +`ColumnNameSortOder` options: + +```csharp +CreateIssueReport( + issues, + GenericIssueReportFormatFromEmbeddedTemplate( + GenericIssueReportTemplate.HtmlDxDataGrid, + settings => settings + .WithOption(HtmlDxDataGridOption.SortedColumns, new List { ReportColumn.RuleId }) + .WithOption(HtmlDxDataGridOption.RuleIdSortOder, ColumnSortOderDescending )), + @"c:\repo", + @"c:\report.html"); +``` + +* [Change sorting](htmldxdatagrid-demo-sorting.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-sorting.cake){target="_blank"}) + +### Grouping + +Grouping can be defined using the [HtmlDxDataGridOption.GroupedColumns] option: + +```csharp +CreateIssueReport( + issues, + GenericIssueReportFormatFromEmbeddedTemplate( + GenericIssueReportTemplate.HtmlDxDataGrid, + settings => settings.WithOption(HtmlDxDataGridOption.GroupedColumns, new List { ReportColumn.RuleId })), + @"c:\repo", + @"c:\report.html"); +``` + +* [Change grouping](htmldxdatagrid-demo-grouping.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-grouping.cake){target="_blank"}) +* [Disable grouping](htmldxdatagrid-demo-disable-grouping.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-disable-grouping.cake){target="_blank"}) + +### Exporting + +Exporting can be enabled using the [HtmlDxDataGridOption.EnableExporting] option: + +```csharp +CreateIssueReport( + issues, + GenericIssueReportFormatFromEmbeddedTemplate( + GenericIssueReportTemplate.HtmlDxDataGrid, + settings => settings.WithOption(HtmlDxDataGridOption.EnableExporting, true)), + @"c:\repo", + @"c:\report.html"); +``` + +* [Enable exporting](htmldxdatagrid-demo-enableexporting.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-enable-exporting.cake){target="_blank"}) +* [Microsoft Excel export (*.xlsx)](htmldxdatagrid-demo-exportformat-xlsx.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-exportformat-xlsx.cake){target="_blank"}) +* [PDF export (*.pdf)](htmldxdatagrid-demo-exportformat-pdf.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-exportformat-pdf.cake){target="_blank"}) +* [Custom export file name](htmldxdatagrid-demo-customexportfilename.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-custom-export-filename.cake){target="_blank"}) + +### Other features + +* [Change title](htmldxdatagrid-demo-changetitle.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-change-title.cake){target="_blank"}) +* [Disable header](htmldxdatagrid-demo-disableheader.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-disable-header.cake){target="_blank"}) +* [Disable filtering](htmldxdatagrid-demo-disablefiltering.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-disable-filtering.cake){target="_blank"}) +* [Disable searching](htmldxdatagrid-demo-disablesearching.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-disable-searching.cake){target="_blank"}) +* [Custom script location and version](htmldxdatagrid-demo-customscriptlocation.html){target="_blank"} + ([Source Code](https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/demos/script-runner/build/create-reports/create-reports-htmldxdatagrid-custom-script-location.cake){target="_blank"}) + +## Source Code + +!!! info + You can use the source code as a template for your [custom template]. + +Source code is available on [GitHub]. + +[DevExtreme]: https://js.devexpress.com +[GenericIssueReportTemplate.HtmlDxDataGrid]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/GenericIssueReportTemplate/0E9E9D94 +[HtmlDxDataGridOption]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/ +[DevExtremeTheme]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/DevExtremeTheme/ +[HtmlDxDataGridOption.Theme]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/EA83DCAB +[HtmlDxDataGridOption.AdditionalColumns]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/F9860912 +[HtmlDxDataGridOption.SortedColumns]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/D578E453 +[HtmlDxDataGridOption.GroupedColumns]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/0907599C +[HtmlDxDataGridOption.EnableExporting]: https://cakebuild.net/api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/1441E285 +[custom template]: ../examples/custom-template.md +[GitHub]: https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/src/Cake.Issues.Reporting.Generic/Templates/DxDataGrid.cshtml diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid01.png b/docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid01.png similarity index 100% rename from docs/input/docs/report-formats/generic/templates/htmldxdatagrid01.png rename to docs/docs/documentation/report-formats/generic/templates/htmldxdatagrid01.png diff --git a/docs/docs/documentation/report-formats/index.md b/docs/docs/documentation/report-formats/index.md new file mode 100644 index 000000000..c0287e92b --- /dev/null +++ b/docs/docs/documentation/report-formats/index.md @@ -0,0 +1,4 @@ +--- +title: Report Formats +description: Documentation of the different report format addins. +--- diff --git a/docs/input/docs/report-formats/sarif/examples.md b/docs/docs/documentation/report-formats/sarif/examples.md similarity index 75% rename from docs/input/docs/report-formats/sarif/examples.md rename to docs/docs/documentation/report-formats/sarif/examples.md index 31b231753..14524a177 100644 --- a/docs/input/docs/report-formats/sarif/examples.md +++ b/docs/docs/documentation/report-formats/sarif/examples.md @@ -1,16 +1,15 @@ --- -Order: 30 -Title: Examples -Description: Examples for using the Cake.Issues.Reporting.Sarif addin. +title: Examples +description: Examples for using the Cake.Issues.Reporting.Sarif addin. --- + The following example will create a SARIF report for issues logged as warnings by MsBuild. -:::{.alert .alert-warning} -Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the packages. +!!! warning + Please note that you always should pin addins and tools to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the packages. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. ```csharp #tool "nuget:?package=MSBuild.Extension.Pack" @@ -48,4 +47,4 @@ Task("Create-IssueReport").Does(() => repoRootFolder, @"c:\report.sarif"); }); -``` \ No newline at end of file +``` diff --git a/docs/docs/documentation/report-formats/sarif/features.md b/docs/docs/documentation/report-formats/sarif/features.md new file mode 100644 index 000000000..2e6759412 --- /dev/null +++ b/docs/docs/documentation/report-formats/sarif/features.md @@ -0,0 +1,19 @@ +--- +title: Features +description: Features of the Cake.Issues.Reporting.Sarif addin. +--- + +The [Cake.Issues.Reporting.Sarif addin] provides the following features: + +* Creates SARIF compatible files. + +Supports the following properties in the SARIF report: + +* RuleId +* Message +* Kind +* Level +* Location +* RuleUrl + +[Cake.Issues.Reporting.Sarif addin]: https://www.nuget.org/packages/Cake.Issues.Reporting.Sarif diff --git a/docs/docs/documentation/report-formats/sarif/index.md b/docs/docs/documentation/report-formats/sarif/index.md new file mode 100644 index 000000000..269ddee5b --- /dev/null +++ b/docs/docs/documentation/report-formats/sarif/index.md @@ -0,0 +1,7 @@ +--- +title: Sarif +description: Report format to create SARIF compatible reports. +--- + +Support for creating SARIF compatible reports is implemented in the +[Cake.Issues.Reporting.Sarif addin](https://www.nuget.org/packages/Cake.Issues.Reporting.Sarif). diff --git a/docs/input/docs/resources/blog-posts.md b/docs/docs/documentation/resources/blog-posts.md similarity index 57% rename from docs/input/docs/resources/blog-posts.md rename to docs/docs/documentation/resources/blog-posts.md index 935648bfa..8de6821f6 100644 --- a/docs/input/docs/resources/blog-posts.md +++ b/docs/docs/documentation/resources/blog-posts.md @@ -1,19 +1,17 @@ --- -Order: 10 -Title: Blog posts -Description: Blog posts about the Cake Issues addins. +title: Blog posts +description: Blog posts about the Cake Issues addins. --- -:::{.alert .alert-info} -If you have written about Cake Issues we would like to hear from you. -You can add it by creating a pull request [here](https://github.com/cake-contrib/Cake.Issues.Website/tree/develop/input/docs/resources/blog-posts.md). -::: +!!! info + If you have written about Cake Issues we would like to hear from you. + You can add it by creating a pull request [here](https://github.com/cake-contrib/Cake.Issues.Website/tree/develop/input/docs/resources/blog-posts.md). -# 2018 +## 2018 * [Cake.Issues - A suite of addins for issue handling in Cake](https://cakebuild.net/blog/2018/06/cake-issues) - Pascal Berger -# 2017 +## 2017 * [Finding typos with ReSharper Command Line Tools, ReSpeller and Cake](https://tpodolak.com/blog/2017/10/27/finding-typos-resharper-command-line-tools-respeller-cake/) - Tom Podolak * [Cake build issue reporting with PRCA](https://blog.ostebaronen.dk/2017/08/cake-build-issue-reporting-with-prca.html) - Tomasz Cielecki \ No newline at end of file diff --git a/docs/input/docs/resources/presentations.md b/docs/docs/documentation/resources/presentations.md similarity index 55% rename from docs/input/docs/resources/presentations.md rename to docs/docs/documentation/resources/presentations.md index 173ecd1fa..a1f8259dc 100644 --- a/docs/input/docs/resources/presentations.md +++ b/docs/docs/documentation/resources/presentations.md @@ -1,18 +1,16 @@ --- -Order: 20 -Title: Presentations -Description: Presentations about the Cake Issues addins. +title: Presentations +description: Presentations about the Cake Issues addins. --- -:::{.alert .alert-info} -If you have done a presentation about Cake Issues we would like to hear from you. -You can add it by creating a pull request [here](https://github.com/cake-contrib/Cake.Issues.Website/tree/develop/input/docs/resources/presentations.md). -::: +!!! info + If you have done a presentation about Cake Issues we would like to hear from you. + You can add it by creating a pull request [here](https://github.com/cake-contrib/Cake.Issues.Website/tree/develop/input/docs/resources/presentations.md). -# 2019 +## 2019 * Continuous Code Inspection using Cake - .NET User Group Basel: [Video](https://www.youtube.com/watch?v=tZ6hdBrj81s) [Slides](https://gitpitch.com/pascalberger/Cake.Issues-Presentation/20190212-dotnet-usergroup-basel#/) - Pascal Berger -# 2018 +## 2018 * [Ensuring quality in your DevOps pipelines using Cake - Azure DevOps Saturday Gothenburg](https://gitpitch.com/pascalberger/Cake.Issues-Presentation/20180929-azure-devops-saturday-gothenburg) - Pascal Berger \ No newline at end of file diff --git a/docs/input/docs/usage/creating-issues/creating-issues.md b/docs/docs/documentation/usage/creating-issues/creating-issues.md similarity index 66% rename from docs/input/docs/usage/creating-issues/creating-issues.md rename to docs/docs/documentation/usage/creating-issues/creating-issues.md index a959e1d3b..86010308d 100644 --- a/docs/input/docs/usage/creating-issues/creating-issues.md +++ b/docs/docs/documentation/usage/creating-issues/creating-issues.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: Creating issues -Description: Usage instructions how to create issues. +title: Creating issues +description: Usage instructions how to create issues. --- + The `Cake.Issues` addin can be used to create issues directly in the build script. This issues can for example be used to create reports. @@ -12,12 +12,11 @@ To create issues you need to import the following core addin: #addin "Cake.Issues" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. In the following task a new warning for the myfile.txt file on line 42 is created: @@ -37,4 +36,4 @@ Task("Create-Issue").Does(() => Information("Issue created with message: {0}", issues.MessageText); }); -``` \ No newline at end of file +``` diff --git a/docs/input/docs/usage/creating-reports/creating-reports.md b/docs/docs/documentation/usage/creating-reports/creating-reports.md similarity index 69% rename from docs/input/docs/usage/creating-reports/creating-reports.md rename to docs/docs/documentation/usage/creating-reports/creating-reports.md index e093dc134..7aa1c8aea 100644 --- a/docs/input/docs/usage/creating-reports/creating-reports.md +++ b/docs/docs/documentation/usage/creating-reports/creating-reports.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: Creating reports -Description: Usage instructions how to create reports. +title: Creating reports +description: Usage instructions how to create reports. --- + To create report for issues you need to import the following core addins: ```csharp @@ -19,12 +19,11 @@ and generic report format is imported: #addin "Cake.Issues.Reporting.Generic" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. Finally you can define a task where you call the reporting addin with the desired issue provider and report format: @@ -40,4 +39,4 @@ Task("Create-Report").Does(() => repoRootFolder, @"c:\report.html"); }); -``` \ No newline at end of file +``` diff --git a/docs/docs/documentation/usage/creating-reports/index.md b/docs/docs/documentation/usage/creating-reports/index.md new file mode 100644 index 000000000..d54f26e7e --- /dev/null +++ b/docs/docs/documentation/usage/creating-reports/index.md @@ -0,0 +1,6 @@ +--- +title: Creating Reports +description: How to create reports using Cake.Issues.Reporting. +--- + +For report format specific examples see [Report Format Examples](../../report-formats/index.md). diff --git a/docs/docs/documentation/usage/index.md b/docs/docs/documentation/usage/index.md new file mode 100644 index 000000000..bd8e97953 --- /dev/null +++ b/docs/docs/documentation/usage/index.md @@ -0,0 +1,6 @@ +--- +title: Usage +description: How to obtain, configure, and use Cake.Issues. +--- + +How to obtain, configure, and use Cake.Issues. diff --git a/docs/input/docs/usage/reading-issues/file-linking.md b/docs/docs/documentation/usage/reading-issues/file-linking.md similarity index 90% rename from docs/input/docs/usage/reading-issues/file-linking.md rename to docs/docs/documentation/usage/reading-issues/file-linking.md index 0870ee7b9..1798021e0 100644 --- a/docs/input/docs/usage/reading-issues/file-linking.md +++ b/docs/docs/documentation/usage/reading-issues/file-linking.md @@ -1,8 +1,8 @@ --- -Order: 30 -Title: File linking -Description: Example how to define file link settings. +title: File linking +description: Example how to define file link settings. --- + File link settings can be defined while reading issues and are passed through the `IIssue.FileLink` property to reporting formats, pull request systems and build server implementations: diff --git a/docs/docs/documentation/usage/reading-issues/index.md b/docs/docs/documentation/usage/reading-issues/index.md new file mode 100644 index 000000000..56444a43a --- /dev/null +++ b/docs/docs/documentation/usage/reading-issues/index.md @@ -0,0 +1,6 @@ +--- +title: Reading Issues +description: How to read issues using Cake.Issues. +--- + +For issue provider specific examples see [Issue Provider Examples](../../issue-providers/index.md). diff --git a/docs/input/docs/usage/reading-issues/reading-issues.md b/docs/docs/documentation/usage/reading-issues/reading-issues.md similarity index 68% rename from docs/input/docs/usage/reading-issues/reading-issues.md rename to docs/docs/documentation/usage/reading-issues/reading-issues.md index ab3ad10ea..a14250a9f 100644 --- a/docs/input/docs/usage/reading-issues/reading-issues.md +++ b/docs/docs/documentation/usage/reading-issues/reading-issues.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: Reading issues -Description: Usage instructions how to read issues. +title: Reading issues +description: Usage instructions how to read issues. --- + The `Cake.Issues` addin can be used to aggregate issues from different sources. This can for example be useful to break builds based on the reported issues. @@ -21,16 +21,15 @@ and from JetBrains InspectCode are imported: #addin "Cake.Issues.InspectCode" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. Finally you can define a task where you call the core addin with the desired issue providers. The following example reads issues reported as MsBuild warnings by the `XmlFileLogger` -class from [MSBuild Extension Pack] and issues reported by JetBrains InspectCode: +class from [MSBuild Extension Pack](http://www.msbuildextensionpack.com/){target="_blank"} and issues reported by JetBrains InspectCode: ```csharp Task("Read-Issues").Does(() => @@ -50,5 +49,3 @@ Task("Read-Issues").Does(() => Information("{0} issues are found.", issues.Count()); }); ``` - -[MSBuild Extension Pack]: http://www.msbuildextensionpack.com/ \ No newline at end of file diff --git a/docs/input/docs/usage/reading-issues/run-information.md b/docs/docs/documentation/usage/reading-issues/run-information.md similarity index 92% rename from docs/input/docs/usage/reading-issues/run-information.md rename to docs/docs/documentation/usage/reading-issues/run-information.md index 9af71d1a1..7535768f4 100644 --- a/docs/input/docs/usage/reading-issues/run-information.md +++ b/docs/docs/documentation/usage/reading-issues/run-information.md @@ -1,8 +1,8 @@ --- -Order: 20 -Title: Additional run information -Description: Example how to add run specific information. +title: Additional run information +description: Example how to add run specific information. --- + If a build script needs to parse multiple log files from the same tool, e.g. because multiple MsBuild solutions were built, this can be done by calling the issue provider multiple times. If the results are read into the same list and shown on the same report, diff --git a/docs/docs/documentation/usage/recipe/index.md b/docs/docs/documentation/usage/recipe/index.md new file mode 100644 index 000000000..df434914f --- /dev/null +++ b/docs/docs/documentation/usage/recipe/index.md @@ -0,0 +1,8 @@ +--- +title: Recipe +description: How to use the pre-made recipe script. +--- + +Examples how to use Cake.Issues recipes can be found under [Recipe Usage]. + +[Recipe Usage]: ../../recipe/usage/index.md diff --git a/docs/input/docs/usage/reporting-issues-to-pull-requests/custom-issue-filter.md b/docs/docs/documentation/usage/reporting-issues-to-pull-requests/custom-issue-filter.md similarity index 56% rename from docs/input/docs/usage/reporting-issues-to-pull-requests/custom-issue-filter.md rename to docs/docs/documentation/usage/reporting-issues-to-pull-requests/custom-issue-filter.md index f734b0d67..b17c27373 100644 --- a/docs/input/docs/usage/reporting-issues-to-pull-requests/custom-issue-filter.md +++ b/docs/docs/documentation/usage/reporting-issues-to-pull-requests/custom-issue-filter.md @@ -1,26 +1,24 @@ --- -Order: 20 -Title: Custom issue filter -Description: Usage instructions how to apply custom filters to issues. +title: Custom issue filter +description: Usage instructions how to apply custom filters to issues. --- + You can define custom filters which are applied to issues before they are posted as comments to pull requests. -:::{.alert .alert-info} -You can use a custom filter to only have issues introduced with the current code posted to the pull request. +!!! info + You can use a custom filter to only have issues introduced with the current code posted to the pull request. -For this you need to store your log files as artifacts on your build system, then you can define a custom filter -which retrieves the logs from the previous build, parses them using the appropriate issue provider and filters -out any issues which were already existing in the previous build. -::: + For this you need to store your log files as artifacts on your build system, then you can define a custom filter + which retrieves the logs from the previous build, parses them using the appropriate issue provider and filters + out any issues which were already existing in the previous build. The following example will filter out all issues from the rule `CA1000` from being posted to the pull request. -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. ```csharp #addin "Cake.Issues" @@ -50,4 +48,4 @@ Task("ReportIssuesToPullRequest").Does(() => AzureDevOpsAuthenticationNtlm()), settings)); }); -``` \ No newline at end of file +``` diff --git a/docs/docs/documentation/usage/reporting-issues-to-pull-requests/index.md b/docs/docs/documentation/usage/reporting-issues-to-pull-requests/index.md new file mode 100644 index 000000000..53a49e221 --- /dev/null +++ b/docs/docs/documentation/usage/reporting-issues-to-pull-requests/index.md @@ -0,0 +1,6 @@ +--- +title: Reporting Issues To Pull Requests +description: How to report issues to pull requests using Cake.Issues.PullRequests. +--- + +For pull request system specific examples see [Pull Request System Examples](../../pull-request-systems/index.md) diff --git a/docs/input/docs/usage/reporting-issues-to-pull-requests/report-issues-to-pull-requests.md b/docs/docs/documentation/usage/reporting-issues-to-pull-requests/report-issues-to-pull-requests.md similarity index 71% rename from docs/input/docs/usage/reporting-issues-to-pull-requests/report-issues-to-pull-requests.md rename to docs/docs/documentation/usage/reporting-issues-to-pull-requests/report-issues-to-pull-requests.md index 8026224da..edc3f4a2c 100644 --- a/docs/input/docs/usage/reporting-issues-to-pull-requests/report-issues-to-pull-requests.md +++ b/docs/docs/documentation/usage/reporting-issues-to-pull-requests/report-issues-to-pull-requests.md @@ -1,8 +1,8 @@ --- -Order: 10 -Title: Report issues to pull requests -Description: Usage instructions how to report issues to pull requests. +title: Report issues to pull requests +description: Usage instructions how to report issues to pull requests. --- + To use report issues to pull requests you need to import the following core addins: ```csharp @@ -19,12 +19,11 @@ and support for Azure DevOps pull requests is imported: #addin "Cake.Issues.PullRequests.AzureDevOps" ``` -:::{.alert .alert-warning} -Please note that you always should pin addins to a specific version to make sure your builds are deterministic and -won't break due to updates to one of the addins. +!!! warning + Please note that you always should pin addins to a specific version to make sure your builds are deterministic and + won't break due to updates to one of the addins. -See [pinning addin versions](https://cakebuild.net/docs/tutorials/pinning-cake-version#pinning-addin-version) for details. -::: + See [pinning addin versions](https://cakebuild.net/docs/writing-builds/reproducible-builds/){target="_blank"} for details. Finally you can define a task where you call the core addin with the desired issue provider and pull request system: @@ -42,4 +41,4 @@ Task("ReportIssuesToPullRequest").Does(() => AzureDevOpsAuthenticationNtlm()), repoRootFolder); }); -``` \ No newline at end of file +``` diff --git a/docs/docs/index.md b/docs/docs/index.md new file mode 100644 index 000000000..0cd906f3a --- /dev/null +++ b/docs/docs/index.md @@ -0,0 +1,87 @@ +--- +hide: + - navigation + - toc +layout: default +search: + exclude: true +title: Home +--- + + + +
+ +- :material-scale-balance:{ .lg .middle } __Open-Source__ + + --- + + Cake Issues is free to use, improve, contribute and distribute. + Source code is available on [GitHub](https://github.com/cake-contrib/Cake.Issues) under MIT license. + + [:octicons-arrow-right-24: Source code & license](https://github.com/cake-contrib/Cake.Issues) + +- :material-globe-model:{ .lg .middle } __Rich ecosystem__ + + --- + + Unlike other Cake addins, Cake Issues consists of over 15 different addins, + working together and providing you with over 75 aliases which you can use in your Cake + build scripts to work with issues. + + [:octicons-arrow-right-24: Reference](#) + +- :material-wrench:{ .lg .middle } __Supports your tooling__ + + --- + + Read issues from different analyzers, linters or tools. + The growing range of out-of-the-box supported tools include + [MSBuild](documentation/issue-providers/msbuild/index.md), + [JetBrains InspectCode (ReSharper)](documentation/issue-providers/inspectcode/index.md), + [ESLint](documentation/issue-providers/eslint/index.md), + [Markdownlint](documentation/issue-providers/markdownlint/index.md), + [DocFX](documentation/issue-providers/docfx/index.md). + + [:octicons-arrow-right-24: Issue Providers](documentation/issue-providers/index.md) + +- :material-monitor-dashboard:{ .lg .middle } __Reporting__ + + --- + + Cake Issues provides aliases to create reports from the parsed issues. + There's a [generic reporting addin](documentation/report-formats/generic/index.md) which allows to create reports using out-of-the-box or custom Razor templates + and [an addin for creating SARIF compatible files](documentation/report-formats/sarif/index.md). + + [:octicons-arrow-right-24: Report Formats](documentation/report-formats/index.md) + +- :material-eye:{ .lg .middle } __Pull request and build workflow integration__ + + --- + + Issues found on a feature branch can be reported to pull requests or build runs giving developers instant and direct feedback. + There's out of the box support for [Azure DevOps](documentation/pull-request-systems/azure-devops/index.md), + [GitHub Actions](documentation/pull-request-systems/github-actions/index.md) and + [AppVeyor](documentation/pull-request-systems/appveyor/index.md). + + [:octicons-arrow-right-24: Pull Request Systems](documentation/pull-request-systems/index.md) + +- :material-table:{ .lg .middle } __Extensible__ + + --- + + The addins are built in a modular architecture and are providing different [extension points](documentation/extending/index.md) + which allow you to easily enhance it for supporting additional analyzers, linters, report formats and pull request systems. + + [:octicons-arrow-right-24: Documentation](documentation/extending/index.md) +
\ No newline at end of file diff --git a/docs/input/docs/extending/fundamentals.md b/docs/input/docs/extending/fundamentals.md deleted file mode 100644 index d5eb30a0b..000000000 --- a/docs/input/docs/extending/fundamentals.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -Order: 10 -Title: Fundamentals -Description: Fundamentals to extend Cake Issues ecosystem. ---- - -You can easily extend Cake Issues with additional [Issue Provider], [Report Formats] and [Pull Request System integrations]. - -[Issue Provider]: issue-provider -[Report Formats]: report-format -[Pull Request System integrations]: pull-request-system \ No newline at end of file diff --git a/docs/input/docs/extending/index.cshtml b/docs/input/docs/extending/index.cshtml deleted file mode 100644 index a5469c139..000000000 --- a/docs/input/docs/extending/index.cshtml +++ /dev/null @@ -1,6 +0,0 @@ ---- -Order: 80 -Description: Instructions how to add support for additional analyzers, report formats and pull request system to the Cake Issues Addin. ---- - -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/extending/issue-provider/categories.md b/docs/input/docs/extending/issue-provider/categories.md deleted file mode 100644 index f6d781972..000000000 --- a/docs/input/docs/extending/issue-provider/categories.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -Order: 30 -Title: Alias categories -Description: Instructions how to set the alias category. ---- -Issue provider aliases should use the [IssuesAliasConstants.MainCakeAliasCategory] and -[IssuesAliasConstants.IssueProviderCakeAliasCategory] constants for defining their category: - -```csharp -[CakeAliasCategory(IssuesAliasConstants.MainCakeAliasCategory)] -public static class MyIssueProviderAliases -{ - [CakeMethodAlias] - [CakeAliasCategory(IssuesAliasConstants.IssueProviderCakeAliasCategory)] - public static IIssueProvider MyIssueProvider( - this ICakeContext context) - { - } -} -``` - -[IssuesAliasConstants.MainCakeAliasCategory]: ../../../api/Cake.Issues/IssuesAliasConstants/41CCADF8 -[IssuesAliasConstants.IssueProviderCakeAliasCategory]: ../../../api/Cake.Issues/IssuesAliasConstants/D265B28D \ No newline at end of file diff --git a/docs/input/docs/extending/issue-provider/index.cshtml b/docs/input/docs/extending/issue-provider/index.cshtml deleted file mode 100644 index 3ed5de7aa..000000000 --- a/docs/input/docs/extending/issue-provider/index.cshtml +++ /dev/null @@ -1,6 +0,0 @@ ---- -Order: 10 -Description: Instructions how to add support for additional analyzers to the Cake Issues addin. ---- - -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/extending/issue-provider/overview.md b/docs/input/docs/extending/issue-provider/overview.md deleted file mode 100644 index 44066737b..000000000 --- a/docs/input/docs/extending/issue-provider/overview.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -Order: 20 -Title: Overview -Description: Overview how to implement support for an analyzer or linter. ---- -Issue providers need to implement the [IIssueProvider] interface. - -# Base classes - -For simplifying implementation there exists base classes from which concrete implementation can be inherited. - -| Base Class | Use case | Tutorial | -|---------------------------------|------------------------------------------------------------------------|-------------------------------------| -| [BaseIssueProvider] | Base class for a simple issue provider implementation. | [Simple provider] | -| [BaseConfigurableIssueProvider] | Base class for a issue provider with issue provider specific settings. | [Provider settings] | -| [BaseMultiFormatIssueProvider] | Base class for issue providers supporting multiple log formats. | [Multiple log file formats support] | - -[IIssueProvider]: ../../../api/Cake.Issues/IIssueProvider/ -[BaseIssueProvider]: ../../../api/Cake.Issues/BaseIssueProvider -[BaseConfigurableIssueProvider]: ../../../api/Cake.Issues/BaseConfigurableIssueProvider_1 -[BaseMultiFormatIssueProvider]: ../../../api/Cake.Issues/BaseMultiFormatIssueProvider_2 -[Simple provider]: tutorials/simple -[Provider settings]: tutorials/settings -[Multiple log file formats support]: tutorials/logfile-format \ No newline at end of file diff --git a/docs/input/docs/extending/issue-provider/tutorials/index.cshtml b/docs/input/docs/extending/issue-provider/tutorials/index.cshtml deleted file mode 100644 index 4dd2b0f56..000000000 --- a/docs/input/docs/extending/issue-provider/tutorials/index.cshtml +++ /dev/null @@ -1,6 +0,0 @@ ---- -Order: 40 -Description: Tutorials how to implement issue providers. ---- - -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/extending/pull-request-system/index.cshtml b/docs/input/docs/extending/pull-request-system/index.cshtml deleted file mode 100644 index e05db6073..000000000 --- a/docs/input/docs/extending/pull-request-system/index.cshtml +++ /dev/null @@ -1,6 +0,0 @@ ---- -Order: 30 -Description: Instructions how to add support for additional pull request system to the Cake Issues addin. ---- - -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/extending/report-format/index.cshtml b/docs/input/docs/extending/report-format/index.cshtml deleted file mode 100644 index 06f0e9dda..000000000 --- a/docs/input/docs/extending/report-format/index.cshtml +++ /dev/null @@ -1,6 +0,0 @@ ---- -Order: 20 -Description: Instructions how to additional report formats to the Cake Issues addin. ---- - -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/fundamentals/index.cshtml b/docs/input/docs/fundamentals/index.cshtml deleted file mode 100644 index 2d505966a..000000000 --- a/docs/input/docs/fundamentals/index.cshtml +++ /dev/null @@ -1,6 +0,0 @@ ---- -Order: 20 -Description: Basic concepts of the Cake Issues Addin. ---- - -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/docfx/features.md b/docs/input/docs/issue-providers/docfx/features.md deleted file mode 100644 index 64cd24977..000000000 --- a/docs/input/docs/issue-providers/docfx/features.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.DocFx addin. ---- -The [Cake.Issues.DocFx addin] provides the following features. - -# Basic features - -* Reads warnings from [DocFx] log files. - - :::{.alert .alert-info} - [DocFx] can be run with [Cake.DocFx] addin. - ::: - -# Supported IIssue properties - -| | Property | Remarks | -|--------------------------------------------------------------------|-----------------------------------|---------------------------------| -| | `IIssue.ProviderType` | | -| | `IIssue.ProviderName` | | -| | `IIssue.Run` | Can be set while reading issues | -| | `IIssue.Identifier` | Set to `IIssue.MessageText` | -| | `IIssue.ProjectName` | | -| | `IIssue.ProjectFileRelativePath` | | -| | `IIssue.AffectedFileRelativePath` | | -| | `IIssue.Line` | | -| | `IIssue.EndLine` | | -| | `IIssue.Column` | | -| | `IIssue.EndColumn` | | -| | `IIssue.FileLink` | Can be set while reading issues | -| | `IIssue.MessageText` | | -| | `IIssue.MessageHtml` | | -| | `IIssue.MessageMarkdown` | | -| | `IIssue.Priority` | | -| | `IIssue.PriorityName` | | -| | `IIssue.Rule` | | -| | `IIssue.RuleUrl` | | - -[Cake.Issues.DocFx addin]: https://www.nuget.org/packages/Cake.Issues.DocFx -[DocFx]: https://dotnet.github.io/docfx/ -[Cake.DocFx]: https://www.nuget.org/packages/Cake.DocFx -[IssuePriority.Warning]: ../../../api/Cake.Issues/IssuePriority/7A0CE07F diff --git a/docs/input/docs/issue-providers/docfx/index.cshtml b/docs/input/docs/issue-providers/docfx/index.cshtml deleted file mode 100644 index 4ac9d00d7..000000000 --- a/docs/input/docs/issue-providers/docfx/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: DocFx -Description: Issue provider which allows you to read warnings logged by DocFx. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for reading warnings reported by DocFx - is implemented in the Cake.Issues.DocFx addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/docfx/requirements.md b/docs/input/docs/issue-providers/docfx/requirements.md deleted file mode 100644 index 576c77bd7..000000000 --- a/docs/input/docs/issue-providers/docfx/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.DocFx addin. ---- -The requirements for using the [Cake.Issues.DocFx addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.DocFx addin]: https://www.nuget.org/packages/Cake.Issues.DocFx -[release notes]: release-notes diff --git a/docs/input/docs/issue-providers/eslint/features.md b/docs/input/docs/issue-providers/eslint/features.md deleted file mode 100644 index bef51cbc9..000000000 --- a/docs/input/docs/issue-providers/eslint/features.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.EsLint addin. ---- -The [Cake.Issues.EsLint addin] provides the following features. - -# Basic features - -* Reads issues reported by ESLint. -* Provides URLs for all issues. -* Support for custom URL resolving using the [EsLintAddRuleUrlResolver] alias. - -# Supported log file formats - -* [EsLintJsonFormat] alias for reading issues from log files created by [ESLint json formatter]. - -# Supported IIssue properties - -| | Property | Remarks | -|--------------------------------------------------------------------|-----------------------------------|---------------------------------| -| | `IIssue.ProviderType` | | -| | `IIssue.ProviderName` | | -| | `IIssue.Run` | Can be set while reading issues | -| | `IIssue.Identifier` | Set to `IIssue.MessageText` | -| | `IIssue.ProjectName` | | -| | `IIssue.ProjectFileRelativePath` | | -| | `IIssue.AffectedFileRelativePath` | | -| | `IIssue.Line` | | -| | `IIssue.EndLine` | | -| | `IIssue.Column` | | -| | `IIssue.EndColumn` | | -| | `IIssue.MessageText` | | -| | `IIssue.MessageHtml` | | -| | `IIssue.MessageMarkdown` | | -| | `IIssue.Priority` | | -| | `IIssue.PriorityName` | | -| | `IIssue.Rule` | | -| | `IIssue.RuleUrl` | Support for custom rules can be added through a custom [EsLintAddRuleUrlResolver] | - -[Cake.Issues.EsLint addin]: https://www.nuget.org/packages/Cake.Issues.EsLint -[ESLint json formatter]: https://eslint.org/docs/user-guide/formatters/#json -[EsLintAddRuleUrlResolver]: ../../../api/Cake.Issues.EsLint/EsLintIssuesAliases/D64301E6 -[EsLintJsonFormat]: ../../../api/Cake.Issues.EsLint/EsLintIssuesAliases/230C6E27 diff --git a/docs/input/docs/issue-providers/eslint/index.cshtml b/docs/input/docs/issue-providers/eslint/index.cshtml deleted file mode 100644 index 67d797242..000000000 --- a/docs/input/docs/issue-providers/eslint/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: ESLint -Description: Issue provider which allows you to read issues logged by ESLint. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for reading issues reported by ESLint - is implemented in the Cake.Issues.EsLint addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/eslint/requirements.md b/docs/input/docs/issue-providers/eslint/requirements.md deleted file mode 100644 index dbca0cec9..000000000 --- a/docs/input/docs/issue-providers/eslint/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.EsLint addin. ---- -The requirements for using the [Cake.Issues.EsLint addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.EsLint addin]: https://www.nuget.org/packages/Cake.Issues.EsLint -[release notes]: release-notes diff --git a/docs/input/docs/issue-providers/gitrepository/features.md b/docs/input/docs/issue-providers/gitrepository/features.md deleted file mode 100644 index 55dbdfcc4..000000000 --- a/docs/input/docs/issue-providers/gitrepository/features.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.GitRepository addin. ---- -The [Cake.Issues.GitRepository addin] provides the following features. - -# Basic features - -* Checks path length of files. See [FilePathTooLong] for details. -* Checks if binary files are tracked by Git LFS. See [BinaryFileNotTrackedByLfs] for details. - -# Supported IIssue properties - -| | Property | Remarks | -|--------------------------------------------------------------------|-----------------------------------|---------------------------------| -| | `IIssue.ProviderType` | | -| | `IIssue.ProviderName` | | -| | `IIssue.Run` | Can be set while reading issues | -| | `IIssue.Identifier` | Set to `IIssue.MessageText` | -| | `IIssue.ProjectName` | | -| | `IIssue.ProjectFileRelativePath` | | -| | `IIssue.AffectedFileRelativePath` | | -| | `IIssue.Line` | | -| | `IIssue.EndLine` | | -| | `IIssue.Column` | | -| | `IIssue.EndColumn` | | -| | `IIssue.FileLink` | Can be set while reading issues | -| | `IIssue.MessageText` | | -| | `IIssue.MessageHtml` | | -| | `IIssue.MessageMarkdown` | | -| | `IIssue.Priority` | | -| | `IIssue.PriorityName` | | -| | `IIssue.Rule` | | -| | `IIssue.RuleUrl` | | - -[Cake.Issues.GitRepository addin]: https://www.nuget.org/packages/Cake.Issues.GitRepository -[FilePathTooLong]: rules/FilePathTooLong -[BinaryFileNotTrackedByLfs]: rules/BinaryFileNotTrackedByLfs diff --git a/docs/input/docs/issue-providers/gitrepository/index.cshtml b/docs/input/docs/issue-providers/gitrepository/index.cshtml deleted file mode 100644 index 35d944fbd..000000000 --- a/docs/input/docs/issue-providers/gitrepository/index.cshtml +++ /dev/null @@ -1,11 +0,0 @@ ---- -Title: Git Repository -Description: Issue provider which allows you to analyzing Git repositories and create issues resulting from it. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for analyzing Git repositories is implemented in the Cake.Issues.GitRepository addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/gitrepository/requirements.md b/docs/input/docs/issue-providers/gitrepository/requirements.md deleted file mode 100644 index e491db400..000000000 --- a/docs/input/docs/issue-providers/gitrepository/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.GitRepository addin. ---- -The requirements for using the [Cake.Issues.GitRepository addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.GitRepository addin]: https://www.nuget.org/packages/Cake.Issues.GitRepository -[release notes]: release-notes diff --git a/docs/input/docs/issue-providers/gitrepository/rules/BinaryFileNotTrackedByLfs.md b/docs/input/docs/issue-providers/gitrepository/rules/BinaryFileNotTrackedByLfs.md deleted file mode 100644 index ccf4197bb..000000000 --- a/docs/input/docs/issue-providers/gitrepository/rules/BinaryFileNotTrackedByLfs.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -Title: BinaryFileNotTrackedByLfs -Description: A binary file is not tracked by Git LFS. ---- - - - - - -## Cause - -A binary file in the repository is not tracked by [Git Large File System]. - -## Rule description - -By its nature Git repositories cannot handle binary files well and will keep a full copy of that file in the repository every time a change to that file is committed. -Considering that you always clone the full history of a repository, and not only the latest version, using binary files in a repository considerably slow downs the operation. -[Git Large File System] replaces large files with small text pointers inside the Git repository, while storing the file contents on a remote server. - -:::{.alert .alert-info} -The rule assumes that all files, which are not text files are binary files. -This also includes for example empty files. -::: - -## How to fix violations - -Track the file with [Git Large File System]. - -[Git Large File System]: https://git-lfs.github.com/ diff --git a/docs/input/docs/issue-providers/gitrepository/rules/index.cshtml b/docs/input/docs/issue-providers/gitrepository/rules/index.cshtml deleted file mode 100644 index 31e0d52d1..000000000 --- a/docs/input/docs/issue-providers/gitrepository/rules/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Title: Rules -Description: Rules of the Cake.Issues.GitRepository provider. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/index.cshtml b/docs/input/docs/issue-providers/index.cshtml deleted file mode 100644 index f1b8a0c4c..000000000 --- a/docs/input/docs/issue-providers/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Order: 50 -Description: Documentation of the different issue provider addins. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/inspectcode/features.md b/docs/input/docs/issue-providers/inspectcode/features.md deleted file mode 100644 index 93462f82d..000000000 --- a/docs/input/docs/issue-providers/inspectcode/features.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.InspectCode addin. ---- -The [Cake.Issues.InspectCode addin] provides the following features: - -# Basic features - -* Reads warnings from [JetBrains InsepectCode] log files. -* Provides URLs for issues containing a Wiki URL. - -# Supported IIssue properties - -| | Property | Remarks | -|--------------------------------------------------------------------|-----------------------------------|----------------------------------| -| | `IIssue.ProviderType` | | -| | `IIssue.ProviderName` | | -| | `IIssue.Run` | Can be set while reading issues | -| | `IIssue.Identifier` | Set to `IIssue.MessageText` | -| | `IIssue.ProjectName` | | -| | `IIssue.ProjectFileRelativePath` | | -| | `IIssue.AffectedFileRelativePath` | | -| | `IIssue.Line` | | -| | `IIssue.EndLine` | | -| | `IIssue.Column` | | -| | `IIssue.EndColumn` | | -| | `IIssue.FileLink` | Can be set while reading issues | -| | `IIssue.MessageText` | | -| | `IIssue.MessageHtml` | | -| | `IIssue.MessageMarkdown` | | -| | `IIssue.Priority` | | -| | `IIssue.PriorityName` | | -| | `IIssue.Rule` | | -| | `IIssue.RuleUrl` | For issues containing a Wiki Url | - -[JetBrains InsepectCode]: https://www.jetbrains.com/help/resharper/2017.1/InspectCode.html -[Cake.Issues.InspectCode addin]: https://www.nuget.org/packages/Cake.Issues.InspectCode diff --git a/docs/input/docs/issue-providers/inspectcode/index.cshtml b/docs/input/docs/issue-providers/inspectcode/index.cshtml deleted file mode 100644 index 4f18b059f..000000000 --- a/docs/input/docs/issue-providers/inspectcode/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: InspectCode -Description: Issue provider which allows you to read issues logged by JetBrains Inspect Code. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for reading issues reported by JetBrains Inspect Code - is implemented in the Cake.Issues.InspectCode addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/inspectcode/requirements.md b/docs/input/docs/issue-providers/inspectcode/requirements.md deleted file mode 100644 index 097fe05e6..000000000 --- a/docs/input/docs/issue-providers/inspectcode/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.Inspectcode addin. ---- -The requirements for using the [Cake.Issues.InspectCode addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.InspectCode addin]: https://www.nuget.org/packages/Cake.Issues.InspectCode -[release notes]: release-notes diff --git a/docs/input/docs/issue-providers/markdownlint/features.md b/docs/input/docs/issue-providers/markdownlint/features.md deleted file mode 100644 index 9b6d2d63b..000000000 --- a/docs/input/docs/issue-providers/markdownlint/features.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.Markdownlint addin. ---- -The [Cake.Issues.Markdownlint addin] provides the following features. - -# Basic features - -* Reads warnings from [Markdownlint] logfiles. -* Provides URLs for all issues. -* Support for custom URL resolving using the [MarkdownlintAddRuleUrlResolver] alias (except for [MarkdownlintCliJsonLogFileFormat]). - -# Supported log file formats - -* [MarkdownlintLogFileFormat] alias for reading issues from [Markdownlint] output generated with `options.resultVersion` set to 1. -* [MarkdownlintCliLogFileFormat] alias for reading issues from [markdownlint-cli] log files. -* [MarkdownlintCliJsonLogFileFormat] alias for reading issues from [markdownlint-cli] log files created with the `--json` parameter. - - :::{.alert .alert-info} - [markdownlint-cli] can be run with the [Cake.Markdownlint] addin. - ::: - -# Supported IIssue properties - -| | Property | Remarks | -|--------------------------------------------------------------------|-----------------------------------|-----------------------------------------| -| | `IIssue.ProviderType` | | -| | `IIssue.ProviderName` | | -| | `IIssue.Run` | Can be set while reading issues | -| | `IIssue.Identifier` | Set to `IIssue.MessageText` | -| | `IIssue.ProjectName` | | -| | `IIssue.ProjectFileRelativePath` | | -| | `IIssue.AffectedFileRelativePath` | | -| | `IIssue.Line` | | -| | `IIssue.EndLine` | | -| | `IIssue.Column` | Only for [MarkdownlintCliLogFileFormat] | -| | `IIssue.EndColumn` | | -| | `IIssue.FileLink` | Can be set while reading issues | -| | `IIssue.MessageText` | | -| | `IIssue.MessageHtml` | | -| | `IIssue.MessageMarkdown` | | -| | `IIssue.Priority` | Always [IssuePriority.Warning] | -| | `IIssue.PriorityName` | Always `Warning` | -| | `IIssue.Rule` | | -| | `IIssue.RuleUrl` | Support for custom rules can be added through a custom [MarkdownlintAddRuleUrlResolver] except for [MarkdownlintCliJsonLogFileFormat] | - -[Cake.Issues.Markdownlint addin]: https://www.nuget.org/packages/Cake.Issues.Markdownlint -[Markdownlint]: https://github.com/DavidAnson/markdownlint -[markdownlint-cli]: https://github.com/igorshubovych/markdownlint-cli -[Cake.Markdownlint]: https://www.nuget.org/packages/Cake.Markdownlint/ -[MarkdownlintAddRuleUrlResolver]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/2EE35F55 -[MarkdownlintLogFileFormat]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/EBFF674A -[MarkdownlintCliLogFileFormat]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/B518F49E -[MarkdownlintCliJsonLogFileFormat]: ../../../api/Cake.Issues.Markdownlint/MarkdownlintIssuesAliases/36DE6F5F -[IssuePriority.Warning]: ../../../api/Cake.Issues/IssuePriority/7A0CE07F diff --git a/docs/input/docs/issue-providers/markdownlint/index.cshtml b/docs/input/docs/issue-providers/markdownlint/index.cshtml deleted file mode 100644 index ab68430a4..000000000 --- a/docs/input/docs/issue-providers/markdownlint/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: markdownlint -Description: Issue provider which allows you to read issues logged by markdownlint. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for reading issues reported by markdownlint - is implemented in the Cake.Issues.Markdownlint addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/markdownlint/requirements.md b/docs/input/docs/issue-providers/markdownlint/requirements.md deleted file mode 100644 index e7d7f9a35..000000000 --- a/docs/input/docs/issue-providers/markdownlint/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.Markdownlint addin. ---- -The requirements for using the [Cake.Issues.Markdownlint addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.Markdownlint addin]: https://www.nuget.org/packages/Cake.Issues.Markdownlint -[release notes]: release-notes diff --git a/docs/input/docs/issue-providers/msbuild/features.md b/docs/input/docs/issue-providers/msbuild/features.md deleted file mode 100644 index 8f92f5fbc..000000000 --- a/docs/input/docs/issue-providers/msbuild/features.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.MsBuild addin. ---- -The [Cake.Issues.MsBuild addin] provides the following features. - -# Basic features - -* Reads errors and warnings from MSBuild log files. -* Provides URLs for all code analysis (`CA*`) and StyleCop (`SA*`) warnings. -* Support for custom URL resolving using the [MsBuildAddRuleUrlResolver] alias. - -# Supported log file formats - -* [MsBuildBinaryLogFileFormat] alias for reading issues from binary log files. -* [MsBuildXmlFileLoggerFormat] alias for reading issues from log files created by [MSBuild Extension Pack XmlFileLogger]. - -# Supported IIssue properties - -| | Property | Remarks | -|--------------------------------------------------------------------|-----------------------------------|---------------------------------------| -| | `IIssue.ProviderType` | | -| | `IIssue.ProviderName` | | -| | `IIssue.Run` | Can be set while reading issues | -| | `IIssue.Identifier` | Set to `IIssue.MessageText` | -| | `IIssue.ProjectName` | | -| | `IIssue.ProjectFileRelativePath` | | -| | `IIssue.AffectedFileRelativePath` | | -| | `IIssue.Line` | | -| | `IIssue.EndLine` | | -| | `IIssue.Column` | Only for [MsBuildXmlFileLoggerFormat] | -| | `IIssue.EndColumn` | | -| | `IIssue.FileLink` | Can be set while reading issues | -| | `IIssue.MessageText` | | -| | `IIssue.MessageHtml` | | -| | `IIssue.MessageMarkdown` | | -| | `IIssue.Priority` | | -| | `IIssue.PriorityName` | | -| | `IIssue.Rule` | | -| | `IIssue.RuleUrl` | For code analysis (`CA*`) and StyleCop (`SA*`) warnings. Support for additional rules can be added through a custom [MsBuildAddRuleUrlResolver] | - -[Cake.Issues.MsBuild addin]: https://www.nuget.org/packages/Cake.Issues.MsBuild -[MSBuild Extension Pack XmlFileLogger]: https://github.com/mikefourie-zz/MSBuildExtensionPack/blob/master/Solutions/Main/Loggers/Framework/XmlFileLogger.cs -[MsBuildAddRuleUrlResolver]: ../../../api/Cake.Issues.MsBuild/MsBuildIssuesAliases/93C21487 -[MsBuildBinaryLogFileFormat]: ../../../api/Cake.Issues.MsBuild/MsBuildIssuesAliases/AD50C7E1 -[MsBuildXmlFileLoggerFormat]: ../../../api/Cake.Issues.MsBuild/MsBuildIssuesAliases/051D7B6E -[IssuePriority.Warning]: ../../../api/Cake.Issues/IssuePriority/7A0CE07F diff --git a/docs/input/docs/issue-providers/msbuild/index.cshtml b/docs/input/docs/issue-providers/msbuild/index.cshtml deleted file mode 100644 index 394da8734..000000000 --- a/docs/input/docs/issue-providers/msbuild/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: MsBuild -Description: Issue provider which allows you to read warnings logged by MsBuild. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for reading warnings reported by MsBuild is implemented in the - Cake.Issues.MsBuild addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/msbuild/requirements.md b/docs/input/docs/issue-providers/msbuild/requirements.md deleted file mode 100644 index bc25ea62c..000000000 --- a/docs/input/docs/issue-providers/msbuild/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.MsBuild addin. ---- -The requirements for using the [Cake.Issues.MsBuild addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.MsBuild addin]: https://www.nuget.org/packages/Cake.Issues.MsBuild -[release notes]: release-notes diff --git a/docs/input/docs/issue-providers/terraform/features.md b/docs/input/docs/issue-providers/terraform/features.md deleted file mode 100644 index dbb414f25..000000000 --- a/docs/input/docs/issue-providers/terraform/features.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.Terraform addin. ---- -The [Cake.Issues.Terraform addin] provides the following features: - -# Basic features - -* Reads warnings from [Terraform validate command]. - -# Supported IIssue properties - -| | Property | Remarks | -|--------------------------------------------------------------------|-----------------------------------|----------------------------------| -| | `IIssue.ProviderType` | | -| | `IIssue.ProviderName` | | -| | `IIssue.Run` | Can be set while reading issues | -| | `IIssue.Identifier` | Set to `IIssue.MessageText` | -| | `IIssue.ProjectName` | | -| | `IIssue.ProjectFileRelativePath` | | -| | `IIssue.AffectedFileRelativePath` | | -| | `IIssue.Line` | | -| | `IIssue.EndLine` | | -| | `IIssue.Column` | | -| | `IIssue.EndColumn` | | -| | `IIssue.FileLink` | Can be set while reading issues | -| | `IIssue.MessageText` | | -| | `IIssue.MessageHtml` | | -| | `IIssue.MessageMarkdown` | | -| | `IIssue.Priority` | | -| | `IIssue.PriorityName` | | -| | `IIssue.Rule` | | -| | `IIssue.RuleUrl` | | - -[Terraform validate command]: https://www.terraform.io/docs/cli/commands/validate.html -[Cake.Issues.Terraform addin]: https://cakebuild.net/extensions/cake-issues-terraform/ diff --git a/docs/input/docs/issue-providers/terraform/index.cshtml b/docs/input/docs/issue-providers/terraform/index.cshtml deleted file mode 100644 index 184598ebb..000000000 --- a/docs/input/docs/issue-providers/terraform/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: Terraform -Description: Issue provider which allows you to read issues from Terraform validate command. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for reading issues reported by Terraform validate command - is implemented in the Cake.Issues.Terraform addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/issue-providers/terraform/requirements.md b/docs/input/docs/issue-providers/terraform/requirements.md deleted file mode 100644 index 4b7a408f3..000000000 --- a/docs/input/docs/issue-providers/terraform/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.Terraform addin. ---- -The requirements for using the [Cake.Issues.Terraform addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.Terraform addin]: https://cakebuild.net/extensions/cake-issues-terraform/ -[release notes]: release-notes diff --git a/docs/input/docs/overview/index.cshtml b/docs/input/docs/overview/index.cshtml deleted file mode 100644 index 67ee8bb24..000000000 --- a/docs/input/docs/overview/index.cshtml +++ /dev/null @@ -1,6 +0,0 @@ ---- -Order: 10 -Description: Overview about features and requirements of the Cake Issues Addin. ---- - -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/overview/release-notes/Cake.Issues.PullRequests.md b/docs/input/docs/overview/release-notes/Cake.Issues.PullRequests.md deleted file mode 100644 index 0fe9da522..000000000 --- a/docs/input/docs/overview/release-notes/Cake.Issues.PullRequests.md +++ /dev/null @@ -1,930 +0,0 @@ ---- -Title: Cake.Issues.PullRequests Release Notes -Description: Release notes for Cake.Issues.PullRequests ---- -

-

-

-Starting with Cake.Issues 1.0, release notes for Cake.Issues.PullRequests will be listed with Cake.Issues Release Notes. -The release notes on this page are only for versions of Cake.Issues.PullRequests prior to 1.0. -

-
-

- -## 0.9.1 (October 08, 2020) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.PullRequests/milestone/15?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.x -- Targeting .NET Standard 2.0 - -__Bug__ - -- [__#173__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/173) Setting a ProviderLimit to zero will ignore the limit instead of posting 0 items - - -## 0.9.0 (August 22, 2020) - - -As part of this release we had [4 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/milestone/13?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.x -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#154__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/154) Update to Cake.Issues 0.9.0 - -__Features__ - -- [__#143__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/143) Use identifier different from displayed message to compare existing issues -- [__#142__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/142) Add setting to limit number of issues posted to a pull request across multiple runs for issue providers -- [__#141__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/141) Add possibility to limit posted issues for a specific provider - - -## 0.9.0-beta.3 (August 01, 2020) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.0-beta0004 -- Targeting .NET Standard 2.0 - -__Breaking Changes__ - -- Update to Cake.Issues 0.9.0-beta0004 -## 0.9.0-beta.2 (July 18, 2020) - - -As part of this release we had 3 issues closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.0-beta0002 -- Targeting .NET Standard 2.0 - -__Features__ - -- [__#143__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/143) Use identifier different from displayed message to compare existing issues -- [__#142__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/142) Add setting to limit number of issues posted to a pull request across multiple runs for issue providers -- [__#141__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/141) Add possibility to limit posted issues for a specific provider - - -## 0.9.0-beta.1 (July 14, 2020) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.0-beta0002 -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#154__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/154) Update to Cake.Issues 0.9.0 - - -## 0.8.1 (May 03, 2020) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/milestone/12?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.8.x -- Targeting .NET Standard 2.0 - -__Bug__ - -- [__#136__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/136) Don't log issues if they are not posted due to outdated commit - -__Improvement__ - -- [__#134__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/134) Add setting to limit number of issues posted to a pull request across multiple runs - - -## 0.8.1-beta.2 (April 29, 2020) - - -As part of this release we had 1 issue closed compared to 0.8.1-beta.1. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.8.x -- Targeting .NET Standard 2.0 - -__Bug__ - -- [__#145__](https://github.com/cake-contrib/Cake.Issues.PullRequests/pull/145) Consider unresolved issues for MaxIssuesToPostAcrossRuns (Thanks @janniksam) -## 0.8.1-beta.1 (April 27, 2020) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/milestone/12?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.8.x -- Targeting .NET Standard 2.0 - -__Improvement__ - -- [__#134__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/134) Add setting to limit number of issues posted to a pull request across multiple runs - -__Bug__ - -- [__#136__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/136) Don't log issues if they are not posted due to outdated commit -## 0.8.0 (October 17, 2019) - - -As part of this release we had [3 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/milestone/11?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.8.x -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#113__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/113) Update to Cake.Issues 0.8.0 - -__Improvements__ - -- [__#118__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/118) Embed NuGet package icon -- [__#116__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/116) Improve performance logging for issue filtering - - -## 0.8.0-beta.1 (October 11, 2019) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.PullRequests/milestone/11?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.8.0-beta.1 -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#113__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/113) Update to Cake.Issues 0.8.0 - - -## 0.7.0 (May 30, 2019) - - -As part of this release we had [32 commits](https://github.com/cake-contrib/Cake.Issues.PullRequests/compare/0.6.2...0.7.0) which resulted in [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/milestone/10?closed=1) being closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.7.x -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#78__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/78) Update to Cake.Issues 0.7.0 -- [__#77__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/77) Build against Cake 0.33.0 - - -## 0.7.0-beta.1 (April 19, 2019) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.7.x -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#78__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/78) Update to Cake.Issues 0.7.0 -- [__#77__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/77) Build against Cake 0.33.0 - - -## 0.6.2 (December 15, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=9&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.x - -__Bug__ - -- [__#50__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/50) No exception should be thrown if an empty list of issues is passed - - -## 0.6.1 (September 04, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=8&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.x - -__Improvement__ - -- [__#28__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/28) Provide alias which a list of issues can be passed - - -## 0.6.1-beta.1 (September 04, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.x - -__Improvement__ - -- [__#28__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/28) Provide alias which a list of issues can be passed - - -## 0.6.0 (August 24, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=7&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.x - -__Breaking changes__ - -- [__#45__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/45) Update to Cake.Issues 0.6.0 -- [__#43__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/43) Split pull request interface into different capabilities - - -## 0.6.0-beta.2 (August 20, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.0-beta.2 - -__Breaking changes__ - -- Update to Cake.Issues 0.6.0 Beta 2 -- Fix error with namespace import - - -## 0.6.0-beta.1 (August 18, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=7&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.0-beta.1 - -__Breaking changes__ - -- [__#45__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/45) Update to Cake.Issues 0.6.0 -- [__#43__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/43) Split pull request interface into different capabilities - - -## 0.5.0 (August 17, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=6&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.5.x - -__Breaking change__ - -- [__#41__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/41) Update to Cake.Issues 0.5.0 - -__Improvement__ - -- [__#44__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/44) Add repository metadata to nuspec - - -## 0.5.0-beta.1 (August 07, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.5.0-beta.2 - -__Breaking change__ - -- [__#41__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/41) Update to Cake.Issues 0.5.0 - - -## 0.4.0 (July 28, 2018) - - -As part of this release we had [5 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=5&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.4.x - -__Breaking changes__ - -- [__#39__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/39) Update to Cake.Issues 0.4.0 -- [__#30__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/30) Support different resolutions for comment thread resolving - -__Bugs__ - -- [__#36__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/36) Only resolve comments with the same comment source -- [__#29__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/29) Filtering on existing comments sometimes fails - - -## 0.4.0-beta.2 (July 25, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.4.0-beta.2 - -__Breaking changes__ - -- Update Cake.Issues to 0.4.0-beta.2 -## 0.4.0-beta.1 (July 24, 2018) - - -As part of this release we had 5 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.4.0-beta.1 - -__Breaking changes__ - -- [__#39__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/39) Update to Cake.Issues 0.4.0 -- [__#30__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/30) Support different resolutions for comment thread resolving - -__Bugs__ - -- [__#36__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/36) Only resolve comments with the same comment source -- [__#29__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/29) Filtering on existing comments sometimes fails - - -## 0.3.1 (June 21, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=4&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.3.x - -__Feature__ - -- [__#25__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/25) Add support to pass additional filter criterias - - -## 0.3.0 (June 04, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=3&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.3.x - -__Breaking changes__ - -- [__#22__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/22) Build against Cake 0.28.0 -- [__#20__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/20) Update to Cake.Issues 0.3.0 - - -## 0.3.0-beta.2 (June 02, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=3&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.3.0-beta.2 - -__Breaking changes__ - -- [__#22__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/22) Build against Cake 0.28.0 -- Update to Cake.Issues 0.3.0-beta.2 -## 0.3.0-beta.1 (May 31, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.3.0-beta.1 - -__Breaking change__ - -- [__#20__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/20) Update to Cake.Issues 0.3.0 - - -## 0.2.0 (May 22, 2018) - - -As part of this release we had [26 commits](https://github.com/cake-contrib/Cake.Issues.PullRequests/compare/0.1.0...0.2.0) which resulted in [6 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=2&state=closed) being closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.2.x - -__Breaking changes__ - -- [__#18__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/18) Build against Cake 0.26.0 -- [__#16__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/16) Allow to limit maximum issues per issue provider -- [__#14__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/14) Update to Cake.Issues 0.2.0 - -__Improvements__ - -- [__#9__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/9) Migrate to .NET Core -- [__#2__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/2) Check if pull request is still on the same commit before posting issues - - -## 0.2.0-beta.2 (March 10, 2018) - - -As part of this release we had the following issues closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.2.0-beta.4 - -__Bug__ - -- Mark as CLS compliant - -## 0.2.0-beta.1 (March 08, 2018) - - -As part of this release we had 6 issues closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.2.0-beta.3 - -__Breaking changes__ - -- [__#18__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/18) Build against Cake 0.26.0 -- [__#16__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/16) Allow to limit maximum issues per issue provider -- [__#14__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/14) Update to Cake.Issues 0.2.0 - -__Improvements__ - -- [__#9__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/9) Migrate to .NET Core -- [__#2__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/2) Check if pull request is still on the same commit before posting issues - - -## 0.1.0 (September 16, 2017) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues?milestone=1&state=closed) closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Cake.Issues 0.1.x - -__Breaking change__ - -- [__#8__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/8) Update to Cake 0.22 - -__Feature__ - -- [__#1__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/1) First version based on Cake.Prca - - -## 0.1.0-beta.3 (September 13, 2017) - - -As part of this release we had 2 issue closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Cake.Issues 0.1.0-beta.4 - -__Breaking Changes__ - -- Target .NET Framework 4.6 -- Build against Cake 0.22.0 -- Build against Cake.Issues 0.1.0-beta0004 -## 0.1.0-beta.2 (September 03, 2017) - - -As part of this release we had 2 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Cake.Issues 0.1.0-beta.3 - -__Breaking Changes__ - -- Update Cake.Issues to 0.1.0-beta0003 -- Move everything into single namespace -## 0.1.0-beta.1 (September 02, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Cake.Issues 0.1.0-beta.2 - -__Feature__ - -- [__#1__](https://github.com/cake-contrib/Cake.Issues.PullRequests/issues/1) First version based on Cake.Prca -e provider infrastructure - - -## 0.4.1 (August 03, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues/issues?milestone=6&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Feature__ - -- [__#39__](https://github.com/cake-contrib/Cake.Issues/issues/39) Provide infrastructure for issue provider with different formats - - -## 0.4.0 (July 28, 2018) - - -As part of this release we had [3 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=5&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#35__](https://github.com/cake-contrib/Cake.Issues/issues/35) Replace `IIssue.Project` with `IIssue.ProjectFileRelativePath` and `IIssue.ProjectName` - -__Improvement__ - -- [__#38__](https://github.com/cake-contrib/Cake.Issues/issues/38) Update XUnit to 2.4.0 - - -## 0.4.0-beta.2 (July 24, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Improvement__ - -- [__#38__](https://github.com/cake-contrib/Cake.Issues/issues/38) Update XUnit to 2.4.0 - - -## 0.4.0-beta.1 (July 24, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#35__](https://github.com/cake-contrib/Cake.Issues/issues/35) Replace `IIssue.Project` with `IIssue.ProjectFileRelativePath` and `IIssue.ProjectName`. -## 0.3.1 (June 20, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues/issues?milestone=4&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Feature__ - -- [__#27__](https://github.com/cake-contrib/Cake.Issues/issues/27) Add alias for creating issues from Cake scripts - - -## 0.3.0 (June 03, 2018) - - -As part of this release we had [14 commits](https://github.com/cake-contrib/Cake.Issues/compare/0.2.0...0.3.0) which resulted in [6 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=3&state=closed) being closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#29__](https://github.com/cake-contrib/Cake.Issues/issues/29) Make priority optional -- [__#28__](https://github.com/cake-contrib/Cake.Issues/issues/28) Build against Cake 0.28.0 -- [__#26__](https://github.com/cake-contrib/Cake.Issues/issues/26) Add fluent API for Issue creation -- [__#22__](https://github.com/cake-contrib/Cake.Issues/issues/22) Add PriorityName to IIssue -- [__#21__](https://github.com/cake-contrib/Cake.Issues/issues/21) Add ProviderName to IIssue - -__Feature__ - -- [__#25__](https://github.com/cake-contrib/Cake.Issues/issues/25) Add constants for priority values and names - - -## 0.3.0-beta.4 (June 03, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Bug Fix__ - -- Fix argument checking in fluent API - -## 0.3.0-beta.3 (June 03, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Improvement__ - -- Allow default values in fluent API -## 0.3.0-beta.2 (June 01, 2018) - - -As part of this release we had 4 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#29__](https://github.com/cake-contrib/Cake.Issues/issues/29) Make `IIssue.Priority` optional -- [__#28__](https://github.com/cake-contrib/Cake.Issues/issues/28) Build against Cake 0.28.0 -- [__#26__](https://github.com/cake-contrib/Cake.Issues/issues/26) Add fluent API for Issue creation - -__Feature__ - -- [__#25__](https://github.com/cake-contrib/Cake.Issues/issues/25) Add constants for priority values and names - - -## 0.3.0-beta.1 (May 31, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#22__](https://github.com/cake-contrib/Cake.Issues/issues/22) Add `PriorityName` to `IIssue` -- [__#21__](https://github.com/cake-contrib/Cake.Issues/issues/21) Add `ProviderName` to `IIssue` - - -## 0.2.0 (May 21, 2018) - - -As part of this release we had [6 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=2&state=closed) closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#13__](https://github.com/cake-contrib/Cake.Issues/issues/13) Build against Cake 0.26.0 - -__Features__ - -- [__#5__](https://github.com/cake-contrib/Cake.Issues/issues/5) Add project to `IIssue` -- [__#4__](https://github.com/cake-contrib/Cake.Issues/issues/4) Migrate to .NET Standard (Thanks [Tim Johnson](https://github.com/t-johnson)!) - -__Improvements__ - -- [__#20__](https://github.com/cake-contrib/Cake.Issues/issues/20) Make `IIssue.Rule` an optional parameter -- [__#8__](https://github.com/cake-contrib/Cake.Issues/issues/8) Upgrade XUnit to 2.3.0 - - -## 0.2.0-beta.4 (March 07, 2018) - - -As part of this release we had the following issues closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- Only target .NET Standard 2.0 -## 0.2.0-beta.3 (March 07, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#13__](https://github.com/cake-contrib/Cake.Issues/issues/13) Build against Cake 0.26.0 -## 0.2.0-beta.2 (December 24, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Standard 2.0 - -__Improvements__ - -- [__#8__](https://github.com/cake-contrib/Cake.Issues/issues/8) Upgrade XUnit to 2.3.0 -## 0.2.0-beta.1 (October 15, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Standard 2.0 - -__Features__ - -- [__#5__](https://github.com/cake-contrib/Cake.Issues/issues/5) Add project to `IIssue` -- [__#4__](https://github.com/cake-contrib/Cake.Issues/issues/4) Migrate to .NET Standard (Thanks [Tim Johnson](https://github.com/t-johnson)!) - - -## 0.1.0 (September 16, 2017) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=1&state=closed) closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Framework 4.6 - -__Breaking change__ - -- [__#3__](https://github.com/cake-contrib/Cake.Issues/issues/3) Update to Cake 0.22 - -__Feature__ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - -## 0.1.0-beta.4 (September 13, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Framework 4.6 - -__Breaking Changes__ - -- Target .NET Framework 4.6 -- Build against Cake 0.22.0 -## 0.1.0-beta.3 (September 03, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Breaking Changes__ - -- Move everything into single namespace. -## 0.1.0-beta.2 (September 02, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Enhancements__ - -- Add method `Issue.GetProviderTypeName()` for returning provider type name -- Put aliases for reading issues in own category -## 0.1.0-beta.1 (September 01, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Feature__ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - - -- Add method `Issue.GetProviderTypeName()` for returning provider type name -- Put aliases for reading issues in own category -## 0.1.0-beta.1 (September 01, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Feature__ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - -.2 - -__Feature__ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - diff --git a/docs/input/docs/overview/release-notes/Cake.Issues.Reporting.md b/docs/input/docs/overview/release-notes/Cake.Issues.Reporting.md deleted file mode 100644 index 43a06ec24..000000000 --- a/docs/input/docs/overview/release-notes/Cake.Issues.Reporting.md +++ /dev/null @@ -1,1036 +0,0 @@ ---- -Title: Cake.Issues.Reporting Release Notes -Description: Release notes for Cake.Issues.Reporting ---- -

-

-

-Starting with Cake.Issues 1.0, release notes for Cake.Issues.Reporting will be listed with Cake.Issues Release Notes. -The release notes on this page are only for versions of Cake.Issues.Reporting prior to 1.0. -

-
-

- -## 0.9.0 (August 22, 2020) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.Reporting/milestone/11?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.x -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#115__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/115) Update to Cake.Issues 0.9.0 - - -## 0.9.0-beta.2 (August 01, 2020) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.0-beta0004 -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- Update to Cake.Issues 0.9.0-beta0004 - - -## 0.9.0-beta.1 (July 12, 2020) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.9.0-beta0002 -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#115__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/115) Update to Cake.Issues 0.9.0 - - -## 0.8.0 (October 17, 2019) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.Reporting/milestone/10?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.8.0 -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#85__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/85) Update to Cake.Issues 0.8.0 - -__Improvement__ - -- [__#89__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/89) Embed NuGet package icon - - -## 0.8.0-beta.1 (October 11, 2019) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.Reporting/milestone/10?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.8.0-beta.1 -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#85__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/85) Update to Cake.Issues 0.8.0 - - -## 0.7.0 (May 30, 2019) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.Reporting/milestone/9?closed=1) closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.7.x -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#53__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/53) Update to Cake.Issues 0.7.0 -- [__#52__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/52) Build against Cake 0.33.0 - - -## 0.7.0-beta.1 (April 19, 2019) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.33.0 or higher -- Cake.Issues 0.7.x -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#53__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/53) Update to Cake.Issues 0.7.0 -- [__#52__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/52) Build against Cake 0.33.0 - - -## 0.6.1 (December 01, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=8&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.x -- Targeting .NET Standard 2.0 - -__Feature__ - -- [__#5__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/5) Migrate to .NET Standard (Thanks [Vadim Hatsura](https://github.com/vhatsura)) - - -## 0.6.0 (August 24, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=7&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.x - -__Breaking change__ - -- [__#26__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/26) Update to Cake.Issues 0.6.0 - - -## 0.6.0-beta.2 (August 20, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.0-beta.2 - -__Breaking change__ - -- Update to Cake.Issues 0.6.0 Beta 2 - - -## 0.6.0-beta.1 (August 19, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.6.0-beta.1 - -__Breaking change__ - -- [__#26__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/26) Update to Cake.Issues 0.6.0 - - -## 0.5.0 (August 17, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=6&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.5.x - -__Breaking change__ - -- [__#23__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/23) Update to Cake.Issues 0.5.0 - -__Improvement__ - -- [__#25__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/25) Add repository metadata to nuspec - - -## 0.5.0-beta.1 (August 07, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.5.0-beta.2 - -__Breaking change__ - -- [__#23__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/23) Update to Cake.Issues 0.5.0 - - -## 0.4.0 (July 28, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=5&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.4.x - -__Breaking change__ - -- [__#21__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/21) Update to Cake.Issues 0.4.0 - - -## 0.4.0-beta.2 (July 25, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.4.0-beta.2 - -__Breaking change__ - -- Update Cake.Issues to 0.4.0-beta.2 - - -## 0.4.0-beta.1 (July 24, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.4.0-beta.1 - -__Breaking change__ - -- [__#21__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/21) Update to Cake.Issues 0.4.0 - - -## 0.3.0 (June 04, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=4&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.3.x - -__Breaking changes__ - -- [__#17__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/17) Build against Cake 0.28.0 -- [__#15__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/15) Update to Cake.Issues 0.3.0 - - -## 0.3.0-beta.2 (June 01, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Cake.Issues 0.3.0-beta.2 - -__Breaking changes__ - -- [__#17__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/17) Build against Cake 0.28.0 -- Update to Cake.Issues 0.3.0-beta.2 - -## 0.3.0-beta.1 (May 31, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.3.0-beta.1 - -__Breaking change__ - -- [__#15__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/15) Update to Cake.Issues 0.3.0 - - -## 0.2.1 (May 25, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=3&state=closed) closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.2.x - -__Documentation__ - -- [__#13__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/13) Update examples to current version of Cake.Issues.Reporting.Generic - - -## 0.2.0 (May 23, 2018) - - -As part of this release we had [3 issues](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=2&state=closed) closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.2.x - -__Breaking changes__ - -- [__#10__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/10) Build against Cake 0.26.0 -- [__#9__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/9) Update to Cake.Issues 0.2.0 - - -## 0.2.0-beta.2 (May 23, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.2.x - -__Breaking changes__ - -- Target .NET Framework 4.6.1 instead of 4.62 - - -## 0.2.0-beta.1 (May 23, 2018) - - -As part of this release we had 3 issues closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Cake.Issues 0.2.x - -__Breaking changes__ - -- [__#10__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/10) Build against Cake 0.26.0 -- [__#9__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/9) Update to Cake.Issues 0.2.0 - - -## 0.1.0 (October 16, 2017) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues.Reporting/issues?milestone=1&state=closed) closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Cake.Issues 0.1.0 - -__Breaking change__ - -- [__#3__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/3) Update to Cake 0.22 - -__Feature__ - -- [__#1__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/1) Basic implementation - - -## 0.1.0-beta.6 (September 16, 2017) - - -As part of this release we had 2 issue closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Cake.Issues 0.1.0 - -__Breaking Changes__ - -- Build against Cake.Issues 0.1.0 - -__Features__ - -- Add alias for single issue provider -## 0.1.0-beta.5 (September 13, 2017) - - -As part of this release we had 3 issue closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Cake.Issues 0.1.0-beta.4 - -__Breaking Changes__ - -- Target .NET Framework 4.6 -- Build against Cake 0.22.0 -- Build against Cake.Issues 0.1.0-beta0004 -## 0.1.0-beta.4 (September 10, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Cake.Issues 0.1.0-beta.3 - -__Breaking Changes__ - -- Add `CreateIssueReportSettings` and requirement to pass in output file path -## 0.1.0-beta.3 (September 10, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Cake.Issues 0.1.0-beta.3 - -__Breaking Changes__ - -- Update Cake.Issues to 0.1.0-beta0003 -## 0.1.0-beta.2 (September 09, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Cake.Issues 0.1.0-beta.1 - -__Feature__ - -- Move everything into single namespace -## 0.1.0-beta.1 (September 09, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Cake.Issues 0.1.0-beta.1 - -__Feature__ - -- [__#1__](https://github.com/cake-contrib/Cake.Issues.Reporting/issues/1) Basic implementation - - -https://github.com/cake-contrib/Cake.Issues/issues/97) XML comment for `IIssue.ProjectFileRelativePath` mentions `string.Empty` as valid value - - -## 0.6.2 (September 05, 2018) - - -As part of this release we had [3 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=10&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Bug__ - -- [__#60__](https://github.com/cake-contrib/Cake.Issues/issues/60) `ByteArrayExtensions.ToStringUsingEncoding` throws an exception if empty byte array is passed - -__Improvements__ - -- [__#62__](https://github.com/cake-contrib/Cake.Issues/issues/62) `ToStringUsingEncoding` should not throw if no preamble exists -- [__#46__](https://github.com/cake-contrib/Cake.Issues/issues/46) Add test cases for `Cake.Issues.Testing` - - -## 0.6.2-beta.2 (September 05, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Improvement__ - -- [__#46__](https://github.com/cake-contrib/Cake.Issues/issues/46) Add test cases for Cake.Issues.Testing - - -## 0.6.2-beta.1 (September 04, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Bug__ - -- [__#60__](https://github.com/cake-contrib/Cake.Issues/issues/60) ByteArrayExtensions.ToStringUsingEncoding throws an exception if empty byte array is passed - -__Improvement__ - -- [__#62__](https://github.com/cake-contrib/Cake.Issues/issues/62) ToStringUsingEncoding should not throw if no preamble exists - - -## 0.6.1 (September 02, 2018) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=9&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Features__ - -- [__#57__](https://github.com/cake-contrib/Cake.Issues/issues/57) Add method for replacing issues tokens in string -- [__#56__](https://github.com/cake-contrib/Cake.Issues/issues/56) Add extensions for `IIssue` project and file - - -## 0.6.1-beta.1 (August 26, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Features__ - -- [__#57__](https://github.com/cake-contrib/Cake.Issues/issues/57) Add method for replacing issues tokens in string -- [__#56__](https://github.com/cake-contrib/Cake.Issues/issues/56) Add extensions for `IIssue` project and file - - -## 0.6.0 (August 24, 2018) - - -As part of this release we had [3 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=8&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#54__](https://github.com/cake-contrib/Cake.Issues/issues/54) `BaseMultiFormatIssueProvider.ReadIssues` ignores format -- [__#50__](https://github.com/cake-contrib/Cake.Issues/issues/50) Add method to check if initialized was called on `BaseIssueComponent` - -__Bug__ - -- [__#53__](https://github.com/cake-contrib/Cake.Issues/issues/53) Typo in comment for `BaseMultiFormatIssueProvider` - - -## 0.6.0-beta.2 (August 19, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#54__](https://github.com/cake-contrib/Cake.Issues/issues/54) BaseMultiFormatIssueProvider.ReadIssues ignores format -## 0.6.0-beta.1 (August 18, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#50__](https://github.com/cake-contrib/Cake.Issues/issues/50) Add method to check if initialized was called on BaseIssueComponent - -__Bug__ - -- [__#53__](https://github.com/cake-contrib/Cake.Issues/issues/53) Typo in comment for BaseMultiFormatIssueProvider - - -## 0.5.0 (August 17, 2018) - - -As part of this release we had [4 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=7&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#44__](https://github.com/cake-contrib/Cake.Issues/issues/44) Improve issue provider infrastructure - -__Features__ - -- [__#48__](https://github.com/cake-contrib/Cake.Issues/issues/48) Add helper for string / byte array conversion -- [__#47__](https://github.com/cake-contrib/Cake.Issues/issues/47) Add helper for working with embedded resources on file system - -__Improvement__ - -- [__#49__](https://github.com/cake-contrib/Cake.Issues/issues/49) Add repository metadata to nuspec - - -## 0.5.0-beta.3 (August 17, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Improvement__ - -- [__#49__](https://github.com/cake-contrib/Cake.Issues/issues/49) Add repository metadata to nuspec - - -## 0.5.0-beta.2 (August 06, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Features__ - -- [__#48__](https://github.com/cake-contrib/Cake.Issues/issues/48) Add helper for string / byte array conversion -- [__#47__](https://github.com/cake-contrib/Cake.Issues/issues/47) Add helper for working with embedded resources on file system - - -## 0.5.0-beta.1 (August 05, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues/issues?milestone=7&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#44__](https://github.com/cake-contrib/Cake.Issues/issues/44) Improve issue provider infrastructure - - -## 0.4.1 (August 03, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues/issues?milestone=6&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Feature__ - -- [__#39__](https://github.com/cake-contrib/Cake.Issues/issues/39) Provide infrastructure for issue provider with different formats - - -## 0.4.0 (July 28, 2018) - - -As part of this release we had [3 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=5&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#35__](https://github.com/cake-contrib/Cake.Issues/issues/35) Replace `IIssue.Project` with `IIssue.ProjectFileRelativePath` and `IIssue.ProjectName` - -__Improvement__ - -- [__#38__](https://github.com/cake-contrib/Cake.Issues/issues/38) Update XUnit to 2.4.0 - - -## 0.4.0-beta.2 (July 24, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Improvement__ - -- [__#38__](https://github.com/cake-contrib/Cake.Issues/issues/38) Update XUnit to 2.4.0 - - -## 0.4.0-beta.1 (July 24, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#35__](https://github.com/cake-contrib/Cake.Issues/issues/35) Replace `IIssue.Project` with `IIssue.ProjectFileRelativePath` and `IIssue.ProjectName`. -## 0.3.1 (June 20, 2018) - - -As part of this release we had [1 issue](https://github.com/cake-contrib/Cake.Issues/issues?milestone=4&state=closed) closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Feature__ - -- [__#27__](https://github.com/cake-contrib/Cake.Issues/issues/27) Add alias for creating issues from Cake scripts - - -## 0.3.0 (June 03, 2018) - - -As part of this release we had [14 commits](https://github.com/cake-contrib/Cake.Issues/compare/0.2.0...0.3.0) which resulted in [6 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=3&state=closed) being closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#29__](https://github.com/cake-contrib/Cake.Issues/issues/29) Make priority optional -- [__#28__](https://github.com/cake-contrib/Cake.Issues/issues/28) Build against Cake 0.28.0 -- [__#26__](https://github.com/cake-contrib/Cake.Issues/issues/26) Add fluent API for Issue creation -- [__#22__](https://github.com/cake-contrib/Cake.Issues/issues/22) Add PriorityName to IIssue -- [__#21__](https://github.com/cake-contrib/Cake.Issues/issues/21) Add ProviderName to IIssue - -__Feature__ - -- [__#25__](https://github.com/cake-contrib/Cake.Issues/issues/25) Add constants for priority values and names - - -## 0.3.0-beta.4 (June 03, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Bug Fix__ - -- Fix argument checking in fluent API - -## 0.3.0-beta.3 (June 03, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Improvement__ - -- Allow default values in fluent API -## 0.3.0-beta.2 (June 01, 2018) - - -As part of this release we had 4 issues closed. - -__Requirements__ - -- Cake 0.28.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#29__](https://github.com/cake-contrib/Cake.Issues/issues/29) Make `IIssue.Priority` optional -- [__#28__](https://github.com/cake-contrib/Cake.Issues/issues/28) Build against Cake 0.28.0 -- [__#26__](https://github.com/cake-contrib/Cake.Issues/issues/26) Add fluent API for Issue creation - -__Feature__ - -- [__#25__](https://github.com/cake-contrib/Cake.Issues/issues/25) Add constants for priority values and names - - -## 0.3.0-beta.1 (May 31, 2018) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking changes__ - -- [__#22__](https://github.com/cake-contrib/Cake.Issues/issues/22) Add `PriorityName` to `IIssue` -- [__#21__](https://github.com/cake-contrib/Cake.Issues/issues/21) Add `ProviderName` to `IIssue` - - -## 0.2.0 (May 21, 2018) - - -As part of this release we had [6 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=2&state=closed) closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#13__](https://github.com/cake-contrib/Cake.Issues/issues/13) Build against Cake 0.26.0 - -__Features__ - -- [__#5__](https://github.com/cake-contrib/Cake.Issues/issues/5) Add project to `IIssue` -- [__#4__](https://github.com/cake-contrib/Cake.Issues/issues/4) Migrate to .NET Standard (Thanks [Tim Johnson](https://github.com/t-johnson)!) - -__Improvements__ - -- [__#20__](https://github.com/cake-contrib/Cake.Issues/issues/20) Make `IIssue.Rule` an optional parameter -- [__#8__](https://github.com/cake-contrib/Cake.Issues/issues/8) Upgrade XUnit to 2.3.0 - - -## 0.2.0-beta.4 (March 07, 2018) - - -As part of this release we had the following issues closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- Only target .NET Standard 2.0 -## 0.2.0-beta.3 (March 07, 2018) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.26.0 or higher -- Targeting .NET Standard 2.0 - -__Breaking change__ - -- [__#13__](https://github.com/cake-contrib/Cake.Issues/issues/13) Build against Cake 0.26.0 -## 0.2.0-beta.2 (December 24, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Standard 2.0 - -__Improvements__ - -- [__#8__](https://github.com/cake-contrib/Cake.Issues/issues/8) Upgrade XUnit to 2.3.0 -## 0.2.0-beta.1 (October 15, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Standard 2.0 - -__Features__ - -- [__#5__](https://github.com/cake-contrib/Cake.Issues/issues/5) Add project to `IIssue` -- [__#4__](https://github.com/cake-contrib/Cake.Issues/issues/4) Migrate to .NET Standard (Thanks [Tim Johnson](https://github.com/t-johnson)!) - - -## 0.1.0 (September 16, 2017) - - -As part of this release we had [2 issues](https://github.com/cake-contrib/Cake.Issues/issues?milestone=1&state=closed) closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Framework 4.6 - -__Breaking change__ - -- [__#3__](https://github.com/cake-contrib/Cake.Issues/issues/3) Update to Cake 0.22 - -__Feature__ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - -## 0.1.0-beta.4 (September 13, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.22.0 - Cake 0.25.0 -- Targeting .NET Framework 4.6 - -__Breaking Changes__ - -- Target .NET Framework 4.6 -- Build against Cake 0.22.0 -## 0.1.0-beta.3 (September 03, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Breaking Changes__ - -- Move everything into single namespace. -## 0.1.0-beta.2 (September 02, 2017) - - -As part of this release we had 2 issues closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Enhancements__ - -- Add method `Issue.GetProviderTypeName()` for returning provider type name -- Put aliases for reading issues in own category -## 0.1.0-beta.1 (September 01, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Feature__ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - -d `Issue.GetProviderTypeName()` for returning provider type name -- Put aliases for reading issues in own category -## 0.1.0-beta.1 (September 01, 2017) - - -As part of this release we had 1 issue closed. - -__Requirements__ - -- Cake 0.16.2 - Cake 0.21.1 -- Targeting .NET Framework 4.5.2 - -__Feature__ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - -_ - -- [__#2__](https://github.com/cake-contrib/Cake.Issues/issues/2) First version based on Cake.Prca - - diff --git a/docs/input/docs/overview/release-notes/index.cshtml b/docs/input/docs/overview/release-notes/index.cshtml deleted file mode 100644 index cbb6d5a8f..000000000 --- a/docs/input/docs/overview/release-notes/index.cshtml +++ /dev/null @@ -1,11 +0,0 @@ ---- -Order: 30 -Description: Release notes for the Cake Issues core addins. ---- - -

- For addin release notes see Issue Providers, - Report Formats and Pull Request Systems. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/overview/requirements.md b/docs/input/docs/overview/requirements.md deleted file mode 100644 index 901eb33c4..000000000 --- a/docs/input/docs/overview/requirements.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -Order: 30 -Description: Requirements for using Cake.Issues. ---- -The requirements for core addins are listed in the release notes for any specific version: - -* [Release notes Cake.Issues] -* [Release notes Cake.Issues.PullRequests] -* [Release notes Cake.Issues.Reporting] - -:::{.alert .alert-info} -Note that individual addins might require a newer version of Cake. -Please see in the documentation of the specific addin for additional requirements for individual addins. -::: - -[Release notes Cake.Issues]: release-notes/Cake.Issues -[Release notes Cake.Issues.PullRequests]: release-notes/Cake.Issues.PullRequests -[Release notes Cake.Issues.Reporting]: release-notes/Cake.Issues.Reporting \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/appveyor/examples/index.cshtml b/docs/input/docs/pull-request-systems/appveyor/examples/index.cshtml deleted file mode 100644 index f0d5372ef..000000000 --- a/docs/input/docs/pull-request-systems/appveyor/examples/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: Examples -Description: Examples for using the Cake.Issues.PullRequests.AppVeyor addin. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -
-There's a demo repository -available which you can fork and to which you can create pull requests to test the integration functionality. -
- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/appveyor/features.md b/docs/input/docs/pull-request-systems/appveyor/features.md deleted file mode 100644 index 68211906f..000000000 --- a/docs/input/docs/pull-request-systems/appveyor/features.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.PullRequests.AppVeyor addin. ---- -The [Cake.Issues.PullRequests.AppVeyor addin] reports issues as messages to AppVeyor builds. - -![AppVeyor messages](appveyor-messages.png "AppVeyor messages") - -:::{.alert .alert-info} -There's a [demo repository] available which you can fork and to which you can create pull requests to test the integration functionality. -::: - -# Basic features - -* Reports issues as messages to AppVeyor builds. -* Messages can be written as comment to GitHub pull requests. - See [GitHub pull request integration] for an example. - -# Supported capabilities - -The [Cake.Issues.PullRequests.AppVeyor addin] doesn't support any additional capabilities. - -| | Capability | Remarks | -|--------------------------------------------------------------------|--------------------------------|--------------------------------| -| | Checking commit ID | | -| | Discussion threads | | -| | Filtering by modified files | | - -[demo repository]: https://github.com/pascalberger/Cake.Issues-Demo -[Cake.Issues.PullRequests.AppVeyor addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.AppVeyor -[GitHub pull request integration]: ./examples/github-pullrequest-integration diff --git a/docs/input/docs/pull-request-systems/appveyor/index.cshtml b/docs/input/docs/pull-request-systems/appveyor/index.cshtml deleted file mode 100644 index f704df063..000000000 --- a/docs/input/docs/pull-request-systems/appveyor/index.cshtml +++ /dev/null @@ -1,10 +0,0 @@ ---- -Title: AppVeyor -Description: Support for AppVeyor. ---- -

- Support for AppVeyor is implemented in the - Cake.Issues.PullRequests.AppVeyor addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/appveyor/requirements.md b/docs/input/docs/pull-request-systems/appveyor/requirements.md deleted file mode 100644 index 446b03b69..000000000 --- a/docs/input/docs/pull-request-systems/appveyor/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.PullRequests.AppVeyor addin. ---- -The requirements for using the [Cake.Issues.PullRequests.AppVeyor addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.PullRequests.AppVeyor addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.AppVeyor -[release notes]: release-notes \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/azure-devops/examples/index.cshtml b/docs/input/docs/pull-request-systems/azure-devops/examples/index.cshtml deleted file mode 100644 index 17e2702db..000000000 --- a/docs/input/docs/pull-request-systems/azure-devops/examples/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: Examples -Description: Examples for using the Cake.Issues.PullRequests.AzureDevOps addin. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -
-There's a demo repository -available which you can fork and to which you can create pull requests to test the integration functionality. -
- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/azure-devops/features.md b/docs/input/docs/pull-request-systems/azure-devops/features.md deleted file mode 100644 index b3b4bc228..000000000 --- a/docs/input/docs/pull-request-systems/azure-devops/features.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.PullRequests.AzureDevOps addin. ---- -The [Cake.Issues.PullRequests.AzureDevOps addin] provides the following features. - -:::{.alert .alert-info} -There's a [demo repository] available which you can fork and to which you can create pull requests to test the integration functionality. -::: - -# Basic features - -* Writes issues as comments to [Azure DevOps] pull requests. -* Identification of pull requests through source branch or pull request ID. -* Comments written by the addin will be rendered with a specific icon corresponding to the state of the issue. -* Adds rule number and, if provided by the issue provider, link to the rule description to the comment. -* Support for issues messages formatted in Markdown format. - -# Supported capabilities - -The [Cake.Issues.PullRequests.AzureDevOps addin] supports all [Core features]. - -| | Capability | Remarks | -|--------------------------------------------------------------------|--------------------------------|--------------------------------| -| | Checking commit ID | | -| | Discussion threads | | -| | Filtering by modified files | | - -# Supported authentication methods - -| Azure DevOps Server | Azure DevOps Service | Authentication method | -|--------------------------------------------------------------------|--------------------------------------------------------------------|--------------------------------| -| | | NTLM | -| | | Basic authentication | -| | | Personal access token | -| | | OAuth | -| | | Azure Active Directory | - -For detailed instructions how to connect using the different methods see [Setup instructions]. - -![Cake.Issues.PullRequests.AzureDevOps](cake.issues.pullrequests.azuredevops.png "Cake.Issues.PullRequests.AzureDevOps") - -[demo repository]: https://dev.azure.com/pberger/Cake.Issues-Demo -[Cake.Issues.PullRequests.AzureDevOps addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.AzureDevOps -[Azure DevOps]: https://azure.microsoft.com/en-us/services/devops/ -[Core features]: ../../overview/features#supported-core-functionality -[Setup instructions]: setup diff --git a/docs/input/docs/pull-request-systems/azure-devops/index.cshtml b/docs/input/docs/pull-request-systems/azure-devops/index.cshtml deleted file mode 100644 index fbf68afda..000000000 --- a/docs/input/docs/pull-request-systems/azure-devops/index.cshtml +++ /dev/null @@ -1,10 +0,0 @@ ---- -Title: Azure DevOps -Description: Support for Azure DevOps. ---- -

- Support for Azure DevOps is implemented in the - Cake.Issues.PullRequests.AzureDevOps addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/azure-devops/requirements.md b/docs/input/docs/pull-request-systems/azure-devops/requirements.md deleted file mode 100644 index 9c245110d..000000000 --- a/docs/input/docs/pull-request-systems/azure-devops/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.PullRequests.AzureDevOps addin. ---- -The requirements for using the [Cake.Issues.PullRequests.AzureDevOps addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.PullRequests.AzureDevOps addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.AzureDevOps -[release notes]: release-notes diff --git a/docs/input/docs/pull-request-systems/github-actions/examples/index.cshtml b/docs/input/docs/pull-request-systems/github-actions/examples/index.cshtml deleted file mode 100644 index f6edfee20..000000000 --- a/docs/input/docs/pull-request-systems/github-actions/examples/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Title: Examples -Description: Examples for using the Cake.Issues.PullRequests.GitHubActions addin. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/github-actions/features.md b/docs/input/docs/pull-request-systems/github-actions/features.md deleted file mode 100644 index 91dea5e3c..000000000 --- a/docs/input/docs/pull-request-systems/github-actions/features.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.PullRequests.GitHubActions addin. ---- -The [Cake.Issues.PullRequests.GitHubActions addin] creates annotations from issues when running on GitHub actions. - -![Pull request integration](githubactions-pullrequest-integration.png "Pull request integration") - -# Basic features - -* Reports issues as annotations to GitHub Actions builds. -* Group issues in log output by provider and run information. - -# Supported capabilities - -The [Cake.Issues.PullRequests.GitHubActions addin] doesn't support any additional capabilities. - -| | Capability | Remarks | -|--------------------------------------------------------------------|--------------------------------|--------------------------------| -| | Checking commit ID | | -| | Discussion threads | | -| | Filtering by modified files | | - -[Cake.Issues.PullRequests.GitHubActions addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.GitHubActions diff --git a/docs/input/docs/pull-request-systems/github-actions/index.cshtml b/docs/input/docs/pull-request-systems/github-actions/index.cshtml deleted file mode 100644 index aba361913..000000000 --- a/docs/input/docs/pull-request-systems/github-actions/index.cshtml +++ /dev/null @@ -1,10 +0,0 @@ ---- -Title: GitHub Actions -Description: Support for GitHub Actions. ---- -

- Support for GitHub Actions is implemented in the - Cake.Issues.PullRequests.GitHubActions addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/pull-request-systems/github-actions/requirements.md b/docs/input/docs/pull-request-systems/github-actions/requirements.md deleted file mode 100644 index e1e66947a..000000000 --- a/docs/input/docs/pull-request-systems/github-actions/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.PullRequests.GitHubActions addin. ---- -The requirements for using the [Cake.Issues.PullRequests.GitHubActions addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.PullRequests.GitHubActions addin]: https://www.nuget.org/packages/Cake.Issues.PullRequests.GitHubActions -[release notes]: release-notes diff --git a/docs/input/docs/pull-request-systems/index.cshtml b/docs/input/docs/pull-request-systems/index.cshtml deleted file mode 100644 index d97667a6c..000000000 --- a/docs/input/docs/pull-request-systems/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Order: 70 -Description: Documentation of the different pull request system implementations. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/recipe/usage/index.cshtml b/docs/input/docs/recipe/usage/index.cshtml deleted file mode 100644 index 190abe4f7..000000000 --- a/docs/input/docs/recipe/usage/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Order: 20 -Description: How to use Cake.Issues recipes in your build script. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/report-formats/console/index.cshtml b/docs/input/docs/report-formats/console/index.cshtml deleted file mode 100644 index 5003c9001..000000000 --- a/docs/input/docs/report-formats/console/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: Console -Description: Report format to print issues to the console. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for printing issues to the console is implemented in the - Cake.Issues.Reporting.Console addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/report-formats/console/requirements.md b/docs/input/docs/report-formats/console/requirements.md deleted file mode 100644 index 469d4c60c..000000000 --- a/docs/input/docs/report-formats/console/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.Reporting.Console addin. ---- -The requirements for using the [Cake.Issues.Reporting.Console addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.Reporting.Console addin]: https://www.nuget.org/packages/Cake.Issues.Reporting.Console -[release notes]: release-notes \ No newline at end of file diff --git a/docs/input/docs/report-formats/generic/index.cshtml b/docs/input/docs/report-formats/generic/index.cshtml deleted file mode 100644 index 801250351..000000000 --- a/docs/input/docs/report-formats/generic/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: Generic -Description: Report format to create reports in any text based format (HTML, Markdown, ...). ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for creating reports in any text based format like HTML or Markdown is implemented in the - Cake.Issues.Reporting.Generic addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/report-formats/generic/requirements.md b/docs/input/docs/report-formats/generic/requirements.md deleted file mode 100644 index e5c917073..000000000 --- a/docs/input/docs/report-formats/generic/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.Reporting.Generic addin. ---- -The requirements for using the [Cake.Issues.Reporting.Generic addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.Reporting.Generic addin]: https://www.nuget.org/packages/Cake.Issues.Reporting.Generic -[release notes]: release-notes \ No newline at end of file diff --git a/docs/input/docs/report-formats/generic/templates/.artifactignore b/docs/input/docs/report-formats/generic/templates/.artifactignore deleted file mode 100644 index 3c8fd7f2d..000000000 --- a/docs/input/docs/report-formats/generic/templates/.artifactignore +++ /dev/null @@ -1,2 +0,0 @@ -**/* -!*.html \ No newline at end of file diff --git a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid.md b/docs/input/docs/report-formats/generic/templates/htmldxdatagrid.md deleted file mode 100644 index d0745306a..000000000 --- a/docs/input/docs/report-formats/generic/templates/htmldxdatagrid.md +++ /dev/null @@ -1,240 +0,0 @@ ---- -Order: 10 -Title: HTML DevExtreme Data Grid -Description: Template for a HTML report containing a rich data grid with sorting, filtering, grouping and search capabilities. ---- -Template for a HTML report containing a rich data grid with sorting, filtering, grouping and search capabilities powered by [DevExtreme]. - -![HTML DevExtreme Data Grid](htmldxdatagrid01.png "HTML DevExtreme Data Grid") - -# Features - -* Table with `Provider`, `Severity`, `Project`, `Path`, `File`, `Location`, `Rule`, `Message` by default. -* Support for grouping by multiple columns by user. -* Total number of issues by each group level. -* Each column sortable by user. -* Data can be filtered by any column by user. -* Paged view. -* Client-side full text search. -* Client-side export to Microsoft Excel or PDF. -* Fully customizable through [options](#options). - -# Requirements - -* Cake.Issues.Reporting.Generic 0.3.1 or higher - -# Usage - -To create a report using the HTML DevExtreme Data Grid template you can use the [GenericIssueReportTemplate.HtmlDxDataGrid] enum value: - -```csharp -CreateIssueReport( - issues, - GenericIssueReportFormatFromEmbeddedTemplate(GenericIssueReportTemplate.HtmlDxDataGrid), - @"c:\repo", - @"c:\report.html"); -``` - -# Options - -See [HtmlDxDataGridOption] for a list of possible options. - -# Demos - -The following demo shows the template with its default options: - -* Default - (Source Code) - -## Themes - -The template supports the teams defined in the [DevExtremeTheme] enumeration which can be set using the [HtmlDxDataGridOption.Theme]: - -```csharp -CreateIssueReport( - issues, - GenericIssueReportFormatFromEmbeddedTemplate( - GenericIssueReportTemplate.HtmlDxDataGrid, - settings => settings.WithOption(HtmlDxDataGridOption.Theme, DevExtremeTheme.MaterialBlueLight)), - @"c:\repo", - @"c:\report.html"); -``` - -* Light Theme - (Source Code) -* Dark Theme - (Source Code) -* Contrast Theme - (Source Code) -* Carmine Theme - (Source Code) -* Dark Moon Theme - (Source Code) -* Soft Blue Theme - (Source Code) -* Dark Violet Theme - (Source Code) -* Green Mist Theme - (Source Code) -* Light Compact Theme - (Source Code) -* Dark Compact Theme - (Source Code) -* Contrast Compact Theme - (Source Code) -* Material Blue Light Theme - (Source Code) -* Material Lime Light Theme - (Source Code) -* Material Orange Light Theme - (Source Code) -* Material Purple Light Theme - (Source Code) -* Material Teal Light Theme - (Source Code) -* Material Blue Dark Theme - (Source Code) -* Material Lime Dark Theme - (Source Code) -* Material Orange Dark Theme - (Source Code) -* Material Purple Dark Theme - (Source Code) -* Material Teal Dark Theme - (Source Code) -* Material Blue Light Compact Theme - (Source Code) -* Material Lime Light Compact Theme - (Source Code) -* Material Orange Light Compact Theme - (Source Code) -* Material Purple Light Compact Theme - (Source Code) -* Material Teal Light Compact Theme - (Source Code) -* Material Blue Dark Compact Theme - (Source Code) -* Material Lime Dark Compact Theme - (Source Code) -* Material Orange Dark Compact Theme - (Source Code) -* Material Purple Dark Compact Theme - (Source Code) -* Material Teal Dark Compact Theme - (Source Code) - -## Column visibility - -Visible columns can be defined using the `ColumnNameVisible` option: - -```csharp -CreateIssueReport( - issues, - GenericIssueReportFormatFromEmbeddedTemplate( - GenericIssueReportTemplate.HtmlDxDataGrid, - settings => settings.WithOption(HtmlDxDataGridOption.LineVisible, false)), - @"c:\repo", - @"c:\report.html"); -``` - -Additional columns can be added using the [HtmlDxDataGridOption.AdditionalColumns] option. - -* Show and hide columns - (Source Code) -* Add additional columns - (Source Code) - -## Sorting - -Sorted columns can be defined using the [HtmlDxDataGridOption.SortedColumns] and the -`ColumnNameSortOder` options: - -```csharp -CreateIssueReport( - issues, - GenericIssueReportFormatFromEmbeddedTemplate( - GenericIssueReportTemplate.HtmlDxDataGrid, - settings => settings - .WithOption(HtmlDxDataGridOption.SortedColumns, new List { ReportColumn.RuleId }) - .WithOption(HtmlDxDataGridOption.RuleIdSortOder, ColumnSortOderDescending )), - @"c:\repo", - @"c:\report.html"); -``` - -* Change sorting - (Source Code) - -## Grouping - -Grouping can be defined using the [HtmlDxDataGridOption.GroupedColumns] option: - -```csharp -CreateIssueReport( - issues, - GenericIssueReportFormatFromEmbeddedTemplate( - GenericIssueReportTemplate.HtmlDxDataGrid, - settings => settings.WithOption(HtmlDxDataGridOption.GroupedColumns, new List { ReportColumn.RuleId })), - @"c:\repo", - @"c:\report.html"); -``` - -* Change grouping - (Source Code) -* Disable grouping - (Source Code) - -## Exporting - -Exporting can be enabled using the [HtmlDxDataGridOption.EnableExporting] option: - -```csharp -CreateIssueReport( - issues, - GenericIssueReportFormatFromEmbeddedTemplate( - GenericIssueReportTemplate.HtmlDxDataGrid, - settings => settings.WithOption(HtmlDxDataGridOption.EnableExporting, true)), - @"c:\repo", - @"c:\report.html"); -``` - -* Enable exporting - (Source Code) -* Microsoft Excel export (*.xlsx) - (Source Code) -* PDF export (*.pdf) - (Source Code) -* Custom export file name - (Source Code) - -## Other features - -* Change title - (Source Code) -* Disable header - (Source Code) -* Disable filtering - (Source Code) -* Disable searching - (Source Code) -* Custom script location and version - (Source Code) - -# Source Code - -:::{.alert .alert-info} -You can use the source code as a template for your [custom template]. -::: - -Source code is available on [GitHub]. - -[DevExtreme]: https://js.devexpress.com -[GenericIssueReportTemplate.HtmlDxDataGrid]: ../../../../../api/Cake.Issues.Reporting.Generic/GenericIssueReportTemplate/0E9E9D94 -[HtmlDxDataGridOption]: ../../../../../api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/ -[DevExtremeTheme]: ../../../../../api/Cake.Issues.Reporting.Generic/DevExtremeTheme/ -[HtmlDxDataGridOption.Theme]: ../../../../../api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/EA83DCAB -[HtmlDxDataGridOption.AdditionalColumns]: ../../../../../api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/F9860912 -[HtmlDxDataGridOption.SortedColumns]: ../../../../../api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/D578E453 -[HtmlDxDataGridOption.GroupedColumns]: ../../../../../api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/0907599C -[HtmlDxDataGridOption.EnableExporting]: ../../../../../api/Cake.Issues.Reporting.Generic/HtmlDxDataGridOption/1441E285 -[custom template]: ../examples/custom-template -[GitHub]: https://github.com/cake-contrib/Cake.Issues.Reporting.Generic/blob/develop/src/Cake.Issues.Reporting.Generic/Templates/DxDataGrid.cshtml diff --git a/docs/input/docs/report-formats/generic/templates/index.cshtml b/docs/input/docs/report-formats/generic/templates/index.cshtml deleted file mode 100644 index b7e0cc3c3..000000000 --- a/docs/input/docs/report-formats/generic/templates/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Title: Template Gallery -Description: Gallery of available out of the box and 3rd party templates. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/report-formats/index.cshtml b/docs/input/docs/report-formats/index.cshtml deleted file mode 100644 index b7df95e01..000000000 --- a/docs/input/docs/report-formats/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Order: 60 -Description: Documentation of the different report format addins. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/report-formats/sarif/features.md b/docs/input/docs/report-formats/sarif/features.md deleted file mode 100644 index b2ab2de32..000000000 --- a/docs/input/docs/report-formats/sarif/features.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -Order: 20 -Title: Features -Description: Features of the Cake.Issues.Reporting.Sarif addin. ---- -The [Cake.Issues.Reporting.Sarif addin] provides the following features: - -* Creates SARIF compatible files. -* Supports the following properties in the SARIF report: - * RuleId - * Message - * Kind - * Level - * Location - * RuleUrl - -[Cake.Issues.Reporting.Sarif addin]: https://www.nuget.org/packages/Cake.Issues.Reporting.Sarif diff --git a/docs/input/docs/report-formats/sarif/index.cshtml b/docs/input/docs/report-formats/sarif/index.cshtml deleted file mode 100644 index 55d163ac7..000000000 --- a/docs/input/docs/report-formats/sarif/index.cshtml +++ /dev/null @@ -1,12 +0,0 @@ ---- -Title: Sarif -Description: Report format to create SARIF compatible reports. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- Support for creating SARIF compatible reports is implemented in the - Cake.Issues.Reporting.Sarif addin. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/report-formats/sarif/requirements.md b/docs/input/docs/report-formats/sarif/requirements.md deleted file mode 100644 index ab7342854..000000000 --- a/docs/input/docs/report-formats/sarif/requirements.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -Order: 10 -Title: Requirements -Description: Requirements for the Cake.Issues.Reporting.Sarif addin. ---- -The requirements for using the [Cake.Issues.Reporting.Sarif addin] are listed in the [release notes] for any specific version. - -[Cake.Issues.Reporting.Sarif addin]: https://www.nuget.org/packages/Cake.Issues.Reporting.Sarif -[release notes]: release-notes \ No newline at end of file diff --git a/docs/input/docs/resources/index.cshtml b/docs/input/docs/resources/index.cshtml deleted file mode 100644 index 030806012..000000000 --- a/docs/input/docs/resources/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Order: 90 -Description: Resources about Cake.Issues. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/usage/creating-issues/index.cshtml b/docs/input/docs/usage/creating-issues/index.cshtml deleted file mode 100644 index 901fac32f..000000000 --- a/docs/input/docs/usage/creating-issues/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Order: 20 -Description: How to create issues using Cake.Issues. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/usage/creating-reports/index.cshtml b/docs/input/docs/usage/creating-reports/index.cshtml deleted file mode 100644 index 7fae8a618..000000000 --- a/docs/input/docs/usage/creating-reports/index.cshtml +++ /dev/null @@ -1,11 +0,0 @@ ---- -Order: 40 -Description: How to create reports using Cake.Issues.Reporting. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- For report format specific examples see Report Format Examples. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/usage/index.cshtml b/docs/input/docs/usage/index.cshtml deleted file mode 100644 index ecdcaa164..000000000 --- a/docs/input/docs/usage/index.cshtml +++ /dev/null @@ -1,7 +0,0 @@ ---- -Order: 30 -Description: How to obtain, configure, and use Cake.Issues. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/usage/reading-issues/index.cshtml b/docs/input/docs/usage/reading-issues/index.cshtml deleted file mode 100644 index 39c8dc63a..000000000 --- a/docs/input/docs/usage/reading-issues/index.cshtml +++ /dev/null @@ -1,11 +0,0 @@ ---- -Order: 30 -Description: How to read issues using Cake.Issues. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- For issue provider specific examples see Issue Provider Examples. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/input/docs/usage/recipe/index.md b/docs/input/docs/usage/recipe/index.md deleted file mode 100644 index db51cae81..000000000 --- a/docs/input/docs/usage/recipe/index.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -Order: 10 -Description: How to use the pre-made recipe script. ---- - -Examples how to use Cake.Issues recipes can be found under [Recipe Usage]. - -[Recipe Usage]: /docs/recipe/usage \ No newline at end of file diff --git a/docs/input/docs/usage/reporting-issues-to-pull-requests/index.cshtml b/docs/input/docs/usage/reporting-issues-to-pull-requests/index.cshtml deleted file mode 100644 index 5e39a0942..000000000 --- a/docs/input/docs/usage/reporting-issues-to-pull-requests/index.cshtml +++ /dev/null @@ -1,11 +0,0 @@ ---- -Order: 50 -Description: How to report issues to pull requests using Cake.Issues.PullRequests. ---- -

@Html.Raw(Model.String(DocsKeys.Description))

- -

- For pull request system specific examples see Pull Request System Examples. -

- -@Html.Partial("_ChildPages") \ No newline at end of file diff --git a/docs/material/overrides/home.html b/docs/material/overrides/home.html new file mode 100644 index 000000000..aef67aa33 --- /dev/null +++ b/docs/material/overrides/home.html @@ -0,0 +1,84 @@ +{% extends "main.html" %} + + +{% block tabs %} + {{ super() }} + + + + + +
+
+
+ + +
+ +
+ + +
+

Technical documentation that just works

+

{{ config.site_description }}. Set up in 5 minutes.

+ + Quick start + + + Get Insiders + +
+
+
+
+{% endblock %} + + +{% block content %}{% endblock %} + + +{% block footer %}{% endblock %} \ No newline at end of file diff --git a/docs/material/overrides/main.html b/docs/material/overrides/main.html new file mode 100644 index 000000000..646ea2e0b --- /dev/null +++ b/docs/material/overrides/main.html @@ -0,0 +1,37 @@ +{% extends "base.html" %} + + +{% block extrahead %} + + + +{% endblock %} + + +{% block announce %} + For updates follow @squidfunk on + + + {% include ".icons/fontawesome/brands/mastodon.svg" %} + + Fosstodon + + and + + + Twitter + +{% endblock %} + + +{% block scripts %} + {{ super() }} + + + +{% endblock %} \ No newline at end of file diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml new file mode 100644 index 000000000..2e252c5cb --- /dev/null +++ b/docs/mkdocs.yml @@ -0,0 +1,249 @@ +# Project information +site_name: Cake Issues +site_url: https://cakeissues.net +site_author: Cake Issues Contributors +site_description: Issue Management for the Cake Build System + +# Repository +repo_name: cake-contrib/Cake.Issues +repo_url: https://github.com/cake-contrib/Cake.Issues + +# Copyright +copyright: Copyright © Cake Issues Contributors + +# Build configuration +# strict: true +validation: + omitted_files: warn + absolute_links: warn + unrecognized_links: warn + anchors: warn +# validation: +# nav: +# omitted_files: warn +# not_found: warn +# absolute_links: warn +# links: +# not_found: warn +# anchors: warn +# absolute_links: warn +# unrecognized_links: warn + +# Theme configuration +theme: + name: material + # custom_dir: material/overrides + language: en + palette: + # Palette toggle for automatic mode + - media: "(prefers-color-scheme)" + toggle: + icon: material/brightness-auto + name: Switch to light mode + # Palette toggle for light mode + - media: "(prefers-color-scheme: light)" + scheme: default + primary: light blue + toggle: + icon: material/brightness-7 + name: Switch to dark mode + # Palette toggle for dark mode + - media: "(prefers-color-scheme: dark)" + scheme: slate + primary: deep purple + toggle: + icon: material/brightness-4 + name: Switch to system preference + features: + - content.action.edit + # - content.action.view + - content.code.copy + # - content.tabs.link + - navigation.indexes + # - navigation.instant + # - navigation.instant.progress + - navigation.tabs + - navigation.tabs.sticky + # - navigation.tracking + # - navigation.sections + # - toc.follow + - search.highlight + - search.suggest + +# Plugins +plugins: + - blog: + post_readtime: true + # - privacy + - search + +# Extensions +markdown_extensions: + - admonition + - attr_list + - md_in_html + - pymdownx.emoji: + emoji_index: !!python/name:material.extensions.emoji.twemoji + emoji_generator: !!python/name:material.extensions.emoji.to_svg + - pymdownx.highlight: + anchor_linenums: true + line_spans: __span + pygments_lang_class: true + - pymdownx.inlinehilite + - pymdownx.snippets + - pymdownx.superfences + - toc: + permalink: true + +# Additional configuration +extra: + social: + - icon: fontawesome/brands/github + link: https://github.com/cake-contrib/Cake.Issues + +# Page tree +nav: + - Home: index.md + - News: + - blog/index.md + - Documentation: + - Overview: + - Introduction: documentation/overview/introduction.md + - Features: documentation/overview/features.md + - Requirements: documentation/overview/requirements.md + - Fundamentals: + - Architecture: documentation/fundamentals/architecture.md + - Versioning: documentation/fundamentals/versioning.md + - Recipe: documentation/fundamentals/recipe.md + - Issue Provider: documentation/fundamentals/issue-provider.md + - Report Format: documentation/fundamentals/report-format.md + - Pull Request System: documentation/fundamentals/pull-request-system.md + - Usage: + - documentation/usage/index.md + - Recipe: documentation/usage/recipe/index.md + - Creating Issues: documentation/usage/creating-issues/creating-issues.md + - Reading Issues: + - documentation/usage/reading-issues/index.md + - Reading Issues: documentation/usage/reading-issues/reading-issues.md + - Additional Run Information: documentation/usage/reading-issues/run-information.md + - File Linking: documentation/usage/reading-issues/file-linking.md + - Creating Reports: + - documentation/usage/creating-reports/index.md + - Creating Reports: documentation/usage/creating-reports/creating-reports.md + - Reporting Issues To Pull Requests: + - documentation/usage/reporting-issues-to-pull-requests/index.md + - Report Issues To Pull Requests: documentation/usage/reporting-issues-to-pull-requests/report-issues-to-pull-requests.md + - Custom Issue Filter: documentation/usage/reporting-issues-to-pull-requests/custom-issue-filter.md + - Recipe: + - Overview: documentation/recipe/overview.md + - Usage: + - documentation/recipe/usage/index.md + - Cake.Issues.Recipe: documentation/recipe/usage/using-cake-issues-recipe.md + - Cake.Frosting.Issues.Recipe: documentation/recipe/usage/using-cake-frosting-issues-recipe.md + - Supported Tools: documentation/recipe/supported-tools.md + - Demos: documentation/recipe/demos.md + - Configuration: documentation/recipe/configuration.md + - Tasks: documentation/recipe/tasks.md + - Issue Providers: + - documentation/issue-providers/index.md + - DocFx: + - documentation/issue-providers/docfx/index.md + - Features: documentation/issue-providers/docfx/features.md + - Examples: documentation/issue-providers/docfx/examples.md + - ESLint: + - documentation/issue-providers/eslint/index.md + - Features: documentation/issue-providers/eslint/features.md + - Git Repository: + - documentation/issue-providers/gitrepository/index.md + - Features: documentation/issue-providers/gitrepository/features.md + - Examples: documentation/issue-providers/gitrepository/examples.md + - Rules: + - BinaryFileNotTrackedByLfs: documentation/issue-providers/gitrepository/rules/BinaryFileNotTrackedByLfs.md + - FilePathTooLong: documentation/issue-providers/gitrepository/rules/FilePathTooLong.md + - InspectCode: + - documentation/issue-providers/inspectcode/index.md + - Features: documentation/issue-providers/inspectcode/features.md + - Examples: documentation/issue-providers/inspectcode/examples.md + - markdownlint: + - documentation/issue-providers/markdownlint/index.md + - Features: documentation/issue-providers/markdownlint/features.md + - Examples: documentation/issue-providers/markdownlint/examples.md + - MsBuild: + - documentation/issue-providers/msbuild/index.md + - Features: documentation/issue-providers/msbuild/features.md + - Examples: documentation/issue-providers/msbuild/examples.md + - Terraform: + - documentation/issue-providers/terraform/index.md + - Features: documentation/issue-providers/terraform/features.md + - Report Formats: + - documentation/report-formats/index.md + - Console: + - documentation/report-formats/console/index.md + - Features: documentation/report-formats/console/features.md + - Examples: documentation/report-formats/console/examples.md + - Generic: + - documentation/report-formats/generic/index.md + - Features: documentation/report-formats/generic/features.md + - Examples: + - Embedded Default Template: documentation/report-formats/generic/examples/default-template.md + - Custom Template: documentation/report-formats/generic/examples/custom-template.md + - Template Gallery: + - HTML DevExtreme Data Grid: documentation/report-formats/generic/templates/htmldxdatagrid.md + - HTML Data Table: documentation/report-formats/generic/templates/htmldatatable.md + - HTML Diagnostic: documentation/report-formats/generic/templates/htmldiagnostic.md + - Sarif: + - documentation/report-formats/sarif/index.md + - Features: documentation/report-formats/sarif/features.md + - Examples: documentation/report-formats/sarif/examples.md + - Pull Request Systems: + - documentation/pull-request-systems/index.md + - AppVeyor: + - documentation/pull-request-systems/appveyor/index.md + - Features: documentation/pull-request-systems/appveyor/features.md + - Examples: + - documentation/pull-request-systems/appveyor/examples/index.md + - Writing Messages To AppVeyor: documentation/pull-request-systems/appveyor/examples/write-messages.md + - GitHub Pull Request Integration: documentation/pull-request-systems/appveyor/examples/github-pullrequest-integration.md + - Azure DevOps: + - documentation/pull-request-systems/azure-devops/index.md + - Features: documentation/pull-request-systems/azure-devops/features.md + - Setup: documentation/pull-request-systems/azure-devops/setup.md + - Examples: + - documentation/pull-request-systems/azure-devops/examples/index.md + - Using With Pull Request ID: documentation/pull-request-systems/azure-devops/examples/pullrequest-id.md + - Using With Repository Remote URL And Source Branch Name: documentation/pull-request-systems/azure-devops/examples/repository-information.md + - Using With Azure Pipelines: documentation/pull-request-systems/azure-devops/examples/azure-pipelines.md + - GitHub Actions: + - documentation/pull-request-systems/github-actions/index.md + - Features: documentation/pull-request-systems/github-actions/features.md + - Examples: + - Create annotations in GitHub Actions: documentation/pull-request-systems/github-actions/examples/write-annotations.md + - Extending: + - documentation/extending/index.md + - Fundamentals: documentation/extending/fundamentals.md + - Issue Provider: + - Overview: documentation/extending/issue-provider/overview.md + - Alias Categories: documentation/extending/issue-provider/categories.md + - Tutorials: + - Simple Issue Provider: documentation/extending/issue-provider/tutorials/simple.md + - Provider Settings: documentation/extending/issue-provider/tutorials/settings.md + - Multiple Log File Formats: documentation/extending/issue-provider/tutorials/logfile-format.md + - Rule URL Resolving: documentation/extending/issue-provider/tutorials/rule-url-resolving.md + - Helper: documentation/extending/issue-provider/helper.md + - Report Format: + - Overview: documentation/extending/report-format/overview.md + - Alias Categories: documentation/extending/report-format/categories.md + - Pull Request System: + - Overview: documentation/extending/pull-request-system/overview.md + - Alias Categories: documentation/extending/pull-request-system/categories.md + - Testing: documentation/extending/testing.md + - Resources: + - Blog Posts: documentation/resources/blog-posts.md + - Presentations: documentation/resources/presentations.md + - Contributing: + - How To Contribute: documentation/contributing/how-to-contribute.md + - Build Instructions: documentation/contributing/how-to-build.md + - Release Instructions: documentation/contributing/how-to-release.md + # - Reference: + # - Addins: + - API: https://cakebuild.net/extensions/cake-issues/ \ No newline at end of file