Skip to content

PosDealers pages updates, fixes, and improvements - part 1 - #180

Open
deboragracio wants to merge 21 commits into
mainfrom
claude/dev-docs-rewrite-76355b
Open

deboragracio wants to merge 21 commits into
mainfrom
claude/dev-docs-rewrite-76355b

Conversation

@deboragracio

@deboragracio deboragracio commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

Introduction and Business Basics pages

  • posdealers/introduction.md: prerequisites table, recommended path, section overview, reading-by-role table, troubleshooting map.

  • posdealers/business-basics/overview-business-basics.md: section page table, prerequisites as list, links to Sandbox and My First Cashbox.

  • posdealers/business-basics/business-model.md: advantages converted to tables; wording tightened.

  • posdealers/business-basics/customer-roles.md: summary box, role overview table, link to Company Roles; grammar and spelling (IPOS interface, POS System).

  • posdealers/business-basics/services.md: service overview and deployment tables; fixed broken bold markup; links to product pages.

  • posdealers/business-basics/countries.md: split into introduction and country-specific Portals; description no longer limited to AT/FR/DE.

  • posdealers/business-basics/architecture.md: component and Launcher tables, launcher start sequence; links to Middleware pages. Anchors #queue, #scu kept.

  • posdealers/business-basics/management-portal.md: task table, account management as steps, links to detail pages.

  • posdealers/business-basics/legal-data-protection/fair-use-policy.md: title "Fair Use Policy", wording, description.

  • Fact fixes against fiskaltrust source repos (release-notes, middleware, middleware-launcher, service-portal-ui):

    • introduction.md: removed troubleshooting row for Metrics > CashBox (menu no longer in Portal).
    • services.md, architecture.md: interface gRPC/REST/SOAP; configuration fetched by the Launcher at start, applied after restart; Helipad uploads data; Helm chart = DE Bring your own data center; AT/FR on Middleware 1.2; Launcher 2.0 RC.
    • management-portal.md: current Portal labels (Company info, top-right user menu, PosDealer, Configuration items, surrogating permissions); Tools > Exports with export targets instead of data replication; Launcher download in CashBoxes list.
    • _markets/*/overview/countries/_contact.mdx: Portal and Sandbox URLs for all nine markets; product links to fiskaltrust.eu.
    • _markets/{at,de,fr}/overview/business-model/_sales.mdx, _markets/at/.../_fair-use-policy.mdx: replaced links that redirect to the homepage; AT fair use links the local PDF.
  • AGENTS.md: conventions for Portal labels (backticks, > paths, Portal capitalization) and bold-not-italic emphasis.

  • Style: Portal labels in backticks, bold instead of italic emphasis, "POS system" lowercase, no ## Introduction headings.

  • business-model.md, architecture.md: Figure 1 replaced with new SVG diagrams (images/business-model.svg, images/architecture.svg); old PNGs removed; alt text and captions updated.

  • management-portal.md: Figure 1 replaced with a current Portal screenshot (test e-mail and company name, frame cropped); new User Menu subsection with Figure 2 (images/user-menu.png, shown at 321 px); label Change username per the Portal UI.

  • AGENTS.md: docs must match the UI labels; cross-references use "For more information, see ...".

  • PosDealer pages in this PR: bare "See [...]" references changed to "For more information, see [...]".

Content sourced from existing pages only; links and anchors verified.

🤖 Generated with Claude Code

Add prerequisites, recommended path, section overview and troubleshooting tables.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@deboragracio
deboragracio requested review from a team as code owners October 8, 2026 12:22
@deboragracio deboragracio changed the title Restructure PosDealer introduction page PosDealers pages Oct 8, 2026
deboragracio and others added 3 commits October 8, 2026 14:36
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@deboragracio deboragracio changed the title PosDealers pages PosDealers pages updates, fixes, and improvements Oct 8, 2026
@deboragracio deboragracio changed the title PosDealers pages updates, fixes, and improvements PosDealers pages updates, fixes, and improvements - part 1 Oct 8, 2026
deboragracio and others added 3 commits October 8, 2026 15:53
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: deboragracio <63159404+deboragracio@users.noreply.github.com>
deboragracio and others added 6 commits October 8, 2026 16:53
…s to AGENTS.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Corrected capitalization of 'Master data' and removed redundant title.
Updated the title and removed unnecessary details from the customer roles documentation.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: deboragracio <63159404+deboragracio@users.noreply.github.com>
deboragracio and others added 5 commits October 9, 2026 15:22
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ing labels in AGENTS.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…p URL tooltip

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: deboragracio <63159404+deboragracio@users.noreply.github.com>
@deboragracio

deboragracio commented Oct 9, 2026 •

Copy link
Copy Markdown
Collaborator Author

Open questions:

  • Business Model > Attractive volume discounts
    Claim: Volume discounts start from low purchase quantities.
    Source shows: Buy & Resell says ten or more bundles; no threshold in sources.
    Check w/ Sales team.

  • Services > Hosted Middleware
    Claim: Hosted Middleware in "some countries", managed exclusively in the Portal.
    Source shows: CloudCashbox code has packages for BE, ES, GR, PT and EU; Germany has a migration path; no country list or "exclusively" statement.
    Check w/ Product (Middleware) team.

  • Services > Revision-Safe Receipt Archive
    Claim: Archive service is an optional, chargeable add-on, retrievable at any time.
    Source shows: Confirmed only in 2021 Portal notes (PosArchive, FR ArchiveAuditable); current product name unknown.
    Check w/ Product team.

  • Services > Signing
    Claim: Signing via leased dongles or SaaS.
    Source shows: fiskaly, Swissbit, Deutsche Fiskal, A-Trust, Epson and Custom RT active in 2026; Cryptovision and Diebold Nixdorf last seen 2023.
    Check w/ Product team.

  • Fair Use Policy > France
    Claim: France has no fair use policy (FR tab). Only the docs tab says so.
    Check w/ Legal/French team.

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.

2 participants