Ga naar hoofdinhoud

Documentatie-wijzigingslogboek - PDF Connect v3

2026-02-21 Update: handmatige URL-blokken​

  • Nieuwe handleiding toegevoegd: manual-url-blocks.md
  • Documentatie voor publiceren, setup, viewer en weergave bijgewerkt om handmatige producttemplate-blokken te documenteren
  • Verduidelijkingen toegevoegd voor gedrag van gekoppelde vs handmatige blokken
  • Handmatige troubleshooting-checks (specifiek voor handmatige blokken) toegevoegd
  • Sidebar-navigatie bijgewerkt met de nieuwe handleiding

Overzicht​

Dit changelog volgt de volledige documentatie-renovatie voor PDF Connect v3, waarin universeel paginakoppelen, verbeterde publicatieworkflows en verbeterde UI/UX zijn geïntroduceerd.

Statuslegenda​

  • ✅ Voltooid - Bestand bijgewerkt met v3-functies en klaar voor nieuwe screenshots
  • 🔄 In uitvoering - Bestand wordt bijgewerkt
  • ❌ Update nodig - Oud bestand dat v3-renovatie nodig heeft
  • 📸 Screenshots nodig - Inhoud is bijgewerkt en klaar voor nieuwe afbeeldingen

Bijgewerkte bestanden (v3)​

Kernhandleidingen - VOLTOOID ✅​

intro-v3.md ✅​

  • Status: Voltooid, screenshots nodig
  • Wijzigingen:
    • Bijgewerkt om drie weergavestijlen te beschrijven (Embedded PDF, PDF-knop, PDF-lijst)
    • Universele koppelmogelijkheden toegevoegd (alle paginatypen)
    • Gestroomlijnde publicatieworkflow in twee stappen benadrukt
    • Succesverhalen en zakelijke waardeproposities toegevoegd
  • Oud bestand: intro.md → intro-old.md
  • Screenshots nodig: 8 kernscreenshots geïdentificeerd in SCREENSHOT_REQUIREMENTS.md

tutorial-basics/link-pdfs-v3.md ✅​

  • Status: Voltooid, screenshots nodig
  • Wijzigingen:
    • Volledige herschrijving voor universeel koppelen (alle paginatypen)
    • Verbeterde zoek-, paginatie- en bulkselectiefuncties
    • Strategieën voor koppelen over meerdere paginatypen en troubleshooting toegevoegd
    • Strategische plaatsing van screenshot-placeholders
  • Oud bestand: tutorial-basics/link-pdfs.md → tutorial-basics/link-pdfs-old.md
  • Screenshots nodig: 12 kernscreenshots geïdentificeerd

tutorial-basics/place-linked-pdf-v3.md ✅​

  • Status: Voltooid, screenshots nodig
  • Wijzigingen:
    • Bijgewerkt voor het nieuwe publicatiemodal-systeem
    • Drie duidelijke weergavestijlen met gedetailleerde use-cases toegevoegd
    • Verbeterde templateselectie en multi-blokstrategieën
    • Secties voor performance-optimalisatie en troubleshooting toegevoegd
  • Oud bestand: tutorial-basics/place-linked-pdf.md → tutorial-basics/place-linked-pdf-old.md
  • Screenshots nodig: 15 kernscreenshots geïdentificeerd

publishing-workflow-v3.md ✅​

  • Status: Nieuw bestand, voltooid, screenshots nodig
  • Doel: Uitgebreide workflowgids voor het nieuwe publicatiesysteem
  • Inhoud:
    • Gedetailleerde best practices en troubleshooting
    • Strategieën voor templatebeheer
    • Performance- en UX-optimalisatie
  • Screenshots nodig: 8 workflow-specifieke screenshots geïdentificeerd

Bestanden die updates nodig hebben ❌​

Tutorial Basics​

  • tutorial-basics/upload-a-pdf.md ❌ - v3 UI-updates nodig
  • tutorial-basics/account-and-subscription.md ❌ - Waarschijnlijk ongewijzigd
  • tutorial-basics/paste-pdf-id.md ❌ - Mogelijk legacyfunctie
  • tutorial-basics/place-non-prd-page.md ❌ - Vervangen door universeel koppelen
  • tutorial-basics/place-linked-pdf-legacy.md ❌ - Legacymethode, mogelijk archiveren

Tutorial Extras​

  • tutorial-extras/link-pdfs-bulk.md ❌ - v3 UI-updates voor bulk nodig
  • tutorial-extras/external-pdfs.md ❌ - v3 interface-updates nodig
  • tutorial-extras/pdf-viewers.md ❌ - v3 vieweropties nodig
  • tutorial-extras/using-tags.md ❌ - v3 tag-interface nodig
  • tutorial-extras/translate-your-site.md ❌ - Waarschijnlijk ongewijzigd

Legacy-sectie​

  • legacy/button-designer.md ❌ - Vervangen door themablokken in editor
  • legacy/pdf-placement.md ❌ - Vervangen door publicatieworkflow

Screenshotvereisten​

Prioriteit 1 - Kernworkflow 📸​

  1. App-overzicht: Hoofdinterface voor PDF-beheer
  2. Koppelinterface: Nieuwe dropdown voor paginatype en selectie
  3. Publicatiemodal: Drie opties voor weergavestijl
  4. Thema-editor (Theme Editor): PDF-blokken toevoegen aan templates
  5. Resource-selectie: Zoek- en paginatiefunctie in gebruik

