Sync master into bff-demo

.github/scripts/bbe/convertMarkdown.js

@@ -136,29 +136,6 @@ const codeSnippetGenerator = (code, marginLeftMultiplier, lang) => {
   return output;
 };
 
-// playground link generator
-const generatePlaygroundLink = async (content, description, fileName) => {
-  const data = {
-    content,
-    description,
-    fileName,
-  };
-
-  try {
-    sleep(1000);
-    const result = await axios({
-      url: "https://play.ballerina.io/gists",
-      method: "POST",
-      data,
-    });
-
-    playgroundLink = `https://play.ballerina.io/?gist=${result.data.id}&file=${fileName}`;
-  } catch (error) {
-    console.log(error.response.data);
-  }
-  return playgroundLink;
-};
-
 // edit on github link generator
 const generateEditOnGithubLink = (exampleDir) => {
   // Github base URL
@@ -190,36 +167,9 @@ md.use(container, "code", {
       ${env.isIndent ? 'indent' : ''}" 
       style={{ marginLeft: "${env.marginLeftMultiplier * 8}px" }}>
   <Col className="d-flex align-items-start" sm={12}>
-    ${env.playgroundLink != undefined
-          ? `<button
-        className="bg-transparent border-0 m-0 p-2 ms-auto"
-        onClick={() => {
-          window.open(
-            "${env.playgroundLink}",
-            "_blank"
-          );
-        }}
-        target="_blank"
-        aria-label="Open in Ballerina Playground"
-      >
-        <svg
-          xmlns="http://www.w3.org/2000/svg"
-          width="16"
-          height="16"
-          fill="#000"
-          className="bi bi-play-circle"
-          viewBox="0 0 16 16"
-        >
-          <title>Open in Ballerina Playground</title>
-          <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z" />
-          <path d="M6.271 5.055a.5.5 0 0 1 .52.038l3.5 2.5a.5.5 0 0 1 0 .814l-3.5 2.5A.5.5 0 0 1 6 10.5v-5a.5.5 0 0 1 .271-.445z" />
-        </svg>
-      </button>`
-        : ""
-    } 
     ${(env.editOnGithubLink !== "") ? `
     <button
-      className="bg-transparent border-0 m-0 p-2${env.playgroundLink != undefined ? "" : " ms-auto"}"
+      className="bg-transparent border-0 m-0 p-2 ms-auto"
       onClick={() => {
         window.open("${env.editOnGithubLink}", "_blank");
       }}
@@ -716,11 +666,7 @@ const generate = async (examplesDir, outputDir) => {
                     let { fileName, codeContent } = extractCode(relPath, m[2]);
 
                     if (playground) {
-                      playgroundLink = await generatePlaygroundLink(
-                        codeContent,
-                        relPath,
-                        fileName
-                      );
+                      playgroundLink = `vscode://wso2.ballerina/open-file?repoFileUrl=${editOnGithubLink}/${file}`;
                     }
 
                     convertedLine = md.render(m[2], {

_data/swanlake-latest/metadata.json

@@ -1,21 +1,21 @@
 {
-	"version":"2201.8.2",
-	"short-version":"2201.8.2",
-	"display-version":"2201.8.2 (Swan Lake Update 8)",
-	"release-date":"2023-10-17",
-	"windows-installer":"ballerina-2201.8.2-swan-lake-windows-x64.msi",
-	"windows-installer-size":"174mb",
-	"linux-installer":"ballerina-2201.8.2-swan-lake-linux-x64.deb",
-	"linux-installer-size":"197mb",
-	"macos-installer":"ballerina-2201.8.2-swan-lake-macos-x64.pkg",
-	"macos-installer-size":"232mb",
-	"macos-arm-installer":"ballerina-2201.8.2-swan-lake-macos-arm-x64.pkg",
-	"macos-arm-installer-size":"231mb",
-	"rpm-installer":"ballerina-2201.8.2-swan-lake-linux-x64.rpm",
-	"rpm-installer-size":"234mb",
-	"other-artefacts":[
-		"ballerina-2201.8.2-swan-lake.zip"
-	],
-	"api-docs":"ballerina-api-docs-2201.8.2.zip",
-	"release-notes":"ballerina-release-notes-2201.8.2.md"
+	"version":"2201.8.3",
+	"short-version":"2201.8.3",
+	"display-version":"2201.8.3 (Swan Lake Update 8)",
+	"release-date":"2023-11-22",
+	"windows-installer":"ballerina-2201.8.3-swan-lake-windows-x64.msi",
+	"windows-installer-size":"178mb",
+	"linux-installer":"ballerina-2201.8.3-swan-lake-linux-x64.deb",
+	"linux-installer-size":"200mb",
+	"macos-installer":"ballerina-2201.8.3-swan-lake-macos-x64.pkg",
+	"macos-installer-size":"236mb",
+	"macos-arm-installer":"ballerina-2201.8.3-swan-lake-macos-arm-x64.pkg",
+	"macos-arm-installer-size":"235mb",
+	"rpm-installer":"ballerina-2201.8.3-swan-lake-linux-x64.rpm",
+	"rpm-installer-size":"238mb",
+	"other-artefacts":[  
+		"ballerina-2201.8.3-swan-lake.zip"
+ 	],
+	"api-docs":"ballerina-api-docs-2201.8.3.zip",
+	"release-notes":"ballerina-release-notes-2201.8.3.md"
 }

_data/swanlake_release_notes_versions.json

@@ -1116,5 +1116,26 @@
    ],
    "api-docs":"ballerina-api-docs-2201.8.1.zip",
    "release-notes":"ballerina-release-notes-2201.8.1.md"
+},
+{
+	"version":"2201.8.2",
+	"short-version":"2201.8.2",
+	"display-version":"2201.8.2 (Swan Lake Update 8)",
+	"release-date":"2023-10-17",
+	"windows-installer":"ballerina-2201.8.2-swan-lake-windows-x64.msi",
+	"windows-installer-size":"174mb",
+	"linux-installer":"ballerina-2201.8.2-swan-lake-linux-x64.deb",
+	"linux-installer-size":"197mb",
+	"macos-installer":"ballerina-2201.8.2-swan-lake-macos-x64.pkg",
+	"macos-installer-size":"232mb",
+	"macos-arm-installer":"ballerina-2201.8.2-swan-lake-macos-arm-x64.pkg",
+	"macos-arm-installer-size":"231mb",
+	"rpm-installer":"ballerina-2201.8.2-swan-lake-linux-x64.rpm",
+	"rpm-installer-size":"234mb",
+	"other-artefacts":[
+		"ballerina-2201.8.2-swan-lake.zip"
+	],
+	"api-docs":"ballerina-api-docs-2201.8.2.zip",
+	"release-notes":"ballerina-release-notes-2201.8.2.md"
 }
 ]

case-studies/ballerina-central.md

@@ -0,0 +1,53 @@
+---
+layout: ballerina-publishing-to-central-left-nav-pages-swanlake
+title: 'Ballerina Central leverages the power of Ballerina for effective package management'
+description: Ballerina code is organized in a single, shareable unit called a package. Ballerina packages are developed via different channels in multiple categories. These categories include the Ballerina packages that are developed by the Ballerina team, which are shipped with the Ballerina distribution, the BallerinaX packages that are developed by the Ballerina team but are not shipped with the distribution, and the packages that are developed by third-party users, which are also not shipped with the distribution.
+keywords: ballerina, programming language, package, management, central
+permalink: /learn/case-studies/central
+active: central
+intro: Ballerina code is organized in a single, shareable unit called a package. Ballerina packages are developed via different channels in multiple categories. These categories include the Ballerina packages that are developed by the Ballerina team, which are shipped with the Ballerina distribution, the BallerinaX packages that are developed by the Ballerina team but are not shipped with the distribution, and the packages that are developed by third-party users, which are also not shipped with the distribution.
+logo: '/images/home-page/user-logos/ballerina-central.svg'
+user: 'central'
+---
+
+## Overview
+
+With the rapidly increasing growth of a wide range of these Ballerina packages, a need for a globally hosted robust package management system to discover, download, and publish them was highlighted. [Ballerina Central](https://central.ballerina.io/) was developed to cater to this purpose as the all-inclusive package repository to manage Ballerina, BallerinaX, and other packages belonging to other organizations. 
+
+## Challenges
+
+The primary objective of Ballerina Central is to manage the wide spectrum of Ballerina packages most effectively and optimally. Therefore, it was critical for Ballerina Central to be a cloud deployment, which can scale the platform on demand when the load is increased by preserving consistent high availability for its users. Designing the solution faced several other secondary challenges such as the requirement to handle JSON, other network-services-related data types, and database connectors, achieve concurrency via isolated services, and generate Docker and Kubernetes images for a robust and resilient cloud deployment.
+
+## Solution
+
+The Ballerina language was the natural choice when implementing Ballerina Central, not only to demonstrate its features in a real-world use case but also because the features of Ballerina were deemed to be the perfect choice to meet the specific requirements and develop the best package repository, prompting to come up with a fresh an innovative solution for itself.
+
+As for the main highlights of the solution as illustrated in the diagram below, [WSO2 Choreo](https://wso2.com/choreo/) was used to provide the hosting capabilities, [WSO2 Asgardeo](https://wso2.com/asgardeo/) was used as the identity service provider, and Microsoft Azure products and SQL were used in implementing the cloud-based network and data storage requirements.
+
+<img src="/images/case-studies/ballerina-central-architecture.png" alt="Ballerina Central Architecture">
+
+## Benefits
+
+Implementing the Ballerina Central platform had a profound impact on managing Ballerina packages in an optimized manner based on the key areas listed below.
+
+- **Scalability:** The platform easily accommodated increased uploads of Ballerina packages, ensuring a seamless experience for developers when downloading them.
+
+- **High availability:** The use of the cloud-native features of the Ballerina language together with the Azure cloud deployment helped to ensure high availability in the solution.
+
+- **Load handling:** The implementation was designed to be capable of handling a large number of user requests being made simultaneously to download Ballerina packages.
+
+- **Package maintenance:** The solution enabled storing and managing the packages all in one place together with the components related to them such as the corresponding source code and documentation.
+
+- **Security:** Ballerina's strong security features such as OAuth2 authentication and rate limiting were used in implementing security in Ballerina Central to secure and safeguard sensitive information associated with the packages.
+
+- **Monitoring and analytics:** With the Azure log analyzer, Ballerina's observability capabilities were utilized to gain real-time insights into the performance of the packages. 
+
+- **Enhanced CI/CD capabilities:** The solution was designed with improved CI/CD features to ensure smooth and effective usage of the packages via operations such as publishing and downloading.
+
+- **Augmented development experience:** The concise and efficient syntax of the Ballerina language combined with its advanced graphical tooling facilitated an enhanced development experience, which included writing the code with less effort, reducing the learning curve, and improving long-term code readability and maintainability.
+
+## Conclusion
+
+The journey of Ballerina Central to implement a robust and resilient Ballerina package management platform was successful mainly due to the perfect matching of the Ballerina features with the requirements of the planned solution. The platform not only paved the way for them to meet the expectations of managing the Ballerina packages smoothly and effectively but also demonstrated a practical example of utilizing the feature-rich Ballerina language in a real-world scenario, thereby, safeguarding and strengthening the simplicity and powerfulness of the Ballerina language ecosystem for continued growth in the enterprise integration solutions arena.
+
+>*"Ballerina Central's successful implementation of a robust package management platform showcases the perfect synergy between Ballerina's features and the solution's needs. This achievement not only ensures efficient Ballerina package management but also serves as a compelling real-world testament to the language's adaptability by strengthening the simplicity and power of the Ballerina language ecosystem.*<br/><br/>Anuruddha Liyanarachchi - Technical Lead, WSO2 LLC.

case-studies/mosip.md

@@ -1,7 +1,7 @@
 ---
 layout: ballerina-publishing-to-central-left-nav-pages-swanlake
 title: 'How MOSIP uses Ballerina WebSubHub for event-driven integration'
-description: 
+description: Ballerina is an open source programming language for the cloud that makes it easier to use, combine, and create network services. In addition to the powerful language features, it comes with a rich Ballerina library, which covers network data, messaging, and communication protocols. The Modular Open Source Identity Platform (MOSIP), an open-source identity platform currently being adopted by several countries to manage the digitization of their civil registries, uses the Ballerina WebSubHub module for event-driven communication.
 keywords: ballerina, programming language, integration, websubhub, mosip
 permalink: /learn/case-studies/mosip
 active: mosip

case-studies/wso2.md

@@ -1,7 +1,7 @@
 ---
 layout: ballerina-publishing-to-central-left-nav-pages-swanlake
 title: 'Transform WSO2 internal apps to enhance efficiency and collaboration'
-description: 
+description: WSO2’s digital transformation team realized that they needed to modernize the company’s own internal applications to improve operational efficiency, collaboration, and productivity. To drive these efforts, the company leveraged the Ballerina language to achieve remarkable results and empower its workforce.
 keywords: ballerina, programming language, digital transformation, internal apps, wso2
 permalink: /learn/case-studies/wso2
 active: wso2

components/common/top-nav/TopNav.js

@@ -53,7 +53,8 @@ const TopNav = (props) => {
     <Dropdown.Item category='usecases' href={`${prefix}/usecases/microservices`} className={styles.dropDownItem} key='10'>Microservices</Dropdown.Item>,
     <Dropdown.Item category='usecases' href={`${prefix}/usecases/bff`} className={styles.dropDownItem} key='11'>BFF</Dropdown.Item>,
     <Dropdown.Item category='case studies' href={`${prefix}/case-studies/wso2`} className={styles.dropDownItem} key='9'>WSO2</Dropdown.Item>,
-    <Dropdown.Item category='case studies' href={`${prefix}/case-studies/mosip`} className={styles.dropDownItem} key='12'>MOSIP</Dropdown.Item>
+    <Dropdown.Item category='case studies' href={`${prefix}/case-studies/mosip`} className={styles.dropDownItem} key='11'>MOSIP</Dropdown.Item>,
+    <Dropdown.Item category='case studies' href={`${prefix}/case-studies/ballerina-central`} className={styles.dropDownItem} key='12'>Ballerina Central</Dropdown.Item>
   ];
 
 

components/home-page/users/Users.js

@@ -48,18 +48,18 @@ export default function Users(props) {
 
         <Row>
           <Col sm={18} md={12} className={styles.logo}>
-              <a href="/case-studies/wso2" target='_blank' rel="noreferrer" ><img src={`${prefix}/images/home-page/user-logos/wso2.svg`} width={280} alt="WSO2" title="WSO2" /></a>
+              <a href={`${prefix}/case-studies/wso2`}><img src={`${prefix}/images/home-page/user-logos/wso2.svg`} width={280} alt="WSO2" title="WSO2" /></a>
               <a href="https://choreo.dev/" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/choreo.svg`} width={280} alt="Choreo" title="Choreo" /></a>
               <a href="https://fattuesday.com/" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/fat-tuesday.svg`}  width={150} alt="Fat Tuesday" title="Fat Tuesday" /></a>
-              <a href="/case-studies/mosip" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/mosip.png`}  width={280} alt="MOSIP" title="MOSIP" /></a>
+              <a href={`${prefix}/case-studies/mosip`}><img src={`${prefix}/images/home-page/user-logos/mosip.png`}  width={280} alt="MOSIP" title="MOSIP" /></a>
               <a href="https://quantil.readthedocs.io/en/latest/user-guide/qhana/" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/qhana.png`}  width={200} alt="QHAna - The Quantum Humanities Analysis Tool" title="QHAna - The Quantum Humanities Analysis Tool" /></a>
 
           </Col>
         </Row>
         <Row>
           <Col sm={18} md={12} className={styles.logo}>
-              <a href="https://central.ballerina.io/" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/ballerina-central.svg`} width={340} alt="Ballerina Central" title="Ballerina Central" /></a>
-              <a href="https://elixir.redcross.lk/" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/redcross-elixir.png`} width={280} alt="Redcross Elixir" title="Redcross Elixir" /></a>
+              <a href={`${prefix}/case-studies/ballerina-central`}><img src={`${prefix}/images/home-page/user-logos/ballerina-central.svg`} width={340} alt="Ballerina Central" title="Ballerina Central" /></a>
+              <a href="https://www.redcross.lk/news/sri-lanka-red-cross-societys-elixir-a-source-of-strength-to-the-health-sector-of-sri-lanka/" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/redcross-elixir.png`} width={280} alt="Redcross Elixir" title="Redcross Elixir" /></a>
               <a href="https://www.raapid.ai/" target='_blank' rel="noreferrer"><img src={`${prefix}/images/home-page/user-logos/raapid-ai.png`} width={320} alt="RAAPID" title="RAAPID" /></a>
           </Col>
         </Row>

downloads/1.2.x-release-notes/1.2.x-bug-fixes-template.md

@@ -3,8 +3,6 @@ layout: ballerina-left-nav-release-notes
 title: <RELEASE_VERSION>
 permalink: /downloads/1.2.x-release-notes/<RELEASE_VERSION>/
 active: <RELEASE_VERSION>
-redirect_from:
-    - /downloads/1.2.x-release-notes/
 ---
 
 ## Overview of jBallerina <RELEASE_VERSION>

downloads/1.2.x-release-notes/1.2.x-security-fixes-template copy.md → downloads/1.2.x-release-notes/1.2.x-security-fixes-template.md

@@ -3,15 +3,13 @@ layout: ballerina-left-nav-release-notes
 title: <RELEASE_VERSION>
 permalink: /downloads/1.2.x-release-notes/<RELEASE_VERSION>/
 active: <RELEASE_VERSION>
-redirect_from:
-    - /downloads/1.2.x-release-notes/
 ---
 
 ## Overview of jBallerina <RELEASE_VERSION>
 
 <!-- COMMENT OUT ONLY THE APPLICABLE ONE FROM THE BELOW -->
 
-<!-- The jBallerina <RELEASE_VERSION> patch release improves upon the <PREVIOUS_RELEASE_VERSION> release by addressing a few security improvements. -->
+<!-- The jBallerina <RELEASE_VERSION> patch release improves upon the <PREVIOUS_RELEASE_VERSION> release by addressing a security improvement. -->
 
 <!-- The jBallerina <RELEASE_VERSION> patch release improves upon the <PREVIOUS_RELEASE_VERSION> release by addressing a few security improvements. -->