Description
PR #5177 changed how the website incorporates docs from the flowfuse/flowfuse repo. There are some outstanding problems:
.claude/CLAUDE.md was updated with information about the new process - but README.md was not updated and contains out of date information.
Specifically, the fact it now clones the ff repo by default rather than use a local copy of the docs without manual intervention. This has broken the FF repo build that verifies doc changes.
It has also added docs to CLAUDE.md about an npm task called dev:nuxt. This task doesn't exist.
It has also removed the ability to watch the docs for changes and trigger automatic rebuild - was previously the npm run dev:docs task. When working on product docs, I now have to manually restart the website build every time and wait for it to complete.
I also find I'm routinely hitting nuxt/nuxt#35253 due to the version of nuxt we are using.
In addition to knowing about the FLOWFUSE_DOCS_LOCAL env var, I also have to set TMPDIR=/tmp to workaround that nuxt issue.
Epic/Story
No response
Have you provided an initial effort estimate for this issue?
I have provided an initial effort estimate
Description
PR #5177 changed how the website incorporates docs from the flowfuse/flowfuse repo. There are some outstanding problems:
.claude/CLAUDE.mdwas updated with information about the new process - butREADME.mdwas not updated and contains out of date information.Specifically, the fact it now clones the ff repo by default rather than use a local copy of the docs without manual intervention. This has broken the FF repo build that verifies doc changes.
It has also added docs to
CLAUDE.mdabout an npm task calleddev:nuxt. This task doesn't exist.It has also removed the ability to watch the docs for changes and trigger automatic rebuild - was previously the
npm run dev:docstask. When working on product docs, I now have to manually restart the website build every time and wait for it to complete.I also find I'm routinely hitting nuxt/nuxt#35253 due to the version of nuxt we are using.
In addition to knowing about the
FLOWFUSE_DOCS_LOCALenv var, I also have to setTMPDIR=/tmpto workaround that nuxt issue.Epic/Story
No response
Have you provided an initial effort estimate for this issue?
I have provided an initial effort estimate