Update Templates for Docsy and synced them up
This commit is contained in:
parent
70ab70dffa
commit
22bceb1484
4 changed files with 59 additions and 44 deletions
|
|
@ -8,6 +8,7 @@ description: >
|
||||||
# Business Central Best Practices
|
# 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:
|
This section will be cover things that aren't as simple as Design Patterns, but will help make sure your development is:
|
||||||
|
|
||||||
- high-performance
|
- high-performance
|
||||||
- complies with good designs
|
- complies with good designs
|
||||||
- has high maintainability
|
- has high maintainability
|
||||||
|
|
@ -18,4 +19,8 @@ Generally, all readability rules are Microsoft style choices only. You can use t
|
||||||
|
|
||||||
## Performance
|
## Performance
|
||||||
|
|
||||||
Some guidelines are simply better for performance considerations rather than readability or anything else. In this section, let's look into some..
|
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)
|
||||||
|
|
|
||||||
39
content/docs/Contributing/Templates/BestPractice/index.md
Normal file
39
content/docs/Contributing/Templates/BestPractice/index.md
Normal file
|
|
@ -0,0 +1,39 @@
|
||||||
|
---
|
||||||
|
title: "Title Here"
|
||||||
|
tags: []
|
||||||
|
categories: ["Best Practice"]
|
||||||
|
---
|
||||||
|
|
||||||
|
<!-- This is a guideline, some parts are optional (if there's no content, remove the whole paragraph). -->
|
||||||
|
<!-- The "Readability" and "Performance" tags are often used. You can, however, add multiple tags, but please do not change the Category -->
|
||||||
|
|
||||||
|
_Created by <!-- John Smith --><!--, Cronus International.--> Described by <!-- Jane Doe--><!--, Contoso, LLC-->_
|
||||||
|
|
||||||
|
## 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 <!--[here](https://github.com/microsoft/alguidelines/discussions/42) Fix the link -->
|
||||||
|
|
||||||
|
You can find discussions on all "Best Practices" [here](https://github.com/microsoft/alguidelines/discussions/categories/bc-best-practices).
|
||||||
|
|
||||||
|
<!-- 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. -->
|
||||||
|
|
@ -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)
|
|
||||||
|
|
||||||
<Please replace the "TITLEOFYOURGUIDELINEGOESHERE" in the link above, with the Title+of+the+Guideline (indeed, with "space" replaced by a "+") - and remove this line. \>
|
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
@ -1,10 +1,12 @@
|
||||||
+++
|
---
|
||||||
title = "Title of the pattern"
|
title: "Pattern Name"
|
||||||
weight = 1180
|
tags: []
|
||||||
+++
|
categories: ["Pattern"]
|
||||||
This is a guideline, some parts are optional (if there's no content, remove the whole paragraph).
|
---
|
||||||
|
|
||||||
<_Created by (company), Described by (company)_\>
|
<!-- This is a guideline, some parts are optional (if there's no content, remove the whole paragraph). -->
|
||||||
|
|
||||||
|
_Created by <!-- John Smith --><!--, Cronus International.--> Described by <!-- Jane Doe--><!--, Contoso, LLC-->_
|
||||||
|
|
||||||
## Abstract
|
## Abstract
|
||||||
|
|
||||||
|
|
@ -21,6 +23,7 @@ What happens before this pattern is used? How can it go wrong? 1-5 lines.
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
In depth description on what this Pattern is all about
|
In depth description on what this Pattern is all about
|
||||||
|
|
||||||
- basic components
|
- basic components
|
||||||
- how the interact
|
- how the interact
|
||||||
- steps to implement
|
- steps to implement
|
||||||
|
|
@ -44,4 +47,8 @@ Youtube-link? BaseApp? Tweet? ...
|
||||||
|
|
||||||
## Discussions
|
## 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.
|
Please discuss this guideline <!--[here](https://github.com/microsoft/alguidelines/discussions/42) Fix the link -->
|
||||||
|
|
||||||
|
You can find discussions on all "Best Practices" [here](https://github.com/microsoft/alguidelines/discussions/categories/bc-patterns).
|
||||||
|
|
||||||
|
<!-- 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. -->
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue