search

openSUSE / docserv

A server for building and publishing documentation with DAPS
https://opensuse.github.io/docserv/
GNU General Public License v3.0
4 stars 3 forks source link

Lingering state of old BIs #270

Open ghost opened 3 years ago

ghost commented 3 years ago

Apparently, Ds2 will allow the state of a BI to linger after the BI has finished:

  1. Add a (broken in some way) DC to the config
  2. Build the containing docset; wait until finished ("fail")
  3. Remove(!) the broken DC from the config again
  4. Rebuild containing docset; wait until finished

-> It fails again. Looking at the API, you can still see the broken DC's name under "deliverables", along with its failing status. To fix the issue, you need to quit Ds2, and importantly, delete the JSON from /var/cache/docserv.

There are two reasons why we did not notice this so far:

  1. We usually fix source documents rather than removing from the config.
  2. Only with Docserv 5.x did we actually introduce an overall build status. Before that we just used a document-based build status and copied whatever documents built successfully.