Markdownlint: more rules vol. 1

.markdownlint-cli2.yaml

@@ -14,6 +14,35 @@ config:
   table-pipe-style:
     style: leading_and_trailing
 
+# table-column-count: true
+  blanks-around-tables: true
+  descriptive-link-text: true
+# table-column-style: aligned
+# link-fragments: true
+# no-alt-text: true
+  single-trailing-newline: true
+# no-emphasis-as-heading: true
+  no-space-in-code: true
+  no-space-in-links: true
+  fenced-code-language: true
+# first-line-heading: true
+# ol-prefix: one_or_ordered
+# list-marker-space: true
+# blanks-around-fences: true
+# blanks-around-lists: true
+# single-title: true
+# no-trailing-punctuation:
+#   punctuation: [".", ":", ";",]
+# no-multiple-space-atx: true
+# blanks-around-headings: true
+# heading-increment: true
+# ul-style: dash
+# ul-indent:
+#   indent: 4
+# no-trailing-spaces: true
+# no-multiple-blanks: true
+# commands-show-output: true
+
 ignores:
   - "docs/snippets/**"
   - "docs/index.md"

docs/administration/admin_panel/roles_admin_panel.md

@@ -41,4 +41,4 @@ That way system is be more secure and easier to manage.
 This approach also improves performance.
 Role assignments and policies are taken into account during search/load queries.
 
-For more information, see [Permissions overview](permissions.md) and [Permission use cases](permission_use_cases.md).
+For more information, see [Permissions overview](permissions.md) and [Permission use cases](permission_use_cases.md).

docs/administration/admin_panel/segments_admin_panel.md

@@ -16,4 +16,4 @@ Each segment group can contain segments that you can target content for.
 
 ![Segment](admin_panel_segment.png)
 
