Lint Markdown

Author: dunglas

.github/workflows/cd.yml

@@ -5,7 +5,6 @@ on:
     branches:
     - main
     - '*.*'
-    - ci/github-actions
 
 jobs:
   deploy:

.github/workflows/ci.yml

@@ -19,7 +19,9 @@ jobs:
         uses: github/super-linter@v3
         env:
           VALIDATE_ALL_CODEBASE: false
-          DEFAULT_BRANCH: main
+          VALIDATE_EDITORCONFIG: false
+          VALIDATE_JSCPD: false
+          DEFAULT_BRANCH: 2.6
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - uses: actions/cache@v2

.markdownlint.yml

@@ -0,0 +1,3 @@
+line_length: false
+no-inline-html:
+  allowed_elements: [a, p, img, br]

admin/components.md

@@ -30,7 +30,8 @@ const App = () => (
 export default App;
 ```
 
-**Props**
+#### Props
+
 | Name              | Type               | Value          | required | Description                                                                      |
 |-------------------|--------------------|----------------|----------|----------------------------------------------------------------------------------|
 | dataProvider      | object or function | -              | yes      | communicates with your API                                                       |
@@ -66,7 +67,8 @@ const App = () => (
 export default App;
 ```
 
-**Props**
+#### ResourceGuesser Props
+
 | Name | Type   | Value | required | Description              |
 |------|--------|-------|----------|--------------------------|
 | name | string | -     | yes      | endpoint of the resource |
@@ -96,14 +98,15 @@ export const BooksList = props => (
   </ListGuesser>
 );
 ```
-**Props**
+
+#### ListGuesser Props
+
 | Name     | Type             | Value | required | Description                             |
 |----------|------------------|-------|----------|-----------------------------------------|
 | children | node or function | -     | no       | -                                       |
 | resource | string           | -     | yes      | endpoint of the resource                |
 | filters  | element          | -     | no       | filters that can be applied to the list |
 
-
 You can also use props accepted by React-Admin's [`<List>`](https://marmelab.com/react-admin/List.html).
 
 ### CreateGuesser
@@ -126,7 +129,8 @@ export const BooksCreate = props => (
 );
 ```
 
-**Props**
+#### CreateGuesser Props
+
 | Name | Type | Value | required | Description |
 | Name     | Type             | Value | required | Description              |
 |----------|------------------|-------|----------|--------------------------|
@@ -155,7 +159,8 @@ export const BooksEdit = props => (
 );
 ```
 
-**Props**
+#### EditGuesser Props
+
 | Name     | Type             | Value | required | Description              |
 |----------|------------------|-------|----------|--------------------------|
 | children | node or function | -     | no       | -                        |
@@ -182,7 +187,8 @@ export const BooksShow = props => (
 );
 ```
 
-**Props**
+#### ShowGuesser Props
+
 | Name     | Type             | Value | required | Description              |
 |----------|------------------|-------|----------|--------------------------|
 | children | node or function | -     | no       | -                        |
@@ -214,7 +220,8 @@ const App = () => (
 export default App;
 ```
 
-**Props**
+#### HydraAdmin Props
+
 | Name       | Type   | Value | required | Description           |
 |------------|--------|-------|----------|-----------------------|
 | entrypoint | string | -     | yes      | entrypoint of the API |
@@ -252,7 +259,9 @@ export const BooksShow = props => (
   </ShowGuesser>
 )
 ```
-**Props**
+
+#### FieldGuesser Props
+
 | Name   | Type   | Value | required | Description              |
 |--------|--------|-------|----------|--------------------------|
 | source | string | -     | yes      | endpoint of the resource |
@@ -263,7 +272,8 @@ You can also use props accepted by React-Admin's [`Basic Fields`](https://marmel
 
 Uses React-Admin's [`<ReferenceInput>`](https://marmelab.com/react-admin/Inputs.html#referenceinput) to generate inputs according to your API documentation (e.g. number HTML input for numbers, checkbox for booleans, selectbox for relationships...)
 
-**Props**
+#### InputGuesser Props
+
 | Name   | Type   | Value | required | Description              |
 |--------|--------|-------|----------|--------------------------|
 | source | string | -     | yes      | endpoint of the resource |

admin/customizing.md

@@ -185,4 +185,4 @@ For instance, using an autocomplete input is straightforward, [checkout the dedi
 API Platform is built on top of [React Admin](https://marmelab.com/react-admin/).
 You can use all the features provided by the underlying library with API Platform Admin, including support for [file upload](https://marmelab.com/react-admin/DataProviders.html#decorating-your-data-provider-example-of-file-upload), [authentication](https://marmelab.com/react-admin/Authentication.html), [authorization](https://marmelab.com/react-admin/Authorization.html) and deeper customization.
 
-To learn more about these capabilities, refer to [the React Admin documentation](https://marmelab.com/react-admin/). 
+To learn more about these capabilities, refer to [the React Admin documentation](https://marmelab.com/react-admin/).

admin/getting-started.md

@@ -8,15 +8,21 @@ Otherwise, all you need to install API Platform Admin is a JavaScript package ma
 
 If you don't have an existing React Application, create one using [Create React App](https://create-react-app.dev/):
 
-    $ yarn create react-app my-admin
+```console
+yarn create react-app my-admin
+```
 
 Go to the directory of your project:
 
-    $ cd my-admin
+```console
+cd my-admin
+```
 
 Finally, install the `@api-platform/admin` library:
 
-    $ yarn add @api-platform/admin
+```console
+yarn add @api-platform/admin
+```
 
 ## Creating the Admin
 
@@ -59,7 +65,10 @@ nelmio_cors:
 
 Clear the cache to apply this change:
 
-    $ docker-compose exec php bin/console cache:clear --env=prod
+```console
+docker-compose exec php \
+    bin/console cache:clear --env=prod
+```
 
 Your new administration interface is ready! Type `yarn start` to try it!
 

admin/index.md

@@ -6,7 +6,7 @@ API Platform Admin is a tool to automatically create a beautiful and fully featu
 for any API supporting [the Hydra Core Vocabulary](http://www.hydra-cg.com/) or other API specification formats supported by [`@api-platform/api-doc-parser`](https://github.com/api-platform/api-doc-parser) (experimental support for [OpenAPI](https://www.openapis.org/) is also available).
 
 API Platform Admin is the perfect companion of APIs created
-using [the API Platform framework](https://api-platform.com), but also supports APIs written with any other programming language or framework as long as they expose a standard Hydra API documentation. 
+using [the API Platform framework](https://api-platform.com), but also supports APIs written with any other programming language or framework as long as they expose a standard Hydra API documentation.
 
 API Platform Admin is a 100% standalone Single-Page-Application with no coupling to the server part,
 according to the API-first paradigm.
@@ -21,7 +21,7 @@ You can  **customize everything** by using provided React Admin and [Material UI
 * Automatically generates an admin interface for all the resources of the API thanks to hypermedia features of Hydra
 * Generates 'list', 'create', 'show', and 'edit' screens, as well as a delete button
 * Generates suitable inputs and fields according to the API doc (e.g. number HTML input for numbers, checkbox for booleans, selectbox for relationships...)
-* Generates suitable inputs and fields according to Schema.org types if available (e.g. email field for http://schema.org/email)
+* Generates suitable inputs and fields according to Schema.org types if available (e.g. email field for `http://schema.org/email`)
 * Handles relationships
 * Supports pagination
 * Supports filters and ordering

client-generator/index.md

@@ -4,7 +4,7 @@ Client Generator is the fastest way to scaffold fully featured webapps and nativ
 
 ![Screencast](images/client-generator-demo.gif)
 
-*Generated React and React Native apps, updated in real time* 
+## Generated React and React Native Apps, Updated in Real Time
 
 It is able to generate apps using the following frontend stacks:
 

client-generator/nextjs.md

@@ -18,11 +18,11 @@ Create a [Next.js application with express server](https://github.com/zeit/next.
 
 Enable TypeScript in your next project
 
-    $ yarn add --dev typescript @types/react @types/node
+    yarn add --dev typescript @types/react @types/node
 
 Install required dependencies:
 
-    $ yarn add lodash.get lodash.has @types/lodash isomorphic-unfetch formik
+    yarn add lodash.get lodash.has @types/lodash isomorphic-unfetch formik
 
 ## Generating Routes
 
@@ -35,7 +35,7 @@ Install required dependencies:
 
 You can launch the server with
 
-    $ yarn dev
+    yarn dev
 
 Go to `http://localhost:3000/books/` to start using your app.
 

client-generator/nuxtjs.md

@@ -8,13 +8,19 @@ The Nuxt.js Client Generator generates components for Server Side Rendered appli
 
 Create a [Nuxt.js application](https://nuxtjs.org/guides/get-started/installation#using-create-nuxt-app). The easiest way is to execute:  
 
-    $ npx create-nuxt-app your-app-name
-    # or
-    $ yarn create nuxt-app your-app-name
+```console
+npx create-nuxt-app your-app-name
+```
 
-It will ask you some questions you can use these answers :
+or:
 
+```console
+yarn create nuxt-app your-app-name
 ```
+
+It will ask you some questions you can use these answers :
+
+```console
 Project name: your-app-name
 Programming language: JavaScript
 Package manager: Yarn
@@ -30,8 +36,10 @@ Deployment target: Static (Static/JAMStack hosting)
 
 Install required dependencies:
 
-    $ yarn add moment lodash vue-i18n vuelidate vuex-map-fields nuxt-i18n
-    # yarn add --dev @nuxtjs/vuetify @nuxtjs/fontawesome
+```console
+yarn add moment lodash vue-i18n vuelidate vuex-map-fields nuxt-i18n
+yarn add --dev @nuxtjs/vuetify @nuxtjs/fontawesome
+```
 
 ## Updating nuxtjs config
 
@@ -48,19 +56,22 @@ Update your `nuxt.config.js` with following:
   // to avoid name conflicts in generators
   components: false,  
 ```
+
 ## Generating Routes
 
-    $ npx @api-platform/client-generator https://demo.api-platform.com . --generator nuxt
-    # Replace the URL by the entrypoint of your Hydra-enabled API
+```console
+npx @api-platform/client-generator https://demo.api-platform.com . --generator nuxt
+```
 
-> Note: Omit the resource flag to generate files for all resource types exposed by the API.
+Replace the URL by the entrypoint of your Hydra-enabled API
 
-## Updating default layout
+**Note:** Omit the resource flag to generate files for all resource types exposed by the API.
 
+## Updating default layout
 
 Update your `layouts/default.vue` with following:
 
-```javascript
+```vue
 <template>
   <v-app>
     <alert />
@@ -132,9 +143,11 @@ export default {
 
 ## Starting the Project
 
-You can launch the server with 
+You can launch the server with:
 
-    $ yarn dev
+```console
+yarn dev
+````
 
 Go to `https://localhost:3000/books/` to start using your app.
 

client-generator/quasar.md

@@ -3,18 +3,24 @@
 Create a Quasar Framework application using
 [quasar-cli](https://quasar.dev/quasar-cli/installation):
 
-    $ quasar create my-app
-    $ cd my-app
+```console
+quasar create my-app
+cd my-app
+```
 
 In the app directory, generate the files for the resource you want:
 
-    $ npx @api-platform/client-generator https://demo.api-platform.com src/ --generator quasar --resource foo
-    # Replace the URL by the entrypoint of your Hydra-enabled API
-    # Omit the resource flag to generate files for all resource types exposed by the API
+```console
+npx @api-platform/client-generator https://demo.api-platform.com src/ --generator quasar --resource foo
+```
+
+Replace the URL by the entrypoint of your Hydra-enabled API.
+Omit the resource flag to generate files for all resource types exposed by the API.
 
-The code is ready to be executed! Register the generated routes in `src/router/routes.js`
+The code is ready to be executed! Register the generated routes:
 
 ```javascript
+// src/router/routes.js
 import fooRoutes from '../generated/router/foo';
 
 const routes = [
@@ -24,12 +30,12 @@ const routes = [
     children: [
       ...fooRoutes
     ],
-
 ```
 
-and store modules in the `src/store/index.js` file.
+And add the modules to the store:
 
 ```javascript
+// src/store/index.js
 // Replace "foo" with the name of the resource type
 import foo from '../generated/store/modules/foo/';
 
@@ -38,12 +44,12 @@ export default function(/* { ssrContext } */) {
     modules: {
       foo,
     },
-
 ```
 
-Make sure to update the `quasar.conf.js` file with the following:
+Finally, make sure to update the config:
 
 ```javascript
+// quasar.conf.js
 framework: {
   components: [
     'QTable',
@@ -63,12 +69,12 @@ framework: {
     'QCheckbox',
     'QPopupProxy'
 
-    ...
+    // ...
   ],
   directives: [..., 'ClosePopup'],
   plugins: ['Notify'],
   config: {
-    ...
+    // ...
     notify: {
       position: 'top',
       multiLine: true,