Sam Ruby wrote on 6/12/17 9:24 PM: > On Mon, Jun 12, 2017 at 9:06 PM, Sam Ruby <ru...@intertwingly.net> wrote: ...snip... >> I learned all this the hard way on the original whimsy_vm where >> directories often got 'wedged' and needed manual intervention for >> cleanup. That's why I instituted a hard separation between what can >> be updated in each process. > > Adding to my answer: this decision (which can be changed if that what > we collectively want to do) was to prefer slightly stale data over > data that (at best) might occasionally stop updating, and (at worst) > can become corrupt. > > The /srv/svn files update every 10 minutes. For most purposes, that > is fast enough.
General comments: - This is a per-tool decision. - We need to ensure each tool has clear maintenance documentation, so fixing out of date or bogus data is easy. - We need to start thinking about how to consistently document these kinds of things to our users, since the userbase is increasing for many tools (and overall number of tools total!) -- Many tools are read-only visualizations of data. Useful information is: what does this data mean, how recently was it updated, and where specifically did it come from (see also test/dataflow.cgi) -- Read/Write tools should consider explaining how quickly changes take effect, as well as any auth questions: i.e. are there any tools that have separate auth from being able to load/see the tool vs. being able to change any editable data? -- Some tools should probably explicitly note in the About This Script that they are access-protected. This will help remind members to not share links for some of the member-private data pages, for example. It's not obvious in many cases to users which specific bits of data might be member-private vs. committer-private, I think. Any other "explain to the user what this page is" aspects to cover? > > Programs like the board agenda tool, the secretary mail tool, and now > the roster take great care to update svn in separate tmp directories. > > - Sam Ruby > -- - Shane https://www.apache.org/foundation/marks/resources