diff --git a/content/docs/BestPractices/_index.md b/content/docs/BestPractices/_index.md index 174f7d91..698e2846 100644 --- a/content/docs/BestPractices/_index.md +++ b/content/docs/BestPractices/_index.md @@ -8,6 +8,7 @@ description: > # Business Central Best Practices This section will be cover things that aren't as simple as Design Patterns, but will help make sure your development is: + - high-performance - complies with good designs - has high maintainability @@ -18,4 +19,8 @@ Generally, all readability rules are Microsoft style choices only. You can use t ## Performance -Some guidelines are simply better for performance considerations rather than readability or anything else. In this section, let's look into some.. \ No newline at end of file +Some guidelines are simply better for performance considerations rather than readability or anything else. In this section, let's look into some.. + +## Discussion + +All discussion related to Best Practice are to be found on the Github Repo's Discussion pages, found [here](https://github.com/microsoft/alguidelines/discussions/categories/bc-best-practices) diff --git a/content/docs/Contributing/Templates/BestPractice/index.md b/content/docs/Contributing/Templates/BestPractice/index.md new file mode 100644 index 00000000..dbb9e0d3 --- /dev/null +++ b/content/docs/Contributing/Templates/BestPractice/index.md @@ -0,0 +1,39 @@ +--- +title: "Title Here" +tags: [] +categories: ["Best Practice"] +--- + + + + +_Created by Described by _ + +## Description + +In depth description on what this Pattern is all about + +- basic components +- how the interact +- steps to implement +- considerations to take + +## Bad code + +```al +PutCodeblocksHere() +``` + +## Good code + +```al +PutCodeblocksHere() +``` + +## Discussions + +Please discuss this guideline + +You can find discussions on all "Best Practices" [here](https://github.com/microsoft/alguidelines/discussions/categories/bc-best-practices). + + \ No newline at end of file diff --git a/content/docs/Contributing/Templates/Guidelines/index.md b/content/docs/Contributing/Templates/Guidelines/index.md deleted file mode 100644 index da408a49..00000000 --- a/content/docs/Contributing/Templates/Guidelines/index.md +++ /dev/null @@ -1,36 +0,0 @@ -+++ -title = "Title of the Guideline" -weight = 1180 -+++ -This is a guideline, some parts are optional (if there's no content, remove the whole paragraph). - -<_Created by (company), Described by (company)_\> - -## Description - -In depth description on what this Pattern is all about -- basic components -- how the interact -- steps to implement -- considerations to take - - -## Bad code - -```al -PutCodeblocksHere() -``` - -## Good code - -```al -PutCodeblocksHere() -``` - -## [Discussions](https://github.com/microsoft/alguidelines/discussions/categories/bc-best-practices?discussions_q=TITLEOFYOURGUIDELINEGOESHERE+category%3A%22BC+Best+Practices%22) - - - -You can find discussions on all "Best Practices" [here](https://github.com/microsoft/alguidelines/discussions/categories/bc-best-practices). - -If you don't find the discussion of this guideline, please feel free to create a new one with the same title as this article. \ No newline at end of file diff --git a/content/docs/Contributing/Templates/Patterns/index.md b/content/docs/Contributing/Templates/Patterns/index.md index f42c7dc1..031973e1 100644 --- a/content/docs/Contributing/Templates/Patterns/index.md +++ b/content/docs/Contributing/Templates/Patterns/index.md @@ -1,10 +1,12 @@ -+++ -title = "Title of the pattern" -weight = 1180 -+++ -This is a guideline, some parts are optional (if there's no content, remove the whole paragraph). +--- +title: "Pattern Name" +tags: [] +categories: ["Pattern"] +--- -<_Created by (company), Described by (company)_\> + + +_Created by Described by _ ## Abstract @@ -21,6 +23,7 @@ What happens before this pattern is used? How can it go wrong? 1-5 lines. ## Description In depth description on what this Pattern is all about + - basic components - how the interact - steps to implement @@ -44,4 +47,8 @@ Youtube-link? BaseApp? Tweet? ... ## Discussions -Create a discussions-page of your pattern, and add the sentence "You can discuss this pattern [here](https://github.com/microsoft/alguidelines/discussions/42)" with the right link to that discussions-page. \ No newline at end of file +Please discuss this guideline + +You can find discussions on all "Best Practices" [here](https://github.com/microsoft/alguidelines/discussions/categories/bc-patterns). + +