Prioriteit 2 - Geavanceerde functies 📸​

  1. Multi-bloktemplates: Voorbeelden van verschillende stijlen op dezelfde pagina
  2. Bulkoperaties: Spreadsheet-importinterface
  3. Instellingen & maatwerk: Configuratieopties voor blokken
  4. Mobiele weergaven: Hoe PDF’s eruitzien op mobiele apparaten
  5. Performance-tools: Analytics- en optimalisatiefuncties

Prioriteit 3 - Use-cases 📸​

  1. Voorbeeld producthandleiding: Embedded PDF op productpagina
  2. Collectiecatalogus: PDF-lijst op collectiepagina
  3. Blogresource: PDF-knop op artikelpagina
  4. Homepage-feature: PDF-integratie op indexpagina
  5. Foutstatussen: Wat gebruikers zien als iets misgaat

Opmerkingen voor de fotosessie​

Interface-elementen om vast te leggen:​

  • Nieuwe dropdownmenu’s en selectie-interfaces
  • Verbeterde modals met betere UX
  • Integratiepunten in de theme editor
  • Mobiel-responsieve weergaven
  • Fout- en laadstatussen

Inhoud om voor te bereiden:​

  • Voorbeeld-PDF’s met realistische namen/beschrijvingen
  • Testproducten, collecties, artikelen en pagina’s
  • Verschillende PDF-groottes en -typen
  • Setup voor mobiel testen

Voor/na-vergelijkingen:​

  • Oude vs nieuwe koppelinterface
  • Legacy-plaatsing vs themablokken in editor
  • Alleen product vs universeel koppelen
  • Eén weergavestijl vs meerdere opties

Migratiestrategie​

Fase 1: Kerndocumentatie ✅​

  • Hoofdworkflows bijgewerkt
  • Uitgebreide functiedocumentatie gemaakt
  • Nieuwe naamgevingsconventie vastgesteld

Fase 2: Detailhandleidingen 🔄​

  • Upload- en accounthandleidingen bijwerken
  • Documentatie voor bulkoperaties renoveren
  • Handleidingen voor externe PDF’s en viewers bijwerken

Fase 3: Legacybeheer 📋​

  • Vervangen functies archiveren
  • Migratiehandleidingen maken voor bestaande gebruikers
  • Navigatie en kruisverwijzingen bijwerken

Fase 4: Visuele verbetering 📸​

  • Screenshotsessie plannen en uitvoeren
  • Alle placeholder-afbeeldingen vervangen
  • Videotutorials toevoegen voor complexe workflows
  • Documentatie testen met echte merchants

Geïmplementeerd renovatiesysteem voor documentatie ✅​

Strategie voor bestandsbeheer​

  • Naamgevingsconventie: Alle nieuwe bestanden gebruiken suffix -v3 voor snelle herkenning
  • Behoud oude bestanden: Originele bestanden hernoemd met suffix -old als referentie
  • Wijzigingstracking: Volledig changelog met statusupdates en screenshotvereisten

Strategie voor beeldbeheer​

  • Oude afbeeldingen verwijderd: Alle verouderde screenshots uit documentatie verwijderd
  • Strategische placeholders: [SCREENSHOT NEEDED: Description] toegevoegd waar beelden waarde toevoegen
  • Vereistendocumentatie: Uitgebreide screenshotvereisten in een apart bestand
  • Prioriteitssysteem: Drie lagen prioriteit voor screenshot-opname

Kwaliteitsborgingsproces​

  • Contentreview: Alle v3-bestanden beoordeeld op juistheid en volledigheid
  • Linkvalidatie: Interne links bijgewerkt naar v3-versies
  • Consistentiecheck: Eenduidige opmaak en terminologie over alle bestanden
  • Toegankelijkheid: Vereisten voor alt-tekst en beschrijvende placeholders opgenomen

Succesvol gerenoveerde bestanden​

Kerndocumentatie ✅​

  1. intro-v3.md - Hoofdintroductie met v3-functies
  2. tutorial-basics/link-pdfs-v3.md - Handleiding voor universeel koppelen
  3. tutorial-basics/place-linked-pdf-v3.md - Verbeterde publicatiehandleiding
  4. publishing-workflow-v3.md - Uitgebreide workflowhandleiding

Ondersteunende documentatie ✅​

  1. DOCUMENTATION_CHANGELOG.md - Wijzigingstracking en status
  2. SCREENSHOT_REQUIREMENTS.md - Planning voor visuele content

Bestanden voor volgende fase (gepland)​

  • getting-started-v3.md - Moderne onboardinghandleiding
  • advanced-features-v3.md - Functies voor power users
  • tutorial-basics/upload-a-pdf-v3.md - Bijgewerkt uploadproces
  • tutorial-extras/link-pdfs-bulk-v3.md - Verbeterde bulkoperaties

Deze systematische aanpak zorgt voor:

  • Geen contentverlies: Alle originele content blijft behouden
  • Duidelijke voortgang: Meteen zichtbaar wat klaar is en wat nog moet
  • Professionele kwaliteit: Consistente, moderne documentatiestandaarden
  • Toekomstbestendig: Schaalbaar systeem voor doorlopende updates

Succesmetingen​

Documentatiekwaliteit:​

  • Alle v3-functies volledig gedocumenteerd
  • Duidelijke migratieroute van v2 naar v3
  • Minder supporttickets over nieuwe functies
  • Positieve merchant-feedback over duidelijkheid

Visuele verbetering:​

  • Moderne screenshots die huidige UI weerspiegelen
  • Consistente visuele stijl in alle handleidingen
  • Mobiel-geoptimaliseerde documentatie-ervaring
  • Videotutorials als aanvulling op complexe workflows

Deze renovatie zorgt ervoor dat de documentatie aansluit op het kwaliteitsniveau en de volwassenheid van de nieuwe PDF Connect v3-functies.