docs: add acronym sync usage to README and Quick Start (#1032)

* docs: document acronym sync and acronym query flow [AI-assisted]

Add explicit CLI examples for syncing acronym data and querying journals by acronym so users can discover and use the new acronym workflow from README and Quick Start.

* docs: use concrete acronym example and link acronym dataset [AI-assisted]

Replace placeholder acronym examples with a real journal acronym for consistency with existing README/Quick Start examples, and add a direct link to the curated acronym dataset repository used by acronym sync.

---------

Co-authored-by: florath-ai-assistant[bot] <Andreas.Florath@telekom.de>

Author: coding-ai-assistant[bot]

README.md

@@ -54,6 +54,12 @@ aletheia-probe status
 # Assess a single journal
 aletheia-probe journal "Journal of Computer Science"
 
+# Sync acronym dataset used for acronym-based venue expansion
+aletheia-probe acronym sync
+
+# Assess using a journal acronym after syncing the acronym dataset
+aletheia-probe journal "JMLR"
+
 # Assess all journals in a BibTeX file (returns exit code 1 if predatory journals found)
 aletheia-probe bibtex references.bib
 

docs/quick-start.md

@@ -182,7 +182,22 @@ aletheia-probe bibtex references.bib
 aletheia-probe bibtex references.bib --format json
 ```
 
-### 3. Check Cache Status
+### 3. Assess by Acronym
+
+If you want to query venues by acronym, first sync the acronym dataset, then run a normal journal query with the acronym text:
+The dataset synced by this command is maintained in the [`venue-acronyms-2025`](https://github.com/sustainet-guardian/venue-acronyms-2025) repository.
+
+```bash
+# Download and import the latest curated acronym dataset
+aletheia-probe acronym sync
+
+# Assess using a journal acronym example
+aletheia-probe journal "JMLR"
+```
+
+This is useful when references contain short forms (for example, common venue abbreviations) instead of full names.
+
+### 4. Check Cache Status
 
 ```bash
 # Display current cache state and backend information