From fec4873df2ff7399e654b4388951e3a3fe8dee88 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 6 Nov 2026 15:34:21 +0000 Subject: [PATCH] Quickstart: which tag for which system, and the two-week-old numbers Step 1 gets a table - 7.50 and newer, 7.02 to 7.4x, ABAP Cloud - with what to pull for each and how a tag is chosen in abapGit, and says that the release GitHub marks Latest is only the one published last: the -702 build of a version is published after the version itself. The sample count leaves the prose (the catalogue counts itself), the tutorial has twelve steps, not ten. /docs/get_started/ answers with the Quickstart instead of a 404, and the site publishes a sitemap. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_014YZFmFUSt4hnK572fuJp8R --- docs/.vitepress/config.mjs | 3 +++ docs/get_started/about.md | 2 +- docs/get_started/quickstart.md | 20 ++++++++++++++++---- docs/public/get_started/index.html | 23 +++++++++++++++++++++++ 4 files changed, 43 insertions(+), 5 deletions(-) create mode 100644 docs/public/get_started/index.html diff --git a/docs/.vitepress/config.mjs b/docs/.vitepress/config.mjs index 1ff6a892..dab03d75 100644 --- a/docs/.vitepress/config.mjs +++ b/docs/.vitepress/config.mjs @@ -46,6 +46,9 @@ export default defineConfig({ * The raw markdown is unaffected: publicDir copies the files regardless of * whether they are also treated as pages. */ srcExclude: ["public/**"], + // /docs/sitemap.xml, one entry per page: the root's robots.txt + // (abap2UI5/abap2UI5.github.io) names it next to the sister sites' ones. + sitemap: { hostname: SITE_URL }, head: [ ["link", { rel: "shortcut icon", href: "/docs/favicon.ico" }], [ diff --git a/docs/get_started/about.md b/docs/get_started/about.md index 46e2c2c2..3dce6aee 100644 --- a/docs/get_started/about.md +++ b/docs/get_started/about.md @@ -30,7 +30,7 @@ A finished app looks like any other UI5 app, because it is one — a selection s ![An abap2UI5 app: a selection form above a table of invoices, with a dialog editing one row](/tutorials/walkthrough-preview.webp) -→ *The [Tutorial](/tutorials/) grows exactly this app in ten steps, each one a complete class you can run in the browser — then takes it to production, and under unit tests* +→ *The [Tutorial](/tutorials/) grows exactly this app in twelve steps, each one a complete class you can run in the browser — then takes it to production, and under unit tests* ## Background Since launching in 2023, abap2UI5 has grown from a small side project into a community-driven framework. The framework absorbs frontend complexity, so you can focus on business logic with your existing ABAP skills. Each app ships as an [abapGit](https://abapgit.org) project, so installation across systems needs no separate frontend deployment. diff --git a/docs/get_started/quickstart.md b/docs/get_started/quickstart.md index df6110ba..1f2ded33 100644 --- a/docs/get_started/quickstart.md +++ b/docs/get_started/quickstart.md @@ -12,7 +12,7 @@ No system at hand? Two ways to see abap2UI5 run before anything is installed: framework in your browser: write ABAP on the left, watch the app run on the right, nothing to install. - The [**sample catalog**](https://abap2ui5.github.io/samples-site/) - lists over 700 working apps, each with its ABAP printed in full and a + lists hundreds of working apps, each with its ABAP printed in full and a button that runs it - a live demo of every pattern the cookbook describes. Both are also where to send a colleague who wants to see it before reading on. @@ -35,9 +35,21 @@ Four things the three steps below assume: ## 1. Install the Framework via abapGit Pull [abap2UI5](https://github.com/abap2UI5/abap2UI5) with -[abapGit](https://abapgit.org). For anything beyond a first look, pull a -[release](https://github.com/abap2UI5/abap2UI5/releases/) rather than `main` — -see [Productive Usage](/configuration/productive_usage) for why. +[abapGit](https://abapgit.org). Which branch or tag depends on the system: + +| Your system | What to pull | Where it is explained | +| --- | --- | --- | +| ABAP 7.50 or newer, on premise or private cloud | The newest tag without a suffix, `X.Y.Z` - or `main` for a first look | [Versioning](/configuration/versioning) | +| ABAP 7.02 to 7.4x | The same version with the suffix `-702`, `X.Y.Z-702` - a downported build of the same release | [Downporting](/advanced/downporting) | +| BTP ABAP Environment or S/4 Public Cloud | The newest tag without a suffix, with abapGit for Eclipse | [S/4 Public Cloud](/configuration/s4_public_cloud) | + +On the [releases page](https://github.com/abap2UI5/abap2UI5/releases/) every +version appears twice, once with the suffix and once without; the one GitHub +marks *Latest* is not the newer, only the one published last. In abapGit a tag +is chosen on the repository's page: *Branch* → *Switch* → *Tags*, or the tag +typed into the *Branch* field of the online repository. For anything beyond a +first look, pull a tag rather than `main` - see +[Productive Usage](/configuration/productive_usage) for why. ![abapGit repository installation screen for abap2UI5](/get_started/image.webp) diff --git a/docs/public/get_started/index.html b/docs/public/get_started/index.html new file mode 100644 index 00000000..bda6a213 --- /dev/null +++ b/docs/public/get_started/index.html @@ -0,0 +1,23 @@ + + + + + + Page moved - abap2UI5 + + + + + + +

+ Getting started with abap2UI5 begins at the + Quickstart. +

+ +