Record the Friday Facts blog as a reference source - #1
Merged
Conversation
The oracle reads three sources that ship with the install and answer what the game accepts. None of them answers why a value changed, which is the question you actually have after an update. Split the sources into two kinds. Authoritative ones ship with the install, read offline, and may gate a capture. Reference ones explain a change and must never gate one. The blog is the second kind: it is Wube's own writing, so it outranks forum and wiki advice, but it describes intent and the shipped game can differ. Measured 2026-08-17: the feed is Atom at factorio.com/blog/rss, carries the 10 most recent posts only with full bodies embedded, and is the one source here that needs the network. The worked example is real. Factorio 2.1 changed the pumpjack's output_fluid_box pipe connections from two distinct corners repeated to four distinct corners, one per rotation. The dump shows the change but not the reason. FFF #442 does, and the same release added use_mirroring and migrate_horizontal_mirroring to that prototype. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01P9FADuTnjE7SFEQWnpNhfc
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.
Splits the oracle's sources into two kinds, and adds the Friday Facts blog as the second kind.
Authoritative sources say what the game accepts. They ship with the install, so a capture reads them offline and gets the same bytes every time. Only these may gate a capture:
--dump-data,data/*/migrations/*.json,doc-html/runtime-api.json.Reference sources say why something changed, which is what tells you which captured value now needs review. Nothing automated reads them and nothing should:
data/changelog.txtand the blog.Why the blog is not authoritative
Wube writes it, so it outranks forum, wiki and third-party blog advice. It still describes intent, and the shipped game can differ, so any claim from it needs checking against a capture.
Measured 2026-08-17
application/atom+xml.https://factorio.com/blog/post/fff-<number>.The worked example is real
Comparing real 2.0.77 and 2.1.14 installs today, the pumpjack's
output_fluid_boxpipe connections went from two distinct corners repeated to four distinct corners, one per rotation:The dump shows the change but not the reason. FFF #442, "Flip, Flow, and Fresh Paint", explains it, and the same release added
use_mirroringandmigrate_horizontal_mirroringto that prototype. Reading it is how you learn the change is about entity mirroring rather than a typo fix.Docs only. No code changes.
🤖 Generated with Claude Code
https://claude.ai/code/session_01P9FADuTnjE7SFEQWnpNhfc