Skip to content

docs: restructure navigation - move Data Apps, reorder sections, nest Templates & Orchestrations under Flows#874

Draft
zubednarova wants to merge 3 commits intomainfrom
devin/1770835415-restructure-navigation
Draft

docs: restructure navigation - move Data Apps, reorder sections, nest Templates & Orchestrations under Flows#874
zubednarova wants to merge 3 commits intomainfrom
devin/1770835415-restructure-navigation

Conversation

@zubednarova
Copy link
Contributor

@zubednarova zubednarova commented Feb 11, 2026

Jira issue(s): N/A

Requested by: @zubednarova
Link to Devin run

Changes:

  • Move Data Apps out of Components to a top-level navigation section with new permalink /data-apps/ (was /components/data-apps/). All 12 data-apps subpages updated with redirect_from to preserve old URLs.
  • Reorder main navigation sections to: Home → Keboola Overview → Getting Started Tutorial → Kai → Flows → Data Apps → Components → Data Catalog → Storage → Transformations → Workspaces → Management → AI Features → External Integrations
  • Nest Orchestrations under Flows, placed after Conditional Flows
  • Nest Templates under Flows, placed last (after Orchestrations)
  • Rename "Workspace" to "Workspaces" in the navigation title for consistency with other plural section names
  • Update internal links in overview/index.md, notifications.md, telemetry-data.md, oidc/index.md, and general-design-guide/index.md to use new /data-apps/ paths

Updates since last revision:

  • Resolved merge conflict with main — incorporated the newly added Backend Versions page (components/data-apps/backend-versions/index.md) into the top-level Data Apps nav section with updated permalink (/data-apps/backend-versions/) and redirect_from for the old path.

Notes for reviewer:

  • Image paths inside data-apps markdown files (e.g. ![...](/components/data-apps/some-image.png)) were intentionally not changed — these reference static files on disk, not permalinks, and the files remain in components/data-apps/.
  • Physical file locations were not moved (follows the same redirect_from pattern used for the workspace move).
  • Two external links in templates (help.keboola.com/components/data-apps/) were not updated since redirect_from will handle them on the live site.
  • Pre-existing issue: telemetry-data.md line 145 has a space in the markdown link syntax [data apps] (/data-apps/) — this was present before this PR and is not introduced by these changes.
  • Jekyll build passes cleanly.

Human review checklist:

  • Verify the new top-level section ordering matches expectations
  • Verify Orchestrations is after Conditional Flows and before Templates under Flows
  • Spot-check that old /components/data-apps/... URLs redirect correctly once deployed
  • Verify the new Backend Versions page redirects correctly from its old path
  • Verify image paths in data-apps pages still resolve correctly (files remain in components/data-apps/ on disk)
  • Confirm no other internal links to /components/data-apps/ were missed (grep verified, but worth a second look)

Release Notes

Justification, description

Documentation navigation restructure: Data Apps promoted to top-level, Templates and Orchestrations nested under Flows, sections reordered, "Workspace" renamed to "Workspaces".

Plans for Customer Communication

N/A

Impact Analysis

All old URLs preserved via redirect_from — no broken links expected.

Deployment Plan

N/A

Rollback Plan

N/A

Post-Release Support Plan

N/A

…ections, nest Templates and Orchestrations under Flows

Co-Authored-By: Zuzana Bednářová <zuzana.bednarova@keboola.com>
@devin-ai-integration
Copy link
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@zubednarova
Copy link
Contributor Author

Not sure who is going to be the brave one :D but good luck to us all !

@odinuv
Copy link
Member

odinuv commented Feb 12, 2026

Nevidím v tom problém, ale když už do toho hrabem, tak bych to ještě trochu pročistil:

Home je podle mě k prdu a mohl by se smazat úplně
External Integrations je hrozně divný a opakuje to věci z AI features
AI features bych strčil pod AI Assitant a z větší části rozpustil
Workspace bych dal jako Workspaces (všechno ostatní je taky množný)
Zvážil bych jestli se ta položka v menu musí jmenovat "Kai - AI Assittant" a nemůže tam být jen "AI Assitant"

@zubednarova co ty na to ?

@zubednarova
Copy link
Contributor Author

no action needed from devin:
@odinuv Home k prdu castecne je, protoze mame getting started a overview, ale pak by se muselo taky vymyslet, kam strcit resources a references.

Souhlasim s external integrations - ale netusim, kdo je vlastnikem/zakladatelem a jak moc by davalo smysl vyhodit tuhle sekci, ale vytahnout z toho n8n?

AI features a KAI - nechavam na Jordanovi a Davidovi, byla rosahla debata, jak se KAI bude presne jmenovat atd, takze tady vubec nechci zasahovat, protoze ofiko jmeno by melo byt vsude stejne. @davidesner fyi


devin:
rename Workspace to Workspaces

devin-ai-integration bot and others added 2 commits February 18, 2026 09:44
Co-Authored-By: Zuzana Bednářová <zuzana.bednarova@keboola.com>
…Apps

Co-Authored-By: Zuzana Bednářová <zuzana.bednarova@keboola.com>
@pavel-synek
Copy link
Collaborator

@odinuv , @zubednarova : Tu AI sekci jsem vytvářel před několika měsíci já, páč bylo potřeba AI někde zastřešit. Ale je fakt, že můžeme najít vhodnější cestu, jak to strukturovat. Pokud máte lepší nápad, já se zlobit určitě nebudu. Ale pokud chceme fundamentálně překopat celou strukturu, bylo by dobrý si na to vyblokovat trochu času a v klidu to promyslet.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

Comments