Skip to content

Commit

Permalink
Merge pull request strapi#11709 from strapi/v4/readme-update
Browse files Browse the repository at this point in the history
V4/readme update
  • Loading branch information
alexandrebodin authored Nov 29, 2021
2 parents 6e0f205 + 84e201a commit b4993da
Show file tree
Hide file tree
Showing 22 changed files with 52 additions and 50 deletions.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ _For users running on Apple Silicon M1, you may encounter errors thrown by `shar

To facilitate the contribution, we have drastically reduced the amount of commands necessary to install the entire development environment.

First of all, you need to check if you're using the [required versions of Node.js and npm](https://strapi.io/documentation/developer-docs/latest/setup-deployment-guides/deployment.html#recommended-requirements).
First of all, you need to check if you're using the [required versions of Node.js and npm](https://docs.strapi.io/developer-docs/latest/setup-deployment-guides/deployment.html).

Then, please follow the instructions below:

Expand Down
26 changes: 13 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@
<br />

<p align="center">
<a href="https://www.npmjs.org/package/strapi">
<img src="https://img.shields.io/npm/v/strapi/latest.svg" alt="NPM Version" />
<a href="https://www.npmjs.org/package/@strapi/strapi">
<img src="https://img.shields.io/npm/v/@strapi/strapi/latest.svg" alt="NPM Version" />
</a>
<a href="https://www.npmjs.org/package/strapi">
<img src="https://img.shields.io/npm/dm/strapi.svg" alt="Monthly download on NPM" />
<a href="https://github.com/strapi/strapi/actions/workflows/tests.yml">
<img src="https://github.com/strapi/strapi/actions/workflows/tests.yml/badge.svg?branch=master" alt="Tests" />
</a>
<a href="https://discord.strapi.io">
<img src="https://img.shields.io/discord/811989166782021633?label=Discord" alt="Strapi on Discord" />
Expand All @@ -24,7 +24,7 @@

<p align="center">
<a href="https://strapi.io">
<img src="https://raw.githubusercontent.com/strapi/strapi/master/public/assets/administration_panel.png" alt="Administration panel" />
<img src="https://raw.githubusercontent.com/strapi/strapi/0bcebf77b37182fe021cb59cc19be8f5db4a18ac/public/assets/administration_panel.png" alt="Administration panel" />
</a>
</p>

Expand All @@ -33,13 +33,13 @@
Strapi is a free and open-source headless CMS delivering your content anywhere you need.

- **Keep control over your data**. With Strapi, you know where your data is stored, and you keep full control at all times.
- **Self-hosted**. You can host and scale Strapi projects the way you want. You can choose any hosting platform you want: AWS, Render, Heroku, a VPS, or a dedicated server. You can scale as you grow, 100% independent.
- **Database agnostic**. You can choose the database you prefer. Strapi works with SQL & NoSQL databases: MongoDB, PostgreSQL, MySQL, MariaDB, and SQLite.
- **Self-hosted**. You can host and scale Strapi projects the way you want. You can choose any hosting platform you want: AWS, Render, Netlify, Heroku, a VPS, or a dedicated server. You can scale as you grow, 100% independent.
- **Database agnostic**. Strapi works with SQL databases. You can choose the database you prefer: PostgreSQL, MySQL, MariaDB, and SQLite.
- **Customizable**. You can quickly build your logic by fully customizing APIs, routes, or plugins to fit your needs perfectly.

## Getting Started

<a href="https://strapi.io/documentation/developer-docs/latest/getting-started/quick-start.html" target="_blank">Read the Getting Started tutorial</a> or follow the steps below:
<a href="https://docs.strapi.io/developer-docs/latest/getting-started/quick-start.html" target="_blank">Read the Getting Started tutorial</a> or follow the steps below:

### ⏳ Installation

Expand All @@ -65,7 +65,7 @@ Enjoy 🎉

### 🖐 Requirements

Complete installation requirements can be found in the documentation under <a href="https://strapi.io/documentation/developer-docs/latest/setup-deployment-guides/deployment.html#recommended-requirements">Installation Requirements</a>.
Complete installation requirements can be found in the documentation under <a href="https://docs.strapi.io/developer-docs/latest/setup-deployment-guides/deployment.html">Installation Requirements</a>.

**Supported operating systems**:

Expand Down Expand Up @@ -109,7 +109,7 @@ Please read our [Contributing Guide](./CONTRIBUTING.md) before submitting a Pull

## Community support

For general help using Strapi, please refer to [the official Strapi documentation](https://strapi.io/documentation/). For additional help, you can use one of these channels to ask a question:
For general help using Strapi, please refer to [the official Strapi documentation](https://docs.strapi.io). For additional help, you can use one of these channels to ask a question:

- [Discord](https://discord.strapi.io) (For live discussion with the Community and Strapi team)
- [GitHub](https://github.com/strapi/strapi) (Bug reports, Contributions)
Expand All @@ -122,7 +122,7 @@ For general help using Strapi, please refer to [the official Strapi documentatio

## Migration

Follow our [migration guides](https://strapi.io/documentation/developer-docs/latest/update-migration-guides/migration-guides.html) on the documentation to keep your projects up-to-date.
Follow our [migration guides](https://docs.strapi.io/developer-docs/latest/update-migration-guides/migration-guides.html) on the documentation to keep your projects up-to-date.

## Roadmap

Expand All @@ -132,8 +132,8 @@ Check out our [roadmap](https://portal.productboard.com/strapi) to get informed

See our dedicated [repository](https://github.com/strapi/documentation) for the Strapi documentation, or view our documentation live:

- [Developer docs](https://strapi.io/documentation/developer-docs/latest/getting-started/introduction.html)
- [User docs](https://strapi.io/documentation/user-docs/latest/getting-started/introduction.html)
- [Developer docs](https://docs.strapi.io/developer-docs/latest/getting-started/introduction.html)
- [User guide](https://docs.strapi.io/user-docs/latest/getting-started/introduction.html)

## Try live demo

Expand Down
4 changes: 3 additions & 1 deletion packages/core/admin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,12 @@

## Description

TODO
This is the admin panel package

## Contribute

You can read the contribution guide [here](../../../CONTRIBUTING.md)

### Setup

Create a new Strapi project: `strapi new myApp`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ const Blocker = ({ displayedIcon, description, title, isOpen }) => {
<Flex justifyContent="center">
<Box paddingTop={2}>
<Link
href="https://strapi.io/documentation"
href="https://docs.strapi.io"
target="_blank"
rel="noopener noreferrer nofollow"
>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ const Onboarding = () => {
id: 'app.components.LeftMenuFooter.documentation',
defaultMessage: 'Documentation',
}),
destination: 'https://strapi.io/documentation',
destination: 'https://docs.strapi.io',
},
{
icon: 'file',
Expand Down
2 changes: 1 addition & 1 deletion packages/core/content-manager/oas.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ servers:
- url: http://localhost:1337
description: Local server
externalDocs:
url: https://strapi.io/documentation
url: https://docs.strapi.io
description: Strapi documentation
paths:
/content-manager/content-types:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ const Configuration = ({ config }) => {
file: './config/plugins.js',
link: (
<a
href="https://strapi.io/documentation/developer-docs/latest/development/plugins/email.html#configure-the-plugin"
href="https://docs.strapi.io/developer-docs/latest/plugins/email.html"
target="_blank"
rel="noopener noreferrer"
>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -759,7 +759,7 @@ describe('Email | Pages | Settings', () => {
>
The plugin is configured through the ./config/plugins.js file, checkout this
<a
href="https://strapi.io/documentation/developer-docs/latest/development/plugins/email.html#configure-the-plugin"
href="https://docs.strapi.io/developer-docs/latest/plugins/email.html"
rel="noopener noreferrer"
target="_blank"
>
Expand Down
2 changes: 1 addition & 1 deletion packages/core/email/server/controllers/email.js
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ module.exports = {
subject: `Strapi test mail to: ${to}`,
text: `Great! You have correctly configured the Strapi email plugin with the ${strapi.config.get(
'plugin.email.provider'
)} provider. \r\nFor documentation on how to use the email plugin checkout: https://strapi.io/documentation/developer-docs/latest/development/plugins/email.html`,
)} provider. \r\nFor documentation on how to use the email plugin checkout: https://docs.strapi.io/developer-docs/latest/plugins/email.html`,
};

try {
Expand Down
24 changes: 12 additions & 12 deletions packages/core/strapi/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@
<br />

<p align="center">
<a href="https://www.npmjs.org/package/strapi">
<img src="https://img.shields.io/npm/v/strapi/latest.svg" alt="NPM Version" />
<a href="https://www.npmjs.org/package/@strapi/strapi">
<img src="https://img.shields.io/npm/v/@strapi/strapi/latest.svg" alt="NPM Version" />
</a>
<a href="https://www.npmjs.org/package/strapi">
<img src="https://img.shields.io/npm/dm/strapi.svg" alt="Monthly download on NPM" />
<a href="https://github.com/strapi/strapi/actions/workflows/tests.yml">
<img src="https://github.com/strapi/strapi/actions/workflows/tests.yml/badge.svg?branch=master" alt="Tests" />
</a>
<a href="https://discord.strapi.io">
<img src="https://img.shields.io/discord/811989166782021633?label=Discord" alt="Strapi on Discord" />
Expand All @@ -24,7 +24,7 @@

<p align="center">
<a href="https://strapi.io">
<img src="https://raw.githubusercontent.com/strapi/strapi/master/public/assets/administration_panel.png" alt="Administration panel" />
<img src="https://raw.githubusercontent.com/strapi/strapi/0bcebf77b37182fe021cb59cc19be8f5db4a18ac/public/assets/administration_panel.png" alt="Administration panel" />
</a>
</p>

Expand All @@ -39,7 +39,7 @@ Strapi is a free and open-source headless CMS delivering your content anywhere y

## Getting Started

<a href="https://strapi.io/documentation/developer-docs/latest/getting-started/quick-start.html" target="_blank">Read the Getting Started tutorial</a> or follow the steps below:
<a href="https://docs.strapi.io/developer-docs/latest/getting-started/quick-start.html" target="_blank">Read the Getting Started tutorial</a> or follow the steps below:

### ⏳ Installation

Expand All @@ -65,7 +65,7 @@ Enjoy 🎉

### 🖐 Requirements

Complete installation requirements can be found in the documentation under <a href="https://strapi.io/documentation/developer-docs/latest/setup-deployment-guides/deployment.html#recommended-requirements">Installation Requirements</a>.
Complete installation requirements can be found in the documentation under <a href="https://docs.strapi.io/developer-docs/latest/setup-deployment-guides/deployment.html">Installation Requirements</a>.

**Supported operating systems**:

Expand All @@ -79,7 +79,7 @@ Complete installation requirements can be found in the documentation under <a hr

**Node:**

- NodeJS >= 10.16 <=14
- NodeJS >= 12 <= 16
- NPM >= 6.x

**Database:**
Expand Down Expand Up @@ -109,7 +109,7 @@ Please read our [Contributing Guide](./CONTRIBUTING.md) before submitting a Pull

## Community support

For general help using Strapi, please refer to [the official Strapi documentation](https://strapi.io/documentation/). For additional help, you can use one of these channels to ask a question:
For general help using Strapi, please refer to [the official Strapi documentation](https://docs.strapi.io). For additional help, you can use one of these channels to ask a question:

- [Discord](https://discord.strapi.io) (For live discussion with the Community and Strapi team)
- [GitHub](https://github.com/strapi/strapi) (Bug reports, Contributions)
Expand All @@ -122,7 +122,7 @@ For general help using Strapi, please refer to [the official Strapi documentatio

## Migration

Follow our [migration guides](https://strapi.io/documentation/developer-docs/latest/update-migration-guides/migration-guides.html) on the documentation to keep your projects up-to-date.
Follow our [migration guides](https://docs.strapi.io/developer-docs/latest/update-migration-guides/migration-guides.html) on the documentation to keep your projects up-to-date.

## Roadmap

Expand All @@ -132,8 +132,8 @@ Check out our [roadmap](https://portal.productboard.com/strapi) to get informed

See our dedicated [repository](https://github.com/strapi/documentation) for the Strapi documentation, or view our documentation live:

- [Developer docs](https://strapi.io/documentation/developer-docs/latest/getting-started/introduction.html)
- [User docs](https://strapi.io/documentation/user-docs/latest/getting-started/introduction.html)
- [Developer docs](https://docs.strapi.io/developer-docs/latest/getting-started/introduction.html)
- [User guide](https://docs.strapi.io/user-docs/latest/getting-started/introduction.html)

## Try live demo

Expand Down
2 changes: 1 addition & 1 deletion packages/core/strapi/lib/services/metrics/index.js
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
'use strict';
/**
* Strapi telemetry package.
* You can learn more at https://strapi.io/documentation/developer-docs/latest/getting-started/usage-information.html
* You can learn more at https://docs.strapi.io/developer-docs/latest/getting-started/usage-information.html
*/

const crypto = require('crypto');
Expand Down
2 changes: 1 addition & 1 deletion packages/core/utils/lib/convert-query-params.js
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

/**
* Converts the standard Strapi REST query params to a more usable format for querying
* You can read more here: https://strapi.io/documentation/developer-docs/latest/developer-resources/content-api/content-api.html#filters
* You can read more here: https://docs.strapi.io/developer-docs/latest/developer-resources/database-apis-reference/rest-api.html#filters
*/
const { has } = require('lodash/fp');
const _ = require('lodash');
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ module.exports = {
servers: [],
externalDocs: {
description: 'Find out more',
url: 'https://strapi.io/documentation/developer-docs/latest/getting-started/introduction.html',
url: 'https://docs.strapi.io/developer-docs/latest/getting-started/introduction.html',
},
security: [
{
Expand Down
2 changes: 1 addition & 1 deletion packages/plugins/graphql/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@
This plugin will add GraphQL functionality to your app.
By default it will provide you with most of the CRUD methods exposed in the Strapi REST API.

To learn more about GraphQL in Strapi [visit documentation](https://strapi.io/documentation/developer-docs/latest/development/plugins/graphql.html)
To learn more about GraphQL in Strapi [visit documentation](https://docs.strapi.io/developer-docs/latest/plugins/graphql.html)
2 changes: 1 addition & 1 deletion packages/plugins/i18n/oas.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ servers:
- url: http://localhost:1337
description: Local server
externalDocs:
url: https://strapi.io/documentation
url: https://docs.strapi.io
description: Strapi documentation
paths:
/i18n/iso-locales:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"security": [],
"externalDocs": {
"description": "Find out more in the strapi's documentation",
"url": "https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html#registration"
"url": "https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html#registration"
},
"responses": {
"200": {
Expand Down Expand Up @@ -58,7 +58,7 @@
"security": [],
"externalDocs": {
"description": "Find out more in the strapi's documentation",
"url": "https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html#email-validation"
"url": "https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html#email-validation"
},
"responses": {
"200": {
Expand Down Expand Up @@ -130,7 +130,7 @@
],
"externalDocs": {
"description": "Find out more about the authentication flow in the strapi documentation",
"url": "https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html#setting-up-the-provider-examples"
"url": "https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html#providers"
},
"responses": {
"200": {
Expand All @@ -143,7 +143,7 @@
"post": {
"externalDocs": {
"description": "Find out more in the strapi's documentation",
"url": "https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html#login"
"url": "https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html#login"
},
"tags": ["Authentication"],
"security": [],
Expand Down Expand Up @@ -188,7 +188,7 @@
"tags": ["Authentication"],
"externalDocs": {
"description": "Find out more in the strapi's documentation",
"url": "https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html#setting-up-the-provider-examples"
"url": "https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html#providers"
},
"parameters": [
{
Expand Down Expand Up @@ -223,7 +223,7 @@
"summary": "Send an email to reset your password",
"externalDocs": {
"description": "Find out more in the strapi's documentation",
"url": "https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html#forgotten-reset-password"
"url": "https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html#forgotten-reset-password"
},
"requestBody": {
"description": "",
Expand Down Expand Up @@ -315,7 +315,7 @@
"description": "All the routes related to the authentication",
"externalDocs": {
"description": "Find out more in strapi's documentation",
"url": "https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html"
"url": "https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html"
}
},
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ module.exports = {

if (!strapi.config.server.url.startsWith('http')) {
strapi.log.warn(
'You are using a third party provider for login. Make sure to set an absolute url in config/server.js. More info here: https://strapi.io/documentation/developer-docs/latest/development/plugins/users-permissions.html#setting-up-the-server-url'
'You are using a third party provider for login. Make sure to set an absolute url in config/server.js. More info here: https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html#setting-up-the-server-url'
);
}

Expand Down
2 changes: 1 addition & 1 deletion packages/providers/upload-aws-s3/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

Your configuration is passed down to the provider. (e.g: `new AWS.S3(config)`). You can see the complete list of options [here](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#constructor-property)

See the [using a provider](https://strapi.io/documentation/developer-docs/latest/development/plugins/upload.html#using-a-provider) documentation for information on installing and using a provider. And see the [environment variables](https://strapi.io/documentation/developer-docs/latest/setup-deployment-guides/configurations.html#environment-variables) for setting and using environment variables in your configs.
See the [using a provider](https://docs.strapi.io/developer-docs/latest/plugins/upload.html#using-a-provider) documentation for information on installing and using a provider. And see the [environment variables](https://docs.strapi.io/developer-docs/latest/setup-deployment-guides/configurations/optional/environment.html#environment-variables) for setting and using environment variables in your configs.

**Example**

Expand Down
Loading

0 comments on commit b4993da

Please sign in to comment.