Skip to content

docs: fix broken links in READMEs and documentation - #1599

Open
1183531403-art wants to merge 1 commit into
FlagOpen:masterfrom
1183531403-art:fix/broken-doc-links
Open

docs: fix broken links in READMEs and documentation#1599
1183531403-art wants to merge 1 commit into
FlagOpen:masterfrom
1183531403-art:fix/broken-doc-links

Conversation

@1183531403-art

Copy link
Copy Markdown

Found by scanning every markdown/rst file in the repo (180 files, 356 unique external URLs) and checking each one live. These were genuinely dead (404 verified before the fix); every replacement target was verified to return HTTP 200 before use:

File Dead link Replacement (verified 200)
README_zh.md blob/master/FlagEmbedding/BGE_M3/BGE_M3.pdf blob/master/research/BGE_M3/BGE_M3.pdf
docs/source/bge/bge_m3.rst arxiv.org/pdf/2402.03216s (stray trailing s) arxiv.org/pdf/2402.03216
docs/source/C-MTEB.rst tree/master/C_MTEB tree/master/research/C_MTEB
examples/finetune/reranker/README.md tree/master/examples/pretrain#2-data-format tree/master/research/old-examples/pretrain#2-data-format (anchor kept, section exists)
research/README.md tree/master/FlagEmbedding/llm_embedder tree/master/research/llm_embedder
research/README.md tree/master/examples/reranker tree/master/examples/finetune/reranker
research/README.md tree/master/FlagEmbedding/llm_reranker#fine-tune tree/master/research/llm_reranker#fine-tune (anchor ## Fine-tune exists)

After the change, all 81 URLs in the five touched files were re-checked live; all resolve (the only remaining oddity is a pre-existing line in README_zh.md where a Chinese closing bracket sits flush against the MemoRAG arXiv URL — left untouched since the URL itself works).

Happy to split this per-directory if you prefer smaller patches.

All replacement targets were verified to return HTTP 200 before use:

- README_zh.md: the BGE-M3 report PDF lives at research/BGE_M3/BGE_M3.pdf,
  not under FlagEmbedding/BGE_M3/
- docs/source/bge/bge_m3.rst: correct the arXiv id for the BGE-M3 paper
  (2402.03216, drop the stray trailing 's')
- docs/source/C-MTEB.rst: C_MTEB moved under research/
- examples/finetune/reranker/README.md: the pretrain data format section
  moved to research/old-examples/pretrain
- research/README.md: point the LLM Embedder heading, the reranker
  fine-tune example, and the LLM reranker fine-tune link at their current
  locations
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant