Docs fail to update

[jackjourneyman]

If you don't update your documentation for a while, your browser is caching information and is not aware about changes.

I'm afraid the "known issue" mentioned in the FAQ which prevents docs MkDocs updating, makes this add-on pretty much unusable if you want to view docs in the HA app on a Chromebook.

Unlike other Android devices the Chromebook does not have an option to clear cache - the only way I've found to see updates is to reboot (not just restart) Home Assistant.

"For a while" means pretty much every day.

When you do reboot, the add-on itself fails and has to be restarted.

Traceback (most recent call last):
  File "/opt/venv/bin/mkdocs", line 8, in <module>
    sys.exit(cli())
             ^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1161, in __call__
    return self.main(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1082, in main
Traceback (most recent call last):
  File "/opt/venv/bin/mkdocs", line 8, in <module>
    rv = self.invoke(ctx)
         ^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1697, in invoke
    sys.exit(cli())
             ^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1161, in __call__
    return _process_result(sub_ctx.command.invoke(sub_ctx))
    return self.main(*args, **kwargs)
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1443, in invoke
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1082, in main
    return ctx.invoke(self.callback, **ctx.params)
    rv = self.invoke(ctx)
         ^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1697, in invoke
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 788, in invoke
    return __callback(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/mkdocs/__main__.py", line 272, in serve_command
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 1443, in invoke
    serve.serve(**kwargs)
  File "/opt/venv/lib/python3.11/site-packages/mkdocs/commands/serve.py", line 104, in serve
    return ctx.invoke(self.callback, **ctx.params)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/click/core.py", line 788, in invoke
    return __callback(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.11/site-packages/mkdocs/__main__.py", line 272, in serve_command
    serve.serve(**kwargs)
  File "/opt/venv/lib/python3.11/site-packages/mkdocs/commands/serve.py", line 104, in serve
    server.serve(open_in_browser=open_in_browser)
    server.serve(open_in_browser=open_in_browser)
  File "/opt/venv/lib/python3.11/site-packages/mkdocs/livereload/__init__.py", line 173, in serve
  File "/opt/venv/lib/python3.11/site-packages/mkdocs/livereload/__init__.py", line 173, in serve
    self.server_bind()
  File "/usr/lib/python3.11/wsgiref/simple_server.py", line 50, in server_bind
    HTTPServer.server_bind(self)
  File "/usr/lib/python3.11/http/server.py", line 136, in server_bind
    socketserver.TCPServer.server_bind(self)
  File "/usr/lib/python3.11/socketserver.py", line 472, in server_bind
    self.server_bind()
  File "/usr/lib/python3.11/wsgiref/simple_server.py", line 50, in server_bind
    HTTPServer.server_bind(self)
  File "/usr/lib/python3.11/http/server.py", line 136, in server_bind
    socketserver.TCPServer.server_bind(self)
  File "/usr/lib/python3.11/socketserver.py", line 472, in server_bind
    self.socket.bind(self.server_address)
OSError: [Errno 98] Address in use
    self.socket.bind(self.server_address)
OSError: [Errno 98] Address in use
2025/03/19 13:11:40 [error] 124#124: *1 "/data/www/index.html" is not found (2: No such file or directory), client: 172.30.32.2, server: , request: "GET / HTTP/1.1", host: "192.168.1.130:8123", referrer: "http://192.168.1.130:8123/18ac940c_mkdocs"