NOISSUE - Update SEO by Musilah · Pull Request #26 · absmach/propeller-website

Musilah · 2026-03-23T13:02:27Z

What type of PR is this?

This is a feature and optimization because it adds SEO/GEO metadata, structured
data, and technical SEO infrastructure to the website.

What does this do?

Adds Schema.org JSON-LD (Organization, SoftwareApplication, WebSite, FAQPage, TechArticle, BreadcrumbList) for Google and AI search engines
Rewrites sitemap with dynamic lastModified, depth-based priority, and
deduplication of the /docs index entry
Adds robots.txt rules for AI crawlers (GPTBot, ClaudeBot, PerplexityBot,
OAI-SearchBot, Google-Extended, FacebookBot)
Adds /public/llms.txt for AI crawler guidance (llms.txt spec)
Extends MDX frontmatter schema with authors and lastModified fields
Adds /about page with mission, values, team, funding, and open-source sections
Adds author registry (src/lib/authors.ts) and DocAttribution component
for docs pages
Adds geo-constants.ts as a single source of truth for brand strings
Updates homepage and docs layout metadata (title template, canonical tags,
OG/Twitter tags)
Updates meta descriptions across 16 MDX docs pages

Which issue(s) does this PR fix/relate to?

N/A

Have you included tests for your changes?

Did you document any new/modified features?

Notes

src/components/json-ld.tsx

src/app/layout.tsx

content/docs/architecture.mdx

content/docs/benchmark.mdx

content/docs/changelog.mdx

ianmuchyri · 2026-04-01T08:41:45Z

public/indexnow-key.txt

@@ -0,0 +1 @@
+REPLACE_WITH_YOUR_INDEXNOW_KEY


what's the purpose of this file?

scripts/indexnow.mjs

src/app/robots.ts

ianmuchyri · 2026-04-01T08:47:53Z

src/app/sitemap.ts

+  return "weekly";
 }

+const EXCLUDED_PATHS = new Set([


The changes in this pages are also not efficient. These links may need to be changed. For sitemaps, just remove the modified time and stick to the Next.js recommendations

ianmuchyri · 2026-04-01T08:48:34Z

src/components/doc-attribution.tsx

@@ -0,0 +1,87 @@
+import Link from "fumadocs-core/link";


What is the purpose of this component?

Its purpose is to show who owns a documentation page and when it was last updated. That gives each page clear maintenance responsibility and a freshness signal, which makes the docs easier to manage internally and more trustworthy for readers. It is also a small reusable pattern, so the same author and last-updated block can be used consistently across other sites.

Is it really necessary?

We already know it's maintained by Abstract Machines. Also I've not seen anywhere else where docs are attributed to a particular author

package.json

Signed-off-by: Musilah <[email protected]>

JeffMboya · 2026-04-09T13:01:16Z

src/lib/structured-data.ts

Remove "CoAP" and "WebSocket" from structured-data.ts, vs-kubeedge.mdx, and about/page.tsx - only MQTT is implemented

JeffMboya · 2026-04-09T13:02:31Z

content/docs/hal.mdx

content/docs/hal.mdx had its description updated in this PR, but it remains unlisted in meta.json. This is a pre-existing omission that the PR touches but doesn't fix - hal.mdx is unreachable from the sidebar navigation.

JeffMboya · 2026-04-09T13:03:29Z

.github/workflows/cd.yaml

cd.yaml includes uses: pnpm/action-setup@v4 in the indexnow job but never runs pnpm install. The script only uses native Node.js fetch with no npm dependencies, so pnpm setup is a no-op noise step.

JeffMboya · 2026-04-09T13:05:21Z

content/docs/meta.json

-    "coco-k8s-setup.mdx"
+    "coco-k8s-setup.mdx",
+    "vs-kubeedge.mdx",
+    "changelog.mdx"


content/docs/meta.json was updated to include "changelog.mdx", but no such file exists in the branch. This will either cause a build error or a dead link in the navigation.

ianmuchyri · 2026-04-09T13:02:43Z

content/docs/vs-kubeedge.mdx

How accurate is this?
@JeffMboya could you please confirm this comparison

ianmuchyri · 2026-04-09T13:06:15Z

src/app/(home)/about/page.tsx

+    <div className="w-full py-12 sm:py-20 lg:py-28 space-y-20">
+      <JsonLd data={organizationSchema()} />
+      <JsonLd data={founderPersonSchema()} />
+      <section className="container mx-auto px-4 sm:px-6 max-w-4xl">


Make use of this white space

ianmuchyri · 2026-04-09T13:08:04Z

src/app/(home)/about/page.tsx

+        </div>
+      </section>
+    </div>
+  );


Add a footer

ianmuchyri · 2026-04-09T13:10:04Z

src/app/sitemap.ts

-      changeFrequency: "weekly",
-      priority: 0.7,
-    });
+function gitLastModified(filePath: string): Date | null {


Do we need all the changes in this page?
Seems like google doesn't use last modified, so I'm wondering if we need this complexity at all

ianmuchyri · 2026-04-09T13:12:04Z

src/components/doc-attribution.tsx

@@ -0,0 +1,87 @@
+import Link from "fumadocs-core/link";


Is it really necessary?

We already know it's maintained by Abstract Machines. Also I've not seen anywhere else where docs are attributed to a particular author

Musilah marked this pull request as ready for review March 24, 2026 09:31

Musilah force-pushed the seo-report branch 2 times, most recently from 56a8491 to 471a22d Compare March 24, 2026 13:41

ianmuchyri requested changes Mar 25, 2026

View reviewed changes

src/components/json-ld.tsx Show resolved Hide resolved

src/app/layout.tsx Outdated Show resolved Hide resolved

ianmuchyri requested changes Apr 1, 2026

View reviewed changes

Musilah added 7 commits April 7, 2026 12:21

update seo

5b49ee9

Signed-off-by: Musilah <[email protected]>

improve layout and remove comments

93231fc

Signed-off-by: Musilah <[email protected]>

improve seo value

01cbca5

Signed-off-by: Musilah <[email protected]>

update SEO to 70%

1c56039

Signed-off-by: Musilah <[email protected]>

update tp pnpm

40ab75c

Signed-off-by: Musilah <[email protected]>

improve docs and resolve comments

4037697

Signed-off-by: Musilah <[email protected]>

remove obsolete comments

7370f8f

Signed-off-by: Musilah <[email protected]>

Musilah force-pushed the seo-report branch from 2f55ec5 to 7370f8f Compare April 7, 2026 09:21

update ci pnpm

2e72b4e

Signed-off-by: Musilah <[email protected]>

Musilah force-pushed the seo-report branch from 43d2aed to 2e72b4e Compare April 7, 2026 09:28

Musilah added 2 commits April 8, 2026 11:34

remove mention of benchmarks in sitemap

0b5cc45

Signed-off-by: Musilah <[email protected]>

improve indexnow

7e08975

Signed-off-by: Musilah <[email protected]>

JeffMboya requested changes Apr 9, 2026

View reviewed changes

ianmuchyri requested changes Apr 9, 2026

View reviewed changes

		@@ -0,0 +1 @@
		REPLACE_WITH_YOUR_INDEXNOW_KEY

Conversation

Musilah commented Mar 23, 2026

What type of PR is this?

What does this do?

Which issue(s) does this PR fix/relate to?

Have you included tests for your changes?

Did you document any new/modified features?

Notes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants