From 7203a81af79f73668e476d2a58b5f0da1c5a4cd6 Mon Sep 17 00:00:00 2001 From: Michael Date: Tue, 2 Jun 2026 17:09:52 +0000 Subject: [PATCH] copy: strip jargon from tool descriptions and captions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Prior round only touched page_caption; the description field (shown on home grid cards) still said "imputation", "missingness", "winsorization", "schema coercion", "fuzzy matching with normalization", etc. The audience is non-technical buyers — they shouldn't need a stats or DB-admin vocabulary to read a tool card. Rewrite both description and page_caption across en, es, and the tools_registry (the fallback source of truth) using everyday words: blanks instead of nulls, fill in instead of impute, look wrong instead of statistical outliers, etc. Same one-line shape as before. Co-Authored-By: Claude Opus 4.7 (1M context) --- src/gui/pages/11_Reconciler.py | 2 +- src/gui/tools_registry.py | 40 ++++++++++++++++++++-------------- src/i18n/packs/en.json | 40 +++++++++++++++++----------------- src/i18n/packs/es.json | 40 +++++++++++++++++----------------- 4 files changed, 65 insertions(+), 57 deletions(-) diff --git a/src/gui/pages/11_Reconciler.py b/src/gui/pages/11_Reconciler.py index 8ef9504..1550af6 100644 --- a/src/gui/pages/11_Reconciler.py +++ b/src/gui/pages/11_Reconciler.py @@ -40,7 +40,7 @@ log_page_open("11_Reconciler") st.title("Reconcile Two Files") st.caption( - "Match two lists of transactions (e.g. bank vs. ledger) and flag what doesn't line up." + "Compare two lists of transactions (e.g. bank vs. ledger) and flag what doesn't match." ) diff --git a/src/gui/tools_registry.py b/src/gui/tools_registry.py index 603e6ed..c9612ca 100644 --- a/src/gui/tools_registry.py +++ b/src/gui/tools_registry.py @@ -52,7 +52,8 @@ TOOLS: list[Tool] = [ icon=":material/help_outline:", name="Fix Missing Values", description=( - "Detect disguised nulls, missingness analysis, and imputation strategies." + "Find blank cells (even ones written as 'N/A' or '?') and fill " + "them in or remove them." ), page_slug="4_Missing_Values", status="Ready", @@ -63,8 +64,8 @@ TOOLS: list[Tool] = [ icon=":material/insights:", name="Find Unusual Values", description=( - "Z-score, IQR, and MAD detection with domain-rule violations and " - "winsorization." + "Spot values that look wrong — way too high, way too low, or " + "breaking your rules." ), page_slug="6_Outlier_Detector", status="Coming Soon", @@ -75,8 +76,8 @@ TOOLS: list[Tool] = [ icon=":material/text_format:", name="Clean Text", description=( - "Whitespace trim, multi-space collapse, Unicode normalization, " - "BOM and line-ending handling." + "Trim extra spaces and strip out odd characters that copy-paste " + "leaves behind." ), page_slug="2_Text_Cleaner", status="Ready", @@ -87,7 +88,8 @@ TOOLS: list[Tool] = [ icon=":material/format_list_bulleted:", name="Standardize Formats", description=( - "Standardize dates, currencies, names, phone numbers, and addresses." + "Make dates, phone numbers, currency, names, and addresses look " + "the same throughout." ), page_slug="3_Format_Standardizer", status="Ready", @@ -98,8 +100,7 @@ TOOLS: list[Tool] = [ icon=":material/search:", name="Find Duplicates", description=( - "Fuzzy matching, normalization, survivor selection, and " - "interactive review." + "Find rows that repeat — exact and similar — and remove the extras." ), page_slug="1_Deduplicator", status="Ready", @@ -110,7 +111,8 @@ TOOLS: list[Tool] = [ icon=":material/check_circle:", name="Quality Check", description=( - "Validate against rules and generate PDF/Excel quality reports." + "Check your file against rules you set, and export a PDF or " + "Excel report." ), page_slug="8_Validator_Reporter", status="Coming Soon", @@ -120,7 +122,10 @@ TOOLS: list[Tool] = [ tool_id="05_column_mapper", icon=":material/view_column:", name="Map Columns", - description="Rename columns, enforce a target schema, and coerce types.", + description=( + "Rename columns, change their order, and set each one as text, " + "number, or date." + ), page_slug="5_Column_Mapper", status="Ready", section="transformations", @@ -129,7 +134,10 @@ TOOLS: list[Tool] = [ tool_id="07_multi_file_merger", icon=":material/account_tree:", name="Combine Files", - description="Combine multiple CSV/Excel files with schema alignment.", + description=( + "Combine several CSV or Excel files into one — even if their " + "columns don't match." + ), page_slug="7_Multi_File_Merger", status="Coming Soon", section="transformations", @@ -139,7 +147,8 @@ TOOLS: list[Tool] = [ icon=":material/auto_awesome:", name="Automated Workflows", description=( - "Chain tools in recommended order and pass output between steps." + "Run several tools in a row — save the steps once, reuse them " + "anytime." ), page_slug="9_Pipeline_Runner", status="Ready", @@ -150,8 +159,7 @@ TOOLS: list[Tool] = [ icon=":material/picture_as_pdf:", name="PDF to CSV", description=( - "Extract bank-statement transactions from PDFs using reusable " - "per-source templates." + "Pull transactions out of bank-statement PDFs into a clean CSV file." ), page_slug="10_PDF_Extractor", status="Ready", @@ -162,8 +170,8 @@ TOOLS: list[Tool] = [ icon=":material/compare_arrows:", name="Reconcile Two Files", description=( - "Match transactions between two sources (e.g. bank feed vs. " - "ledger) with amount and date tolerance." + "Compare two lists of transactions (e.g. bank vs. ledger) and " + "flag what doesn't match." ), page_slug="11_Reconciler", status="Ready", diff --git a/src/i18n/packs/en.json b/src/i18n/packs/en.json index e76f7cf..9ef7a2d 100644 --- a/src/i18n/packs/en.json +++ b/src/i18n/packs/en.json @@ -107,63 +107,63 @@ "tools": { "01_deduplicator": { "name": "Find Duplicates", - "description": "Fuzzy matching, normalization, survivor selection, and interactive review.", + "description": "Find rows that repeat — exact and similar — and remove the extras.", "page_title": "Find Duplicates", - "page_caption": "Find and remove duplicate rows — exact matches and near-misses." + "page_caption": "Find rows that repeat, then keep one and remove the extras." }, "02_text_cleaner": { "name": "Clean Text", - "description": "Whitespace trim, multi-space collapse, Unicode normalization, BOM and line-ending handling.", + "description": "Trim extra spaces and strip out odd characters that copy-paste leaves behind.", "page_title": "Clean Text", - "page_caption": "Tidy up messy text — stray spaces, smart quotes, hidden characters." + "page_caption": "Trim extra spaces and strip out odd characters." }, "03_format_standardizer": { "name": "Standardize Formats", - "description": "Standardize dates, currencies, names, phone numbers, and addresses.", + "description": "Make dates, phone numbers, currency, names, and addresses look the same throughout.", "page_title": "Standardize Formats", - "page_caption": "Put dates, phones, currency, and names into one consistent format." + "page_caption": "Make dates, phones, currency, and names look the same throughout." }, "04_missing_handler": { "name": "Fix Missing Values", - "description": "Detect disguised nulls, missingness analysis, and imputation strategies.", + "description": "Find blank cells (even ones written as 'N/A' or '?') and fill them in or remove them.", "page_title": "Fix Missing Values", - "page_caption": "Find blanks (even disguised ones) and fill or drop them." + "page_caption": "Find blank cells (even hidden ones) and fill them in or remove them." }, "05_column_mapper": { "name": "Map Columns", - "description": "Rename columns, enforce a target schema, and coerce types.", + "description": "Rename columns, change their order, and set each one as text, number, or date.", "page_title": "Map Columns", - "page_caption": "Rename columns, set the order, and lock in the data types you want." + "page_caption": "Rename columns, change their order, and set each one as text, number, or date." }, "06_outlier_detector": { "name": "Find Unusual Values", - "description": "Z-score, IQR, and MAD detection with domain-rule violations and winsorization.", + "description": "Spot values that look wrong — way too high, way too low, or breaking your rules.", "page_title": "Find Unusual Values", - "page_caption": "Spot values that don't fit — too high, too low, or breaking your rules." + "page_caption": "Spot values that look wrong — way too high, too low, or breaking your rules." }, "07_multi_file_merger": { "name": "Combine Files", - "description": "Combine multiple CSV/Excel files with schema alignment.", + "description": "Combine several CSV or Excel files into one — even if their columns don't match.", "page_title": "Combine Files", - "page_caption": "Stack several CSVs or spreadsheets into a single clean file." + "page_caption": "Combine several CSV or Excel files into one — even if columns differ." }, "08_validator_reporter": { "name": "Quality Check", - "description": "Validate against rules and generate PDF/Excel quality reports.", + "description": "Check your file against rules you set, and export a PDF or Excel report.", "page_title": "Quality Check", - "page_caption": "Score your file against rules and export a PDF/Excel report." + "page_caption": "Check your file against rules and export a PDF or Excel report." }, "09_pipeline_runner": { "name": "Automated Workflows", - "description": "Chain tools in recommended order and pass output between steps.", + "description": "Run several tools in a row — save the steps once, reuse them anytime.", "page_title": "Automated Workflows", - "page_caption": "Run several tools in sequence — save the recipe and reuse it later." + "page_caption": "Run several tools in a row — save the steps and reuse them anytime." }, "10_pdf_extractor": { "name": "PDF to CSV", - "description": "Extract bank-statement transactions from PDFs using reusable per-source templates.", + "description": "Pull transactions out of bank-statement PDFs into a clean CSV file.", "page_title": "PDF to CSV", - "page_caption": "Pull transactions out of bank-statement PDFs into a clean CSV." + "page_caption": "Pull transactions out of bank-statement PDFs into a clean CSV file." } }, "nav": { diff --git a/src/i18n/packs/es.json b/src/i18n/packs/es.json index 26da659..59a9699 100644 --- a/src/i18n/packs/es.json +++ b/src/i18n/packs/es.json @@ -107,63 +107,63 @@ "tools": { "01_deduplicator": { "name": "Buscar duplicados", - "description": "Coincidencia difusa, normalización, selección de superviviente y revisión interactiva.", + "description": "Encuentra filas que se repiten — exactas y similares — y elimina las extras.", "page_title": "Buscar duplicados", - "page_caption": "Encuentra y elimina filas duplicadas — exactas y casi idénticas." + "page_caption": "Encuentra filas que se repiten, conserva una y elimina las extras." }, "02_text_cleaner": { "name": "Limpiar texto", - "description": "Recorte de espacios, colapso de espacios múltiples, normalización Unicode, manejo de BOM y de finales de línea.", + "description": "Quita espacios extra y caracteres raros que deja el copiar y pegar.", "page_title": "Limpiar texto", - "page_caption": "Ordena texto desordenado — espacios sobrantes, comillas y caracteres ocultos." + "page_caption": "Quita espacios extra y caracteres raros." }, "03_format_standardizer": { "name": "Estandarizar formatos", - "description": "Estandariza fechas, monedas, nombres, números de teléfono y direcciones.", + "description": "Haz que fechas, teléfonos, monedas, nombres y direcciones se vean iguales en todo el archivo.", "page_title": "Estandarizar formatos", - "page_caption": "Unifica fechas, teléfonos, monedas y nombres en un formato consistente." + "page_caption": "Haz que fechas, teléfonos, monedas y nombres se vean iguales en todo el archivo." }, "04_missing_handler": { "name": "Corregir valores faltantes", - "description": "Detecta nulos disfrazados, analiza la ausencia de datos y aplica estrategias de imputación.", + "description": "Encuentra celdas vacías (incluso escritas como «N/A» o «?») y rellénalas o elimínalas.", "page_title": "Corregir valores faltantes", - "page_caption": "Encuentra celdas vacías (incluso disfrazadas) y rellénalas o descártalas." + "page_caption": "Encuentra celdas vacías (incluso ocultas) y rellénalas o elimínalas." }, "05_column_mapper": { "name": "Mapear columnas", - "description": "Renombra columnas, aplica un esquema objetivo y fuerza tipos de datos.", + "description": "Renombra columnas, cambia su orden y define cada una como texto, número o fecha.", "page_title": "Mapear columnas", - "page_caption": "Renombra columnas, fija el orden y aplica los tipos de datos que quieras." + "page_caption": "Renombra columnas, cambia su orden y define cada una como texto, número o fecha." }, "06_outlier_detector": { "name": "Detectar valores atípicos", - "description": "Detección por Z-score, IQR y MAD con reglas de dominio y winsorización.", + "description": "Detecta valores que parecen incorrectos — demasiado altos, demasiado bajos o fuera de regla.", "page_title": "Detectar valores atípicos", - "page_caption": "Señala valores que no encajan — demasiado altos, bajos o fuera de regla." + "page_caption": "Detecta valores que parecen incorrectos — demasiado altos, bajos o fuera de regla." }, "07_multi_file_merger": { "name": "Combinar archivos", - "description": "Combina varios archivos CSV/Excel alineando sus esquemas.", + "description": "Combina varios archivos CSV o Excel en uno — aunque sus columnas no coincidan.", "page_title": "Combinar archivos", - "page_caption": "Une varios CSV u hojas de cálculo en un único archivo limpio." + "page_caption": "Combina varios CSV o Excel en uno — aunque las columnas no coincidan." }, "08_validator_reporter": { "name": "Verificación de calidad", - "description": "Valida contra reglas y genera informes de calidad en PDF/Excel.", + "description": "Comprueba tu archivo según reglas que tú definas y exporta un informe PDF o Excel.", "page_title": "Verificación de calidad", - "page_caption": "Evalúa tu archivo según reglas y exporta un informe PDF/Excel." + "page_caption": "Comprueba tu archivo según reglas y exporta un informe PDF o Excel." }, "09_pipeline_runner": { "name": "Flujos automatizados", - "description": "Encadena herramientas en el orden recomendado y pasa la salida entre pasos.", + "description": "Ejecuta varias herramientas seguidas — guarda los pasos una vez y reutilízalos.", "page_title": "Flujos automatizados", - "page_caption": "Ejecuta varias herramientas en orden — guarda la receta y reutilízala." + "page_caption": "Ejecuta varias herramientas seguidas — guarda los pasos y reutilízalos." }, "10_pdf_extractor": { "name": "PDF a CSV", - "description": "Extrae transacciones de extractos bancarios en PDF usando plantillas reutilizables por origen.", + "description": "Extrae transacciones de extractos bancarios en PDF a un archivo CSV limpio.", "page_title": "PDF a CSV", - "page_caption": "Extrae transacciones de extractos bancarios en PDF a un CSV limpio." + "page_caption": "Extrae transacciones de extractos bancarios en PDF a un archivo CSV limpio." } }, "nav": {