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