Issue #10251 relates to branch names for documentation versions on Read the Docs
I'd like to bring this to a close with agreement. The default names on RTD are "latest" to track main branch, and "stable" to track the highest versioned branch. There are arguments in favour of changing this. For what it's worth, most RTD projects seem to use the default; Fedora uses "latest" for the most recent release; Debian uses "stable" for the most recent release, (and "oldstable" for the one before.) These projects do not seem to see any issue with using these names in their documentation, instead of URLS that point to specific releases, (although they may support that also). I do not know if it's possible to change the default namings in RTD to keep the automatic updating. The documentation isnt particularly clear on this, and (ironically) the documentation on building a working local RTD on Debian is woeful. It IS possible to change the default view to show documentation for the stable branch. We should do this, under whatever name is chosen. I think we need to establish: 1. Is it possible to change the default names - latest and stable? 2. If so, what names should we use? 3. If we do, is it possible to retain automatic generation of docs for the most recent versioned branch? 4. If we do change from defaults, and it is not possible to retain automatic generation, can we manually set our choice to point to the most recent versioned branch? 2 is for general discussion. 1,3,4 need input from folk familiar with RTD. unman -- You received this message because you are subscribed to the Google Groups "qubes-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion visit https://groups.google.com/d/msgid/qubes-devel/aOj5EGJGcqNrxyd9%40thirdeyesecurity.org.
