Przejdź do głównej zawartości

Dziennik zmian dokumentacji — PDF Connect v3

2026-02-21 Aktualizacja: Ręczne bloki URL​

  • Dodano nowy przewodnik: manual-url-blocks.md
  • Zaktualizowano dokumentację publikowania/konfiguracji/przeglądarki/wyświetlania w celu uwzględnienia ręcznych bloków szablonów produktów
  • Dodano wyjaśnienia dotyczące różnic między blokami połączonymi a ręcznymi
  • Dodano wskazówki dotyczące rozwiązywania problemów specyficznych dla trybu ręcznego
  • Zaktualizowano nawigację boczną o nowy przewodnik

Przegląd​

Niniejszy dziennik śledzi kompletną renowację dokumentacji dla PDF Connect v3, która wprowadziła uniwersalne łączenie stron, ulepszone przepływy pracy przy publikowaniu oraz poprawione UI/UX.

Legenda statusów​

  • ✅ Ukończone — Plik zaktualizowany z funkcjami v3, gotowy na nowe zrzuty ekranu
  • 🔄 W trakcie — Plik jest aktualizowany
  • ❌ Wymaga aktualizacji — Stary plik wymagający renowacji do v3
  • 📸 Potrzebne zrzuty ekranu — Zaktualizowana treść gotowa na nowe obrazy

Zaktualizowane pliki (v3)​

Główne przewodniki — UKOŃCZONE ✅​

intro-v3.md ✅​

  • Status: Ukończony, potrzebne zrzuty ekranu
  • Zmiany:
    • Zaktualizowano opis trzech stylów wyświetlania (Osadzony PDF, Przycisk PDF, Lista PDF)
    • Dodano możliwości uniwersalnego łączenia (wszystkie typy stron)
    • Podkreślono uproszczony dwuetapowy przepływ pracy przy publikowaniu
    • Dodano przykłady sukcesów i propozycje wartości biznesowej
  • Stary plik: intro.md → intro-old.md
  • Potrzebne zrzuty ekranu: 8 kluczowych zrzutów ekranu wskazanych w SCREENSHOT_REQUIREMENTS.md

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

  • Status: Ukończony, potrzebne zrzuty ekranu
  • Zmiany:
    • Całkowite przepisanie dla uniwersalnego łączenia (wszystkie typy stron)
    • Ulepszone funkcje wyszukiwania, paginacji i zaznaczania zbiorczego
    • Dodano strategie łączenia między stronami i rozwiązywanie problemów
    • Strategiczne rozmieszczenie zastępczych zrzutów ekranu
  • Stary plik: tutorial-basics/link-pdfs.md → tutorial-basics/link-pdfs-old.md
  • Potrzebne zrzuty ekranu: 12 kluczowych zrzutów ekranu wskazanych

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

  • Status: Ukończony, potrzebne zrzuty ekranu
  • Zmiany:
    • Zaktualizowano w celu odzwierciedlenia nowego systemu modali publikowania
    • Dodano trzy odrębne style wyświetlania ze szczegółowymi przypadkami użycia
    • Ulepszone strategie wyboru szablonów i wielu bloków
    • Sekcje optymalizacji wydajności i rozwiązywania problemów
  • Stary plik: tutorial-basics/place-linked-pdf.md → tutorial-basics/place-linked-pdf-old.md
  • Potrzebne zrzuty ekranu: 15 kluczowych zrzutów ekranu wskazanych

publishing-workflow-v3.md ✅​

  • Status: Nowy plik, ukończony, potrzebne zrzuty ekranu
  • Cel: Kompleksowy przewodnik po nowym systemie publikowania
  • Zawartość:
    • Szczegółowe najlepsze praktyki i rozwiązywanie problemów
    • Strategie zarządzania szablonami
    • Optymalizacja wydajności i UX
  • Potrzebne zrzuty ekranu: 8 zrzutów ekranu specyficznych dla przepływu pracy wskazanych

Pliki wymagające aktualizacji ❌​

Podstawy samouczka​

  • tutorial-basics/upload-a-pdf.md ❌ — Wymaga aktualizacji UI do v3
  • tutorial-basics/account-and-subscription.md ❌ — Prawdopodobnie bez zmian
  • tutorial-basics/paste-pdf-id.md ❌ — Może być starszą funkcją
  • tutorial-basics/place-non-prd-page.md ❌ — Zastąpiony przez uniwersalne łączenie
  • tutorial-basics/place-linked-pdf-legacy.md ❌ — Starsza metoda, może zostać zarchiwizowana

Dodatkowe samouczki​

  • tutorial-extras/link-pdfs-bulk.md ❌ — Wymaga aktualizacji UI zbiorczego v3
  • tutorial-extras/external-pdfs.md ❌ — Wymaga aktualizacji interfejsu v3
  • tutorial-extras/pdf-viewers.md ❌ — Wymaga opcji przeglądarki v3
  • tutorial-extras/using-tags.md ❌ — Wymaga interfejsu tagów v3
  • tutorial-extras/translate-your-site.md ❌ — Prawdopodobnie bez zmian

Sekcja starszych funkcji​

  • legacy/button-designer.md ❌ — Zastąpiony przez bloki edytora motywu
  • legacy/pdf-placement.md ❌ — Zastąpiony przez przepływ pracy publikowania

Wymagania dotyczące zrzutów ekranu​

Priorytet 1 — Główny przepływ pracy 📸​

  1. Przegląd aplikacji: Główny interfejs zarządzania plikami PDF
  2. Interfejs łączenia: Nowe menu rozwijane typów stron i ich wybór
  3. Modal publikowania: Trzy opcje stylów wyświetlania
  4. Edytor motywu: Dodawanie bloków PDF do szablonów
  5. Wybór zasobów: Wyszukiwanie i paginacja w działaniu

Priorytet 2 — Zaawansowane funkcje 📸​

  1. Szablony z wieloma blokami: Przykłady różnych stylów na tej samej stronie
  2. Operacje zbiorcze: Interfejs importu z arkusza kalkulacyjnego
  3. Ustawienia i personalizacja: Opcje konfiguracji bloków
  4. Widoki mobilne: Sposób wyświetlania plików PDF na urządzeniach mobilnych
  5. Narzędzia wydajności: Funkcje analityki i optymalizacji

Priorytet 3 — Przypadki użycia 📸​

  1. Przykład instrukcji produktu: Osadzony PDF na stronie produktu
  2. Katalog kolekcji: Lista PDF na stronie kolekcji
  3. Zasób bloga: Przycisk PDF na stronie artykułu
  4. Funkcja strony głównej: Integracja PDF na stronie głównej
  5. Stany błędów: Co użytkownicy widzą, gdy coś pójdzie nie tak

Uwagi do sesji fotograficznej​

Elementy interfejsu do uchwycenia:​

  • Nowe menu rozwijane i interfejsy wyboru
  • Ulepszone modale z poprawionym UX
  • Punkty integracji z edytorem motywu
  • Responsywne widoki mobilne
  • Stany błędów i ładowania

Przykłady treści do przygotowania:​

  • Przykładowe pliki PDF z realistycznymi nazwami i opisami
  • Testowe produkty, kolekcje, artykuły, strony
  • Różne rozmiary i typy PDF
  • Konfiguracja testowania na urządzeniach mobilnych

Porównania przed/po:​

  • Stary vs. nowy interfejs łączenia
  • Starsze umieszczanie vs. bloki edytora motywu
  • Łączenie tylko z produktami vs. łączenie uniwersalne
  • Jeden styl wyświetlania vs. wiele opcji

Strategia migracji​

Faza 1: Główna dokumentacja ✅​

  • Aktualizacja głównych przewodników po przepływie pracy
  • Tworzenie kompleksowej dokumentacji funkcji
  • Ustanowienie nowej konwencji nazewnictwa plików

Faza 2: Szczegółowe przewodniki 🔄​

  • Aktualizacja przewodników dotyczących przesyłania i kont
  • Renowacja dokumentacji operacji zbiorczych
  • Aktualizacja przewodników dotyczących zewnętrznych PDF i przeglądarek

Faza 3: Zarządzanie starszymi funkcjami 📋​

  • Archiwizacja zastąpionych funkcji
  • Tworzenie przewodników migracji dla istniejących użytkowników
  • Aktualizacja nawigacji i odsyłaczy