-You can assign users to segments [through the API](segment_api.md#assigning-users).
+You can assign users to segments [through the API](segment_api.md#assigning-users).

docs/administration/admin_panel/url_management_admin_panel.md

@@ -9,4 +9,4 @@ Configure URL aliases to have human-readable URL addresses throughout your syste
 
 For more information, see [URL management](url_management.md).
 
-![URL Management](admin_panel_url_management.png "URL Management")
+![URL Management](admin_panel_url_management.png "URL Management")

docs/administration/admin_panel/workflow_admin_panel.md

@@ -9,4 +9,4 @@ Each workflow consists of stages and transitions between them.
 
 For more information, see [Workflow](workflow.md).
 
-![Workflow](admin_panel_workflow.png "Workflow")
+![Workflow](admin_panel_workflow.png "Workflow")

docs/administration/back_office/content_tree.md

@@ -38,4 +38,4 @@ ibexa:
                    - 2 # Home (Content structure)
                    - 5 # Users
                    - 43 # Media
-```
+```

docs/administration/content_organization/object_states.md

@@ -20,4 +20,4 @@ By default, [[= product_name =]] contains one object state group: **Lock**, with
 ![**Lock** Object state](object_state_lock.png "Lock object state")
 
 Object states can be used in conjunction with [permissions](permission_overview.md), in particular with the [object state limitation](limitation_reference.md#object-state-limitation).
-Their specific use cases depend on your needs and the setup of your permission system.
+Their specific use cases depend on your needs and the setup of your permission system.

docs/administration/content_organization/sections.md

@@ -39,4 +39,4 @@ If a section is removed, its ID number cannot be reused when a new section is cr
 
 Registration form for your website is placed under this address: <yourdomain>/register.
 By default, new users created in this way are placed in the Guest accounts group.
-To give your users a possibility to register themselves, follow the instructions on [enabling account registration](8_enable_account_registration.md).
+To give your users a possibility to register themselves, follow the instructions on [enabling account registration](8_enable_account_registration.md).

docs/api/event_reference/discounts_events.md

@@ -47,7 +47,7 @@ The following events are dispatched when rendering each step of the discount wiz
 |[`CreateFormDataEvent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-Step-CreateFormDataEvent.html)| `ibexa.discounts.form_mapper.<step_identifier>.create_form_data`|
 |[`MapCreateDataToStructEvent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-Step-MapCreateDataToStructEvent.html)|`ibexa.discounts.form_mapper.<step_identifier>.map_create_data_to_struct`|
 |[`MapDiscountToFormDataEvent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-Step-MapDiscountToFormDataEvent.html)| `ibexa.discounts.form_mapper.<step_identifier>.map_discount_to_form_data`|
-|[`MapUpdateDataToStructEvent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-Step-MapUpdateDataToStructEvent.html)|`ibexa.discounts.form_mapper.<step_identifier>.map_update_data_to_struct `|
+|[`MapUpdateDataToStructEvent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-Step-MapUpdateDataToStructEvent.html)|`ibexa.discounts.form_mapper.<step_identifier>.map_update_data_to_struct`|
 
 The event classes are shared between steps, but they are dispatched with different names.
 Each step form mapper dispatches its own set of events.

docs/api/event_reference/order_management_events.md

@@ -5,6 +5,7 @@ page_type: reference
 ---
 
 # Order management events
+
 | Event | Dispatched by | Properties |
 |---|---|---|
 |`BeforeCreateOrderEvent`|`OrderService::createOrder`|`OrderCreateStruct $createStruct`<br/>`?OrderInterface $orderResult = null`|

docs/api/graphql/graphql_custom_ft.md

@@ -172,4 +172,4 @@
 - `location` is the content item's resolved location. For more information, see [Querying Locations](graphql_queries.md#querying-locations)
 - `item` is the content together with its location `\Ibexa\GraphQL\Value\Item`
 
-`RelationFieldValueBuilder` or `SelectionFieldValueBuilder` can be used as examples.
+`RelationFieldValueBuilder` or `SelectionFieldValueBuilder` can be used as examples.

docs/cdp/cdp_activation/cdp_activation.md

@@ -14,4 +14,4 @@ Activation includes configuration, data export and adding Client-side Tracking.
     "cdp/cdp_activation/cdp_configuration",
     "cdp/cdp_activation/cdp_data_export",
     "cdp/cdp_activation/cdp_add_clientside_tracking",
-], columns=3) =]]
+], columns=3) =]]

docs/cdp/cdp_activation/cdp_add_clientside_tracking.md

@@ -32,4 +32,4 @@ Add the user ID information by using below script:
 raptor.push("setRuid","USER_ID_HERE")
 ```
 
-For more information on tracking events, see [the documentation](https://content.raptorservices.com/help-center/tracking-events-for-recommendation).
+For more information on tracking events, see [the documentation](https://content.raptorservices.com/help-center/tracking-events-for-recommendation).

docs/commerce/checkout/checkout.md

@@ -56,4 +56,4 @@ Next, the user is moved to cart where the system validates the order against exi
 If everything is available, customer can move to payment and summary.
 The system uses information from the past order to pre-fill address, shipping method, and payment details.
 
-For more information, see [reorder documentation](reorder.md).
+For more information, see [reorder documentation](reorder.md).

docs/commerce/checkout/configure_checkout.md

@@ -58,4 +58,4 @@ They fall back to `billing` and `shipping` predefined formats by default:
 - `billing` is part of the `ibexa/corporate-accounts` repository
 - `shipping` is part of the `ibexa/checkout` bundle's default configuration
 
-To modify address formats you create custom ones.
+To modify address formats you create custom ones.

docs/commerce/storefront/storefront.md

@@ -42,4 +42,4 @@ To become familiar with a complete set of templates that covering all functional
 
     For more information about overriding the default checkout component, see [Customize checkout](../checkout/customize_checkout.md).
 
-    For information about roles and permissions that control access to various components of the purchase process, see [Permission use cases](permission_use_cases.md#commerce).
+    For information about roles and permissions that control access to various components of the purchase process, see [Permission use cases](permission_use_cases.md#commerce).

docs/commerce/transactional_emails/extend_transactional_emails.md

@@ -164,4 +164,4 @@ final class ResolveCampaginEventSubscriber implements EventSubscriberInterface
         $event->setCampaign($campaign);
     }
 }
-```
+```

docs/content_management/field_types/field_type_reference/authorfield.md

@@ -14,7 +14,7 @@ This field type allows the storage and retrieval of one or more authors. For eac
 
 | Attribute | Type                                     | Description      | Example   |
 |-----------|------------------------------------------|------------------|-----------|
-| `authors` | `\Ibexa\Core\FieldType\Author\Author[] ` | List of authors. | See below |
+| `authors` | `\Ibexa\Core\FieldType\Author\Author[]` | List of authors. | See below |
 
 Example:
 

docs/content_management/pages/ibexa_connect_scenario_block.md

@@ -66,4 +66,4 @@ To do it, extend drop-down list in the **View** field and choose one of the avai
 Click **Submit** button to confirm.
 After submitting the block, page refreshes and [[= product_name_connect =]] block displays data from provided [[= product_name_connect =]] webhook.
 
-![Ibexa Connect webhook preview](ibexa_connect_webhook_preview.png)
+![Ibexa Connect webhook preview](ibexa_connect_webhook_preview.png)

docs/content_management/pages/react_app_block.md

@@ -101,4 +101,4 @@ Then, make sure that your [Page layout template](template_configuration.md#page-
 {% if encore_entry_exists('react-blocks-js') %}
     {{ encore_entry_script_tags('react-blocks-js') }}
 {% endif %}
-```
+```

docs/content_management/rich_text/extend_online_editor.md

@@ -386,7 +386,7 @@ For a full list of standard buttons, see the RichText module's [configuration fi
 Regular CKEditor plugins can be added to the Online Editor.
 This procedure is illustrated with the addition of the [Special characters plugin](https://ckeditor.com/docs/ckeditor5/latest/features/special-characters.html).
 
-You can install a CKEditor plugin locally by using `yarn add ` or `npm install`, and deploy it by committing the `yarn.lock` file.
+You can install a CKEditor plugin locally by using `yarn add` or `npm install`, and deploy it by committing the `yarn.lock` file.
 A local installation looks like:
 
 ```bash

docs/content_management/rich_text/rich_text.md

@@ -11,4 +11,4 @@ RichText is a type of field that you add in any content item in [[= product_name
     "content_management/rich_text/online_editor_guide",
     "content_management/rich_text/extend_online_editor",
     "content_management/rich_text/create_custom_richtext_block",
-], columns=3) =]]
+], columns=3) =]]

docs/content_management/workflow/workflow.md

@@ -165,7 +165,7 @@
 Therefore, if there are any errors in the form, you return to the edit page but errors aren't triggered, which can be confusing when you have two or more tabs.
 
 To enable form validation in UI before sending it to the next stage of the workflow, add `validate: true` to the transitions of the stage.
-In the example below the form is validated in two stages:` to_legal` and `done`:
+In the example below the form is validated in two stages: `to_legal` and `done`:
 
 ``` yaml hl_lines="15 28"
 [[= include_file('code_samples/workflow/custom_workflow/config/packages/workflows.yaml', 23, 43) =]][[= include_file('code_samples/workflow/custom_workflow/config/packages/workflows.yaml', 55, 63) =]]

docs/customer_management/cp_configuration.md

@@ -88,4 +88,4 @@ ibexa:
 Reviewing pending and past orders in Customer Portal requires that you configure all currencies that any of the customers may use under the `ibexa.system.<siteaccess_name>.product_catalog.currencies` key.
 The first currency from the list is then used for filtering the orders list and calculating the **Average order** and **Total amount** values.
 
-For more information, see [Enable purchasing products](enable_purchasing_products.md).
+For more information, see [Enable purchasing products](enable_purchasing_products.md).

docs/customer_management/customer_portal.md

@@ -19,4 +19,4 @@ With this feature, your customers can self-register, edit their organization inf
     "users/invitations",
     "customer_management/cp_page_builder",
     "customer_management/create_user_registration_form",
-], columns=3) =]]
+], columns=3) =]]

docs/ibexa_engage/create_campaign.md

@@ -46,4 +46,4 @@ To do it, select units, and provide width and height values in the proper fields
 If size fields are blank, the system sets default template values.
 It's recommended to adjust them for better results.
 
-![Campaign custom tag](campaign_custom_tag.png "Campaign custom tag")
+![Campaign custom tag](campaign_custom_tag.png "Campaign custom tag")

docs/ibexa_products/ibexa_experience.md

@@ -64,7 +64,7 @@ Additionally, you can monitor and manage the information obtained from website v
 
 #### Site Factory
 
-[Site Factory ](site_factory.md) is a site management interface, integrated with the back office.
+[Site Factory](site_factory.md) is a site management interface, integrated with the back office.
 It enables you to configure new sites without leaving the administration interface and editing SiteAccess configuration.
 With this feature you can create and deploy multiple websites at lightning speed and at scale.
 It allows you to manage expenses and resources while industrializing your web presence.

docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md

@@ -149,7 +149,7 @@ If the Varnish server is protected by Basic Auth, specify the Basic Auth credent
 Varnish is enabled by default when using [[= product_name_cloud =]] and the `purge_servers` setting is set automatically. 
 To enable Basic Auth on [[= product_name_cloud =]] when using Varnish, specify the credentials using the following environment variables to make sure that Varnish is reachable:
 
