docs: add starlight-versions

packages/documentation/astro.config.mjs

@@ -7,6 +7,7 @@ import starlightLinksValidator from 'starlight-links-validator'
 import starlightFullViewMode from 'starlight-fullview-mode'
 import { rehypeHeadingIds } from '@astrojs/markdown-remark'
 import rehypeAutolinkHeadings from 'rehype-autolink-headings'
+import starlightVersions from 'starlight-versions'
 
 // https://astro.build/config
 export default defineConfig({
@@ -366,12 +367,18 @@ export default defineConfig({
         }
       ],
       plugins: [
+        starlightVersions({
+          current: {
+            label: 'v2-beta'
+          },
+          versions: [{ slug: 'v1-beta' }]
+        }),
         starlightLinksValidator({
           exclude: [
-            '/apis/graphql/auth',
-            '/apis/graphql/backend',
-            '/apis/graphql/auth/*',
-            '/apis/graphql/backend/*'
+            '**/apis/graphql/auth',
+            '**/apis/graphql/backend',
+            '**/apis/graphql/auth/*',
+            '**/apis/graphql/backend/*'
           ],
           errorOnLocalLinks: false,
           errorOnFallbackPages: false,

packages/documentation/package.json

@@ -5,6 +5,7 @@
   "scripts": {
     "start": "astro dev",
     "build:docs": "astro build",
+    "build:docs:graphql": "spectaql config-auth.yml && spectaql config-backend.yml",
     "preview": "astro preview",
     "astro": "astro"
   },
@@ -19,6 +20,7 @@
     "remark-math": "^6.0.0",
     "spectaql": "^3.0.4",
     "starlight-fullview-mode": "^0.2.3",
-    "starlight-links-validator": "^0.17.0"
+    "starlight-links-validator": "^0.17.0",
+    "starlight-versions": "^0.5.5"
   }
 }

packages/documentation/src/components/Header.astro

@@ -1,19 +1,21 @@
 ---
 import { getRelativeLocaleUrl } from 'astro:i18n';
-import Search from "@astrojs/starlight/components/Search.astro";
 import ThemeSelect from "@astrojs/starlight/components/ThemeSelect.astro";
 import LanguageSelect from '@astrojs/starlight/components/LanguageSelect.astro';
 import SocialIcons from "@astrojs/starlight/components/SocialIcons.astro";
 import RafikiLogo from "../components/RafikiLogo.astro";
+import VersionSelect from 'starlight-versions/components/VersionSelect.astro'
+import VersionSearch from 'starlight-versions/components/VersionSearch.astro'
 ---
 <div class="header sl-flex">
   <a href={getRelativeLocaleUrl(Astro.currentLocale ?? 'en', '/')} class="site-logo">
     <RafikiLogo />
   </a>
   <div class="secondary-wrap">
-    <Search />
+    <VersionSearch />
     <SocialIcons />
     <div class="sl-hidden md:sl-flex">
+      <VersionSelect/>
       <ThemeSelect />
     </div>
     <LanguageSelect />

packages/documentation/src/content.config.ts

@@ -1,8 +1,10 @@
 import { defineCollection } from 'astro:content'
 import { docsLoader } from '@astrojs/starlight/loaders'
 import { docsSchema, i18nSchema } from '@astrojs/starlight/schema'
+import { docsVersionsLoader } from 'starlight-versions/loader'
 
 export const collections = {
   docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
-  i18n: defineCollection({ type: 'data', schema: i18nSchema() })
+  i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
+  versions: defineCollection({ loader: docsVersionsLoader() })
 }

packages/documentation/src/content/docs/es/index.mdx

@@ -6,7 +6,7 @@ hero:
   tagline: Rafiki is open source software that provides an efficient solution for an account servicing entity (ASE) to enable Interledger functionality on its users' accounts.
   actions:
     - text: Read Rafiki docs
-      link: /overview/overview
+      link: /es/overview/overview
       icon: open-book
       variant: primary
       attrs:

packages/documentation/src/content/docs/es/v1-beta/index.mdx

@@ -0,0 +1,46 @@
+---
+title: Hello from Rafiki
+description: Rafiki is open source software that provides an efficient solution
+  for an Account Servicing Entity to enable Interledger functionality on its
+  users' accounts.
+template: splash
+hero:
+  tagline:
+    Rafiki is open source software that provides an efficient solution for
+    an account servicing entity (ASE) to enable Interledger functionality on its
+    users' accounts.
+  actions:
+    - text: Read Rafiki docs
+      link: /es/v1-beta/overview/overview
+      icon: open-book
+      variant: primary
+      attrs:
+        data-umami-event: Landing page - Rafiki docs
+slug: es/v1-beta
+---
+
+import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components'
+
+<CardGrid>
+  <a class='card-link' href='/integration/playground/overview'>
+    <Card title='Try it out!' icon='document'>
+      Test Rafiki by running two mock ASEs that automatically peer with one
+      another.
+    </Card>
+  </a>
+  <a class='card-link' href='/integration/requirements/overview'>
+    <Card title='Integration requirements' icon='document'>
+      Review the requirements for deploying Rafiki to a production environment.
+    </Card>
+  </a>
+  <a class='card-link' href='/apis/graphql/backend'>
+    <Card title='View Backend API schema' icon='document'>
+      Discover what's in our Backend GraphQL schema.
+    </Card>
+  </a>
+  <a class='card-link' href='/apis/graphql/auth'>
+    <Card title='View Auth API schema' icon='document'>
+      Discover what's in our Auth GraphQL schema.
+    </Card>
+  </a>
+</CardGrid>

packages/documentation/src/content/docs/es/v1-beta/overview/concepts/account-servicing-entity.mdx

@@ -0,0 +1,38 @@
+---
+title: Servicio de Cuentas de Entidad (ASE)
+slug: es/v1-beta/overview/concepts/account-servicing-entity
+---
+
+An account servicing entity (ASE) is a regulated entity that provides and maintains payment accounts for its customers. Examples of ASEs include banks, digital wallet providers, and mobile money providers.
+
+As regulated entities, ASEs are subject to the laws, rules, and regulations of their jurisdictions. As such, Rafiki should **not** be used in production environments by non-regulated entities.
+
+## Responsibilities and obligations
+
+A few examples of an ASE's responsibilities and obligations include:
+
+- Regulatory compliance
+- Account provisioning and maintenance
+- Transaction handling
+- Ledger management
+- Authentication and consent
+
+### Regulatory compliance
+
+ASEs must onboard account holders in compliance with regulatory requirements, such as performing Know Your Customer (KYC) checks, anti-money laundering (AML) processes, and sanctions screening.
+
+### Account provisioning and maintenance
+
+ASEs manage the creation, upkeep, and security of payment accounts. This includes providing channels for account holders (individuals or businesses) to interact with their accounts via mobile apps, websites, and other interfaces.
+
+### Transaction handling
+
+ASEs handle deposits and withdrawals through various external payment methods such as bank transfers, credit cards, and other payment services.
+
+### Ledger management
+
+ASEs maintain a ledger of account balances and transaction histories for their account holders.
+
+### Authentication and consent
+
+In the context of Open Payments, ASEs are responsible for authenticating resource owners (for example, account holders) and obtaining their consent when clients, such as mobile apps, request access to a resource (for example, an account).