Faza 4: Ulepszenia wizualne 📸​

  • Koordynacja sesji zrzutów ekranu
  • Zastąpienie wszystkich zastępczych obrazów
  • Dodanie samouczków wideo dla złożonych przepływów pracy
  • Testowanie dokumentacji z prawdziwymi sprzedawcami

Wdrożony system renowacji dokumentacji ✅​

Strategia zarządzania plikami​

  • Konwencja nazewnictwa: Wszystkie nowe pliki używają sufiksu -v3 dla łatwej identyfikacji
  • Zachowanie starych plików: Oryginalne pliki przemianowane z sufiksem -old dla odwołań
  • Śledzenie zmian: Kompletny dziennik zmian ze statusami i wymaganiami dotyczącymi zrzutów ekranu

Strategia zarządzania obrazami​

  • Usunięto stare obrazy: Wszystkie nieaktualne zrzuty ekranu usunięte z dokumentacji
  • Strategiczne symbole zastępcze: [POTRZEBNY ZRZUT EKRANU: Opis] umieszczone tam, gdzie obrazy dodają wartość
  • Dokumentacja wymagań: Kompleksowe wymagania dotyczące zrzutów ekranu w dedykowanym pliku
  • System priorytetów: Trójpoziomowy system priorytetów dla zrzutów ekranu

Proces zapewnienia jakości​

  • Przegląd treści: Wszystkie pliki v3 sprawdzone pod kątem dokładności i kompletności
  • Walidacja linków: Wewnętrzne linki zaktualizowane do wersji v3
  • Sprawdzanie spójności: Jednolite formatowanie i terminologia we wszystkich plikach
  • Dostępność: Zaplanowane wymagania dotyczące tekstu alternatywnego i opisowych symboli zastępczych

Pomyślnie odnowione pliki​

Główna dokumentacja ✅​

  1. intro-v3.md — Główne wprowadzenie z funkcjami v3
  2. tutorial-basics/link-pdfs-v3.md — Przewodnik po uniwersalnym łączeniu
  3. tutorial-basics/place-linked-pdf-v3.md — Ulepszony przewodnik po publikowaniu
  4. publishing-workflow-v3.md — Kompleksowy przewodnik po przepływie pracy

Dokumentacja pomocnicza ✅​

  1. DOCUMENTATION_CHANGELOG.md — Śledzenie zmian i statusów
  2. SCREENSHOT_REQUIREMENTS.md — Planowanie treści wizualnych

Pliki kolejnej fazy (planowane)​

  • getting-started-v3.md — Nowoczesny przewodnik wdrożeniowy
  • advanced-features-v3.md — Funkcje dla zaawansowanych użytkowników
  • tutorial-basics/upload-a-pdf-v3.md — Zaktualizowany proces przesyłania
  • tutorial-extras/link-pdfs-bulk-v3.md — Ulepszone operacje zbiorcze

To systematyczne podejście zapewnia:

  • Zerową utratę treści: Zachowanie całej oryginalnej zawartości
  • Przejrzyste śledzenie postępów: Łatwe rozróżnienie co jest gotowe, a co wymaga pracy
  • Profesjonalną jakość: Spójna, nowoczesna dokumentacja
  • Gotowość na przyszłość: Skalowalny system dla bieżących aktualizacji

Mierniki sukcesu​

Jakość dokumentacji:​

  • Wszystkie funkcje v3 udokumentowane w sposób kompleksowy
  • Przejrzysta ścieżka migracji z v2 do v3
  • Zmniejszona liczba zgłoszeń do pomocy technicznej dotyczących nowych funkcji
  • Pozytywne opinie sprzedawców na temat przejrzystości

Ulepszenia wizualne:​

  • Nowoczesne zrzuty ekranu odzwierciedlające bieżący UI
  • Spójny język wizualny we wszystkich przewodnikach
  • Dokumentacja zoptymalizowana pod kątem urządzeń mobilnych
  • Uzupełnienia wideo dla złożonych przepływów pracy

Ta renowacja zapewni, że nasza dokumentacja dorówna jakością i dopracowaniem nowym funkcjom PDF Connect v3.