Revert: restore the full docs page set (574, not 59) - #961
Merged
Conversation
…ectory" This reverts the switch to `md-book build .`, restoring `md-book -i . -o book`. The change cut the published site from 574 pages to 59. I framed that as removing archives and artefacts; it also removed real, linked content — PERFORMANCE_BENCHMARKING_README, the research and validation documents at the docs root, and 165 archived pages that were nonetheless live. Anything linking to them now 404s. SUMMARY.md describes 59 chapters, but the site has been publishing everything under docs/ for as long as md-book has built it, and readers and links depend on that. Narrowing the published surface is a content decision for the docs owner, not a side effect of a build-tool upgrade. Restores the previous behaviour first; the narrowing can be proposed separately, with the missing pages either added to SUMMARY.md or explicitly retired.
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.
Reverts #960. The live site went from 574 pages to 59 on the last deploy, and that removed real content, not just archives:
PERFORMANCE_BENCHMARKING_README, the research and validation documents at the docs root, and 165 archived pages that were nonetheless published and linkable. Anything pointing at them now 404s.My reasoning in #960 was that
SUMMARY.mddeclares 59 chapters and the rest was noise. That was a content decision dressed up as a build-tool upgrade, and it wasn't mine to make. The site has published everything underdocs/for as long as md-book has built it.Restoring first. If narrowing the published surface is wanted, it should be a deliberate change with the pages either added to
SUMMARY.mdor explicitly retired.md-book 0.2.0 itself is unaffected by this revert — the directory-walk path is fully supported and tested.