You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kie.apache.org by "tiagobento (via GitHub)" <gi...@apache.org> on 2026/08/17 15:58:13 UTC
[PR] Improve each top-level component's Overview pages [incubator-kie-website]
tiagobento opened a new pull request, #59:
URL: https://github.com/apache/incubator-kie-website/pull/59
## What
Each of the six components — Drools, OptaPlanner, jBPM, Kogito, SonataFlow and
Tools — now has its own section at the site root, with its own sidebar, its own
overview page, and its own branding in the navbar and browser tab.
Before, they were buried a level deep under `/components/<name>` in a single
shared docs section, most of them a single page long, and the pages at
`/drools`, `/jbpm` and friends were client-side redirects into it.
See a preview of the website here: https://tiagobento.github.io/incubator-kie-website/
---
<img width="1798" height="994" alt="image" src="https://github.com/user-attachments/assets/3b22f08e-0939-4c4f-af93-7ba4056cad20" />
---
<img width="1800" height="991" alt="image" src="https://github.com/user-attachments/assets/2066163d-2f8f-4b22-8d27-d9749465aec9" />
---
## Changes
**Structure.** `docs/components/<name>/` becomes `docs/<name>/`, and each gets
an autogenerated sidebar in [sidebars.ts](sidebars.ts). The old `/components/*`
paths — plus the `src/pages/*.tsx` redirect stubs, now deleted — are covered by
static redirects in [docusaurus.config.ts](docusaurus.config.ts), so inbound
links keep working. The navbar's "Components" item becomes a dropdown, and the
footer gains a Components column; both list the components in the same order and
with the same labels as the homepage cards.
**Content.** Every component gets an overview page and a "Get started" page, and
the thin ones get real content: Drools picks up DRL and DMN pages, jBPM a
"What is jBPM", OptaPlanner how-it-works / use-cases / code-example /
compatibility, Kogito a guides index, and Tools a page per tool (KIE Sandbox,
VS Code, Chrome extension, editors, consoles). Book cover and DMN images move
from the docs tree to `static/img/`, where the new pages can share them.
[docs/about/components.md](docs/about/components.md) now links each component to
its section.
**Branding.** Three swizzles, all reading one list of sections in
[src/componentSections.ts](src/componentSections.ts) so the facts can't drift:
- [Navbar/Logo](src/theme/Navbar/Logo/index.tsx) appends a component lockup, so
the navbar reads "Apache KIE / Drools" inside a section.
- [Root.tsx](src/theme/Root.tsx) flies the component's logo as the favicon
across its section. This is why `favicon` is gone from the config — with both
set, two `rel="icon"` links are emitted and the config's won.
- [DocBreadcrumbs](src/theme/DocBreadcrumbs/index.tsx) inserts the section
crumb, so pages read "Home > Drools > Overview" rather than "Home > Overview".
Plus a shared `ComponentBanner` / `FeatureGrid` / `Feature` set for the overview
pages, and — for Kogito only — the hero art and Cinzel display face carried over
from kogito.kie.org, so its overview keeps that site's vibe.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@kie.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@kie.apache.org
For additional commands, e-mail: commits-help@kie.apache.org
Re: [PR] Improve each top-level component's Overview pages [incubator-kie-website]
Posted by "tiagobento (via GitHub)" <gi...@apache.org>.
tiagobento merged PR #59:
URL: https://github.com/apache/incubator-kie-website/pull/59
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@kie.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@kie.apache.org
For additional commands, e-mail: commits-help@kie.apache.org