fix(docs): repoint dead neptune.ai links and drop the wound-down product - #43
Merged
Conversation
OpenAI acquired Neptune in December 2025 and every neptune.ai/blog URL now 308-redirects to the acquisition announcement, so four referenced articles were unreachable. Each one is repointed at a pinned Wayback capture of the original article, verified through the CDX API as a real text/html 200 of 43-62 KB rather than a redirect stub. Neptune also wound down its external service, so the course was recommending a product readers can no longer sign up for. Those three recommendations now name Comet and ClearML alongside Weights & Biases, and chapter 5.5 says plainly what happened: a tracker disappearing with its documentation is exactly the vendor risk that chapter should teach. Also unblocks docs-only commits. dprint.jsonc excludes docs/**, so the pre-commit hook handed dprint a staged file list it had nothing to do with and dprint exited 14. Every chapter-only contribution failed its own hook.
This was referenced Aug 10, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #39.
What
Repoints the four dead
neptune.ai/bloglinks at pinned Internet Archive captures, replaces the Neptune product recommendations, and unblocks docs-only commits.Why
The dead links are real. OpenAI acquired Neptune in December 2025 and every
neptune.ai/blogURL now returns308 Permanent Redirecttoopenai.com/index/openai-to-acquire-neptune/. Four articles the course links to as definitional sources are unreachable. Reported by @julamarkova-vibe in #39.The product recommendations are a bigger problem than the links. Neptune wound down its external service, so three chapters were recommending a tracker readers can no longer sign up for. A dead link is an inconvenience; a recommendation to adopt a discontinued product is bad teaching.
Docs-only commits could not pass the pre-commit hook.
dprint.jsoncexcludesdocs/**, so when lefthook handeddprint fmta list of staged chapter files it found nothing to format and exited 14 — failing every chapter-only contribution, which is exactly the contribution this repository asks for. It went unnoticed because the recent docs work also touched a workflow file.How
text/html200capture of 43–62 KB, not a redirect stub:20251207223323,20251127141526,20251005125802,20251006163636.0.3,5.5, and5.6now name Comet and ClearML alongside Weights & Biases (all three verified live).5.5gains a short vendor-risk note explaining what happened, since a tracker vanishing along with its documentation is precisely the lesson that chapter should carry — and part of why the course teaches self-hostable MLflow.format:dprintpasses--allow-no-files.On #39
That PR proposed a third-party glossary as the replacement for three of the four links, with an honest disclosure from the author that they run the site. The archive keeps the reference the surrounding prose was actually written against, which is the safer choice for a teaching resource — and the author explicitly offered that alternative. Credit for finding the breakage is theirs.
Test plan
mise run all— exit 0;mkdocs build --strictgreen.mise run format:dprint 'docs/1. Initializing/1.0. System.md'— exit 0 (exit 14 before).pre-commithook.