From a07938d517c1dffbbacb3d206f0ed4885dd4f841 Mon Sep 17 00:00:00 2001 From: Faruk AYDIN Date: Wed, 20 Jul 2022 16:32:33 +0300 Subject: [PATCH] docs: Add request an integration guide --- .../docs/integrations/request-integration.md | 81 ++----------------- 1 file changed, 6 insertions(+), 75 deletions(-) diff --git a/packages/docs/docs/integrations/request-integration.md b/packages/docs/docs/integrations/request-integration.md index 846605e8..ef8428be 100644 --- a/packages/docs/docs/integrations/request-integration.md +++ b/packages/docs/docs/integrations/request-integration.md @@ -4,85 +4,16 @@ sidebar_position: 2 # Request Integration -Let's translate `docs/intro.md` to French. +You can request a new integration by using [Github discussions](https://github.com/automatisch/automatisch/discussions/categories/integration-request). -## Configure i18n +:::info -Modify `docusaurus.config.js` to add support for the `fr` locale: - -```js title="docusaurus.config.js" -module.exports = { - i18n: { - defaultLocale: 'en', - locales: ['en', 'fr'], - }, -}; -``` - -## Translate a doc - -Copy the `docs/intro.md` file to the `i18n/fr` folder: - -```bash -mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/ - -cp docs/intro.md i18n/fr/docusaurus-plugin-content-docs/current/intro.md -``` - -Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.md` in French. - -## Start your localized site - -Start your site on the French locale: - -```bash -npm run start -- --locale fr -``` - -Your localized site is accessible at `http://localhost:3000/fr/` and the `Getting Started` page is translated. - -:::caution - -In development, you can only use one locale at a same time. +While we are working hard to add as many integrations as possible, it might take some time to see your request is being done. It's because we prefer to collect all integration requests and prioritize the most requested ones. ::: -## Add a Locale Dropdown +:::tip -To navigate seamlessly across languages, add a locale dropdown. +If there is already an integration request for the service you'd like, it's still crucial to upvote that discussion for us to analyze the potential audience around the integration. -Modify the `docusaurus.config.js` file: - -```js title="docusaurus.config.js" -module.exports = { - themeConfig: { - navbar: { - items: [ - // highlight-start - { - type: 'localeDropdown', - }, - // highlight-end - ], - }, - }, -}; -``` - -The locale dropdown now appears in your navbar: - -![Locale Dropdown](/img/tutorial/localeDropdown.png) - -## Build your localized site - -Build your site for a specific locale: - -```bash -npm run build -- --locale fr -``` - -Or build your site to include all the locales at once: - -```bash -npm run build -``` +:::