Skip to content

Commit c32b6f3

Browse files
author
Dahlia Li
committed
Refine failure analysis workflow section
1 parent 1dad440 commit c32b6f3

1 file changed

Lines changed: 15 additions & 18 deletions

File tree

  • docs/development/failure_analysis_workflow

docs/development/failure_analysis_workflow/index.md

Lines changed: 15 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -71,40 +71,37 @@ The trace output provides:
7171
To determine whether a failure is due to missing data or genuine ambiguity,
7272
independently verify the same taxonomic name using **Global Names Verifier**.
7373

74-
=== "CLI / Alias Usage"
74+
=== "Docker Runtime"
7575

7676
```bash
77-
gnverifier -j 1 \
77+
docker run --rm -i gnames/gnverifier:v1.2.5 \
78+
-j 1 \
7879
--format compact \
7980
--capitalize \
8081
--all_matches \
8182
--sources 11 \
8283
"<scientific_name>" | jq
8384
```
8485

85-
This approach uses the GNVerifier command-line tool directly and is
86-
suitable for shell-based workflows and batch inspection.
86+
Runs GNVerifier inside an official container image.
87+
This method requires Docker but does not require local installation
88+
of GNVerifier.
8789

88-
=== "API Usage (Programmatic)"
90+
=== "Local CLI Installation"
8991

9092
```bash
91-
curl -X POST "https://verifier.globalnames.org/api/v1/verifications" \
92-
-H "Content-Type: application/json" \
93-
-d '{
94-
"names": ["<scientific_name>"],
95-
"capitalize": true,
96-
"sources": [11]
97-
}' | jq
93+
gnverifier -j 1 \
94+
--format compact \
95+
--capitalize \
96+
--all_matches \
97+
--sources 11 \
98+
"<scientific_name>" | jq
9899
```
99100

100-
This method uses the GNVerifier HTTP API and is appropriate for
101-
integration into automated pipelines or custom applications.
102-
101+
Runs GNVerifier installed directly on the local system.
102+
103103
---
104104

105-
This step confirms whether multiple accepted records exist in authoritative
106-
sources such as GBIF.
107-
108105
## 5. Common Failure Pattern: Multi-Accepted Match Tie
109106

110107
Across analyzed EOL cases, the most frequent failure pattern observed was:

0 commit comments

Comments
 (0)