Skip to content

Commit 0bd23f1

Browse files
committed
Add official guideline sources for real-world testing.
Point users to trusted publisher pages so they can try Herald on current public guidelines without relying on bundled content or mirrored PDFs. Made-with: Cursor
1 parent c8c5cce commit 0bd23f1

2 files changed

Lines changed: 27 additions & 0 deletions

File tree

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,17 @@ Short version:
237237
- okay with caveats: two-column layouts, complex tables
238238
- weak: scanned PDFs without OCR, image-heavy flowcharts, slide decks
239239

240+
## Try It With Real Guidelines
241+
242+
If you want to test Herald on real public guidelines, start with structured, text-based documents from major publishers:
243+
244+
- [NICE Guidance](https://www.nice.org.uk/guidance/)
245+
- [WHO Guidelines](https://www.who.int/publications/guidelines/en/)
246+
- [SIGN Guidelines](https://www.sign.ac.uk/guidelines/)
247+
- [CDC Clinical Guidance](https://www.cdc.gov/flu/hcp/clinical-guidance/index.html)
248+
249+
Prefer guideline landing pages over random mirrored PDFs. Herald works best on documents with selectable text, numbered sections, and explicit recommendation statements.
250+
240251
## Licensing And Content
241252

242253
Clinical practice guidelines are usually copyrighted by their publishers. Herald is designed to let users convert and query guidelines locally, but you still need to respect each publisher's reuse policy.

docs/supported_guidelines.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,22 @@ If you cannot highlight text in the original PDF, run OCR first.
4747
| APA (USA) | Variable | Some documents are more narrative and less recommendation-structured |
4848
| Local hospital protocols | Variable | Often excellent if they are plain text; weak if exported from slides |
4949

50+
## Official Sources To Test With
51+
52+
If you want to try Herald on real public material, start from official publisher pages instead of mirrored PDFs:
53+
54+
- [NICE Guidance](https://www.nice.org.uk/guidance/)
55+
- [WHO Guidelines](https://www.who.int/publications/guidelines/en/)
56+
- [SIGN Guidelines](https://www.sign.ac.uk/guidelines/)
57+
- [CDC Clinical Guidance](https://www.cdc.gov/flu/hcp/clinical-guidance/index.html)
58+
59+
Practical advice:
60+
61+
- choose PDFs with selectable text
62+
- prefer guideline pages with conventional recommendation prose over slide decks and infographic-heavy assets
63+
- use the publisher landing page first, then pick a single guideline PDF from there
64+
- always check licence and reuse terms before sharing converted outputs
65+
5066
## Practical Advice
5167

5268
Before parsing a real guideline:

0 commit comments

Comments
 (0)