giteadmin/datatools-dev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

copy: strip jargon from tool descriptions and captions

Browse Source 
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) <noreply@anthropic.com>
This commit is contained in:
Michael
2026-06-02 17:09:52 +00:00
parent dd3b9bd59d
commit 7203a81af7
4 changed files with 65 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
src/gui/pages/11_Reconciler.py
View File

@@ -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."
)

40
src/gui/tools_registry.py
View File

@@ -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",

40
src/i18n/packs/en.json
View File

@@ -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": {

40
src/i18n/packs/es.json
View File

@@ -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": {