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.title("Reconcile Two Files")
st.caption( 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:", icon=":material/help_outline:",
name="Fix Missing Values", name="Fix Missing Values",
description=( 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", page_slug="4_Missing_Values",
status="Ready", status="Ready",
@@ -63,8 +64,8 @@ TOOLS: list[Tool] = [
icon=":material/insights:", icon=":material/insights:",
name="Find Unusual Values", name="Find Unusual Values",
description=( description=(
"Z-score, IQR, and MAD detection with domain-rule violations and " "Spot values that look wrong — way too high, way too low, or "
"winsorization." "breaking your rules."
), ),
page_slug="6_Outlier_Detector", page_slug="6_Outlier_Detector",
status="Coming Soon", status="Coming Soon",
@@ -75,8 +76,8 @@ TOOLS: list[Tool] = [
icon=":material/text_format:", icon=":material/text_format:",
name="Clean Text", name="Clean Text",
description=( description=(
"Whitespace trim, multi-space collapse, Unicode normalization, " "Trim extra spaces and strip out odd characters that copy-paste "
"BOM and line-ending handling." "leaves behind."
), ),
page_slug="2_Text_Cleaner", page_slug="2_Text_Cleaner",
status="Ready", status="Ready",
@@ -87,7 +88,8 @@ TOOLS: list[Tool] = [
icon=":material/format_list_bulleted:", icon=":material/format_list_bulleted:",
name="Standardize Formats", name="Standardize Formats",
description=( 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", page_slug="3_Format_Standardizer",
status="Ready", status="Ready",
@@ -98,8 +100,7 @@ TOOLS: list[Tool] = [
icon=":material/search:", icon=":material/search:",
name="Find Duplicates", name="Find Duplicates",
description=( description=(
"Fuzzy matching, normalization, survivor selection, and " "Find rows that repeat — exact and similar — and remove the extras."
"interactive review."
), ),
page_slug="1_Deduplicator", page_slug="1_Deduplicator",
status="Ready", status="Ready",
@@ -110,7 +111,8 @@ TOOLS: list[Tool] = [
icon=":material/check_circle:", icon=":material/check_circle:",
name="Quality Check", name="Quality Check",
description=( 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", page_slug="8_Validator_Reporter",
status="Coming Soon", status="Coming Soon",
@@ -120,7 +122,10 @@ TOOLS: list[Tool] = [
tool_id="05_column_mapper", tool_id="05_column_mapper",
icon=":material/view_column:", icon=":material/view_column:",
name="Map Columns", 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", page_slug="5_Column_Mapper",
status="Ready", status="Ready",
section="transformations", section="transformations",
@@ -129,7 +134,10 @@ TOOLS: list[Tool] = [
tool_id="07_multi_file_merger", tool_id="07_multi_file_merger",
icon=":material/account_tree:", icon=":material/account_tree:",
name="Combine Files", 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", page_slug="7_Multi_File_Merger",
status="Coming Soon", status="Coming Soon",
section="transformations", section="transformations",
@@ -139,7 +147,8 @@ TOOLS: list[Tool] = [
icon=":material/auto_awesome:", icon=":material/auto_awesome:",
name="Automated Workflows", name="Automated Workflows",
description=( 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", page_slug="9_Pipeline_Runner",
status="Ready", status="Ready",
@@ -150,8 +159,7 @@ TOOLS: list[Tool] = [
icon=":material/picture_as_pdf:", icon=":material/picture_as_pdf:",
name="PDF to CSV", name="PDF to CSV",
description=( description=(
"Extract bank-statement transactions from PDFs using reusable " "Pull transactions out of bank-statement PDFs into a clean CSV file."
"per-source templates."
), ),
page_slug="10_PDF_Extractor", page_slug="10_PDF_Extractor",
status="Ready", status="Ready",
@@ -162,8 +170,8 @@ TOOLS: list[Tool] = [
icon=":material/compare_arrows:", icon=":material/compare_arrows:",
name="Reconcile Two Files", name="Reconcile Two Files",
description=( description=(
"Match transactions between two sources (e.g. bank feed vs. " "Compare two lists of transactions (e.g. bank vs. ledger) and "
"ledger) with amount and date tolerance." "flag what doesn't match."
), ),
page_slug="11_Reconciler", page_slug="11_Reconciler",
status="Ready", status="Ready",

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

@@ -107,63 +107,63 @@
"tools": { "tools": {
"01_deduplicator": { "01_deduplicator": {
"name": "Find Duplicates", "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_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": { "02_text_cleaner": {
"name": "Clean Text", "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_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": { "03_format_standardizer": {
"name": "Standardize Formats", "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_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": { "04_missing_handler": {
"name": "Fix Missing Values", "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_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": { "05_column_mapper": {
"name": "Map Columns", "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_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": { "06_outlier_detector": {
"name": "Find Unusual Values", "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_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": { "07_multi_file_merger": {
"name": "Combine Files", "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_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": { "08_validator_reporter": {
"name": "Quality Check", "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_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": { "09_pipeline_runner": {
"name": "Automated Workflows", "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_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": { "10_pdf_extractor": {
"name": "PDF to CSV", "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_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": { "nav": {

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

@@ -107,63 +107,63 @@
"tools": { "tools": {
"01_deduplicator": { "01_deduplicator": {
"name": "Buscar duplicados", "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_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": { "02_text_cleaner": {
"name": "Limpiar texto", "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_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": { "03_format_standardizer": {
"name": "Estandarizar formatos", "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_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": { "04_missing_handler": {
"name": "Corregir valores faltantes", "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_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": { "05_column_mapper": {
"name": "Mapear columnas", "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_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": { "06_outlier_detector": {
"name": "Detectar valores atípicos", "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_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": { "07_multi_file_merger": {
"name": "Combinar archivos", "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_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": { "08_validator_reporter": {
"name": "Verificación de calidad", "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_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": { "09_pipeline_runner": {
"name": "Flujos automatizados", "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_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": { "10_pdf_extractor": {
"name": "PDF a CSV", "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_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": { "nav": {