-```
+``` bash
 env:HTTPCACHE_USERNAME=myuser
 env:HTTPCACHE_PASSWORD=mypasswd
 ```

docs/personalization/tracking_with_ibexa-tracker.md

@@ -26,7 +26,7 @@
 - `<USER_ID>` with an empty string for cookie based anonymous user or with the value generated by your user identifier system for logged-in user. In case user activity should not be tracked, 'not_defined' value should be used to still have an event stored without a link to the user.
 
 All identifiers can be any form of string.
-Paste this snippet into your website template page so that it appears before the closing `</head>` tag.
+Paste this snippet into your website template page so that it appears before the closing `</head>` tag.
 
 ``` js
 <script type="text/javascript">
@@ -48,9 +48,9 @@
 
 ## Asynchronous syntax
 
-The `_ycq` object is what makes the asynchronous syntax possible.
-It acts as a queue, which is a "first-in, first-out" (FIFO) data structure that collects API calls until `ibexa-tracker.js` is ready to run them.
-To add to the queue, use the `_ycq.push` method.
+The `_ycq` object is what makes the asynchronous syntax possible.
+It acts as a queue, which is a "first-in, first-out" (FIFO) data structure that collects API calls until `ibexa-tracker.js` is ready to run them.
+To add to the queue, use the `_ycq.push` method.
 
 To push an API call into the queue, you must convert it from the traditional JavaScript syntax to a command array.
 Command arrays are JavaScript arrays that conform to a certain format.
@@ -60,7 +60,7 @@
 
 ## Tracking code
 
-The `_ycq` global object can be used directly for asynchronous page tracking with the `push(...)` method. 
+The `_ycq` global object can be used directly for asynchronous page tracking with the `push(...)` method. 
 
 ### `_ycq` object methods
 
@@ -84,9 +84,9 @@
 
 | Object          | Description   | Example |
 | --------------- | ------------- | ------ |
-| `_setMandator ` | - Executed with one additional parameter: `MandatorId` | `_ycq.push (['_setMandator' , '<YOUR_MANDATOR_ID>']);` |
+| `_setMandator` | - Executed with one additional parameter: `MandatorId` | `_ycq.push(['_setMandator' , '<YOUR_MANDATOR_ID>']);` |
 | `_trackEvent` | - Executed with four additional parameters: `ItemType`, `EventType`, `ItemId`, `UserId`.<br /> - `EventType` can be any of the [described types]([[= user_doc =]]/personalization/event_types/) | capturing an event: `_ycq.push(['_trackEvent', '1', 'buy', '10', '']);` |
