FSharp.Formatting icon indicating copy to clipboard operation
FSharp.Formatting copied to clipboard

Making a change to `content/fsdocs-default.css` cause an infinite update loop

Open MangelMaxime opened this issue 7 months ago • 1 comments

I am using

dotnet build ../../fsprojects/FSharp.Formatting && /fsdocs-tool/bin/Debug/net6.0/fsdocs watch --nolaunch

to run the tool locally.

However, when updating fsdocs-default.css (either in the F# Formatting repository or a copy of it in the project to document) it is triggering an infinite update queue as I am seeing the following messages repeat itself over and over.

Content:

Write Content:
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-theme.js --> content/fsdocs-theme.js
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-search.js --> content/fsdocs-search.js
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-details-set-expanded.js --> content/fsdocs-details-set-expanded.js
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-tips.js --> content/fsdocs-tips.js
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-details-toggle.js --> content/fsdocs-details-toggle.js
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-theme-set-dark.js --> content/fsdocs-theme-set-dark.js
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-default.css --> content/fsdocs-default.css
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-theme-toggle.js --> content/fsdocs-theme-toggle.js
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/fsdocs-theme.css --> content/fsdocs-theme.css
  copying /Users/mmangel/Workspaces/Github/fsprojects/FSharp.Formatting/docs/content/img/github-pages-settings.png --> content/img/github-pages-settings.png
Detected change in 'docs', scheduling rebuild of docs...

It also cause a lot of Trying to reload content/fsdocs-default.css in the browser, and it makes it impossible to modify the CSS in the browser to prototype because it is overwritten over and over.

To work around this issue, I need to kill and re-start the process.

I have this bug both with the latest version of the tool and the main branch.

MangelMaxime avatar Jul 13 '24 14:07 MangelMaxime