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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to