On Friday, November 17, 2017 at 10:40:22 AM UTC-8, Simon King wrote: > > Hi John, > > On 2017-11-17, John H Palmieri <[email protected] <javascript:>> wrote: > >> And WHY that change was made! > >> > > > > If it takes a while to build the documentation, better to start as soon > as > > possible, rather than to wait until the last possible time, right? > > If the user's purpose is to use Sage, better make it usable as soon as > possible. > > Moreover: Have the for-years-frequently-occurring "sporadic" doc build > failures been fixed at last? Otherwise: Better build as soon as possible > what does reliably build (i.e., sage/src), rather than frustrating the > user. > > Best regards, > Simon > > For the first paragraph, we have to deal with the definition of "usable". The philosophy for some time has been that Sage without documentation is not fully usable. (Plus having the documentation build in parallel with some Sage packages may not slow down the build of Sage-minus-the-documentation that much. I don't really know.)
For the second paragraph, there has been some progress made, yes. Also, there is the question of to what extent the default build process should be tailored toward developers, who are more likely to run into problems with the documentation (because the problems have occurred in the past when changing branches, for example), vs. toward users who are not developers. My opinion is that developers should come low on the priority list; we can always use "make build" to skip the documentation build, if we want, or use "make doc-html-no-plot" to skip the plots (which can take a while), etc. For users who are not developers, having the Sage build process end (fully, including the documentation) more quickly is better. John -- You received this message because you are subscribed to the Google Groups "sage-release" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sage-release. For more options, visit https://groups.google.com/d/optout.
