docs: updates to use DML and other changes (#7834)

- Change existing data model guides and add new ones for DML
- Change module's docs around service factory + remove guides that are now necessary
- Hide/remove all mentions of module relationships, or label them as coming soon.
- Change all data model creation snippets to use DML
- use `property` instead of `field` when referring to a data model's properties.
- Fix all snippets in commerce module guides to use new method suffix (no more main model methods)
- Rework recipes, removing/hiding a lot of sections as a lot of recipes are incomplete with the current state of DML.


### Other changes

- Highlight fixes in some guides
- Remove feature flags guide
- Fix code block styles when there are no line numbers.

### Upcoming changes in other PRs

- Re-generate commerce module references (for the updates in the method names)
- Ensure that the data model references are generated correctly for models using DML.
- (probably at a very later point) revisit recipes
This commit is contained in:
Shahed Nasser
2024-06-26 07:55:59 +00:00
committed by GitHub
parent 62dacdda75
commit 0462cc5acf
126 changed files with 1808 additions and 14242 deletions
@@ -16,17 +16,17 @@ A payment collection can have multiple payment sessions. For example, during che
---
## data field
## data Property
Payment providers may need additional data to process the payment later. The `PaymentSession` data model has a `data` field used to store that data.
Payment providers may need additional data to process the payment later. The `PaymentSession` data model has a `data` property used to store that data.
For example, the customer's ID in Stripe is stored in the `data` field.
For example, the customer's ID in Stripe is stored in the `data` property.
---
## Payment Session Status
The `status` field of a payment session indicates its current status. Its value can be:
The `status` property of a payment session indicates its current status. Its value can be:
- `pending`: The payment session is awaiting authorization.
- `requires_more`: The payment session requires an action before its authorized. For example, to enter a 3DS code.
@@ -14,7 +14,7 @@ A payment carries along many of the data and relations of a payment session:
- It belongs to the same payment collection.
- Its associated with the same payment provider, which handles further payment processing.
- It stores the payment sessions `data` field in its `data` field, as its still useful for the payment providers processing.
- It stores the payment sessions `data` property in its `data` property, as its still useful for the payment providers processing.
---