From 52b784d8a98eef70f08b42aadd91aeabf64fed20 Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Sat, 14 Sep 2024 13:28:51 +0300
Subject: [PATCH 1/4] Simplify language

Signed-off-by: Anatoli Babenia <anatoli@rainforce.org>
---
 apps/landing-page/pages/_app.tsx       | 2 +-
 libs/core/src/components/hero/hero.tsx | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/landing-page/pages/_app.tsx b/apps/landing-page/pages/_app.tsx
index ed5e18de..cd1db13d 100644
--- a/apps/landing-page/pages/_app.tsx
+++ b/apps/landing-page/pages/_app.tsx
@@ -82,7 +82,7 @@ function collectHeadings(
 }
 
 const websiteName = 'Devfile.io';
-const websiteDescription = 'An open standard defining containerized development environments.';
+const websiteDescription = 'An open standard for containerized development environments.';
 const lfTrademarkUsageUrl = 'https://lfprojects.org/policies/';
 
 function LandingPage({ Component, pageProps }: AppProps): JSX.Element {
diff --git a/libs/core/src/components/hero/hero.tsx b/libs/core/src/components/hero/hero.tsx
index 2c18dedb..e5ba9942 100644
--- a/libs/core/src/components/hero/hero.tsx
+++ b/libs/core/src/components/hero/hero.tsx
@@ -72,7 +72,7 @@ export function Hero(): JSX.Element {
                 Simplify and accelerate your workflow.
               </p>
               <p className="mt-3 text-2xl tracking-tight text-slate-400">
-                An open standard defining containerized development environments.
+                An open standard for containerized development environments.
               </p>
               <div className="mt-8 flex gap-4 md:justify-center lg:justify-start">
                 <Button

From 8236bb712facc9a1c66064e9aae954aed9fb3ecd Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Sat, 14 Sep 2024 14:56:08 +0300
Subject: [PATCH 2/4] Explain what a devfile is in a cleaner way

Signed-off-by: Anatoli Babenia <anatoli@rainforce.org>
---
 .../src/docs/no-version/what-is-a-devfile.md   | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/libs/docs/src/docs/no-version/what-is-a-devfile.md b/libs/docs/src/docs/no-version/what-is-a-devfile.md
index 1a0f92ff..f6a538b7 100644
--- a/libs/docs/src/docs/no-version/what-is-a-devfile.md
+++ b/libs/docs/src/docs/no-version/what-is-a-devfile.md
@@ -3,16 +3,14 @@ title: What is a devfile
 description: What is a devfile
 ---
 
-You can use devfiles to automate and simplify your development process
-by adopting the existing devfiles that are available in the [public community registry](https://registry.devfile.io/viewer)
-or by authoring your own devfiles to record custom instructions to 
-configure and run your build environment as a YAML-formatted text file.
-You can make these devfiles available in the supporting build tools and 
-IDEs that can automatically process the devfile instructions to configure 
-and build a running application from a development project.
-
-Using the recommended best practices from the devfile, the tools and IDE
-can:
+`devfile.yaml` describes how to configure and run build environment for
+your project in a development container. You can create devfile from scratch or
+adopt existing from [public community registry](https://registry.devfile.io/viewer).
+
+Certain build tools and IDEs can automatically process the devfile
+to configure and build a running application from a development project.
+
+Using devfile, the tools and IDE can:
 
 - Take in the repository hosting your application source code.
 

From 636be9f47c238c9f007c865101f82a4274d0a8fb Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Sat, 2 Aug 2025 11:05:06 +0300
Subject: [PATCH 3/4] Update libs/docs/src/docs/no-version/what-is-a-devfile.md

Co-authored-by: Michael Valdron <michael.valdron@gmail.com>
---
 libs/docs/src/docs/no-version/what-is-a-devfile.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/docs/src/docs/no-version/what-is-a-devfile.md b/libs/docs/src/docs/no-version/what-is-a-devfile.md
index f6a538b7..bcb62b86 100644
--- a/libs/docs/src/docs/no-version/what-is-a-devfile.md
+++ b/libs/docs/src/docs/no-version/what-is-a-devfile.md
@@ -8,7 +8,7 @@ your project in a development container. You can create devfile from scratch or
 adopt existing from [public community registry](https://registry.devfile.io/viewer).
 
 Certain build tools and IDEs can automatically process the devfile
-to configure and build a running application from a development project.
+to configure, build, and run an application from a development project.
 
 Using devfile, the tools and IDE can:
 

From 7d51c1f06ad632aa202b106b5054f383341d9570 Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Sat, 2 Aug 2025 11:44:07 +0300
Subject: [PATCH 4/4] Update libs/docs/src/docs/no-version/what-is-a-devfile.md

Co-authored-by: Michael Valdron <michael.valdron@gmail.com>
---
 libs/docs/src/docs/no-version/what-is-a-devfile.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/docs/src/docs/no-version/what-is-a-devfile.md b/libs/docs/src/docs/no-version/what-is-a-devfile.md
index bcb62b86..216e1ee9 100644
--- a/libs/docs/src/docs/no-version/what-is-a-devfile.md
+++ b/libs/docs/src/docs/no-version/what-is-a-devfile.md
@@ -10,7 +10,7 @@ adopt existing from [public community registry](https://registry.devfile.io/view
 Certain build tools and IDEs can automatically process the devfile
 to configure, build, and run an application from a development project.
 
-Using devfile, the tools and IDE can:
+Using devfile, the tools or IDE can:
 
 - Take in the repository hosting your application source code.