Skip to content

docs: add --livereload flag in Getting Started > Contributing > Documentation#381

Open
Aevarkan wants to merge 1 commit intoEndstoneMC:mainfrom
Aevarkan:contributing
Open

docs: add --livereload flag in Getting Started > Contributing > Documentation#381
Aevarkan wants to merge 1 commit intoEndstoneMC:mainfrom
Aevarkan:contributing

Conversation

@Aevarkan
Copy link
Copy Markdown
Contributor

@Aevarkan Aevarkan commented Apr 16, 2026

I was wondering why using the mkdocs serve command wasn't actually updating the site live.

The command instead needs to be run as

mkdocs serve --livereload

It turns out this is a bigger issue:

I considered adding an explanation regarding the workaround in the documentation, but I don't think it's that big of an issue to leave it unmentioned. It's only adding a flag, and you'd figure out that not using the flag means the live preview stops working.

I believe it's a better idea to just not mention it, and anyone curious can have a look at this PR. Otherwise, don't inadvertently lead them down a rabbit hole.

@Aevarkan
Copy link
Copy Markdown
Contributor Author

To update, I made a PR upstream, and using the --livereload flag is now what the official Material for MkDocs page says.

@Aevarkan Aevarkan changed the title docs: add --livereload flag in contributing to docs section docs: add --livereload flag in Getting Started > Contributing > Documentation section Apr 17, 2026
@Aevarkan Aevarkan changed the title docs: add --livereload flag in Getting Started > Contributing > Documentation section docs: add --livereload flag in Getting Started > Contributing > Documentation Apr 17, 2026
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