-| `_trackTimedEvent` | - Executed with five additional parameters: `ItemType`, `EventType`, `ItemId`, `Timeout`, `UserId`.<br /> - `EventType` can be any of the [described types]([[= user_doc =]]/personalization/event_types/).<br /> - `Timeout` can be any integer greater than 0 representing time in ms | consume event sent after 20s: `_ycq.push(['_trackTimedEvent', '1', 'consume', '10', '20000', '']);` |
+| `_trackTimedEvent` | - Executed with five additional parameters:`ItemType`, `EventType`, `ItemId`, `Timeout`, `UserId`.<br /> - `EventType` can be any of the [described types]([[= user_doc =]]/personalization/event_types/).<br /> - `Timeout` can be any integer greater than 0 representing time in ms | consume event sent after 20s: `_ycq.push(['_trackTimedEvent', '1', 'consume', '10', '20000', '']);` |
 | `_login` | - Executed with two additional parameters: anonymous userId, pseudonymous userId.<br /> - It is to be triggered when a user logs in and the tracking identity is changed.<br /> | - |
 | `ycreco=true` | - If you want to send a click recommended event you can append the following parameter to the recommended item URLs: | [https://mydomain.com/mypage.html?ycreco=true](https://mydomain.com/mypage.html?ycreco=true) or <br />[https://mydomain.com/mypage.html?myparameter=x&ycreco=true](https://mydomain.com/mypage.html?myparameter=x&ycreco=true) |
 
@@ -99,4 +99,4 @@
 <button onclick = "_ycq.push(['_trackEvent', '2', 'click', 'itemId1', ''])"/><button>
 ```
 
-Even if this button is clicked before the browser has finished loading `ibexa-tracker.js`, the event is captured and eventually executed.
+Even if this button is clicked before the browser has finished loading `ibexa-tracker.js`, the event is captured and eventually executed.

docs/product_catalog/create_custom_name_schema_strategy.md

@@ -25,4 +25,4 @@ Next, you need to register the strategy in the dependency injection container:
 [[= include_file('code_samples/catalog/percent_name_schema_strategy/src/bundle/Resources/config/services/name_schema.yaml') =]]
 ```
 
-This ensures that the custom name schema strategy is available for use in generating URL aliases based on attribute values.
+This ensures that the custom name schema strategy is available for use in generating URL aliases based on attribute values.

docs/product_catalog/enable_purchasing_products.md

@@ -112,4 +112,4 @@ ibexa:
 You can then assign VAT rates that apply to every product type in each of the supported regions.
 To do it, in the back office, [open the product type for editing]([[= user_doc =]]/pim/create_product_types/#vat), and navigate to the **VAT rates** area.
 
-![Assigning VAT rates to a product type](catalog_vat_rates.png "Assigning VAT rates to a product type")
+![Assigning VAT rates to a product type](catalog_vat_rates.png "Assigning VAT rates to a product type")

docs/release_notes/ez_platform_v1.10.0.md

@@ -91,7 +91,7 @@
 ### eZ Platform Enterprise Edition - Studio Demo
 
 -   [NovaeZSEOBundle](https://github.com/Novactive/NovaeZSEOBundle/) is now included in Studio Demo. NovaeZSEOBundle includes a new field type that lets you manage your SEO strategy in very advanced and powerful ways.
--   We also improved the way we provide personalization in the site using a profiling block and letting the end user manage their preferences by themselves. In this new version, the end user, once logged on the site, can access a page where they can define their content preferences. See [here](https://ez.no/Blog/Personalization-Does-Not-Have-to-Be-that-Complex) for more information.
+-   We also improved the way we provide personalization in the site using a profiling block and letting the end user manage their preferences by themselves. In this new version, the end user, once logged on the site, can access a page where they can define their content preferences.
 
 ## Full list of new features, improvements and bug fixes since v1.9.0