an alternative suggestion: how about writing an app like upas/debug which could analyse your installation and attempt to diagnose problems (and even suggest man pages to look at).
personally i have found auth/debug very useful, though i still had situations that it couldn’t help with. just an idea -Steve > On 18 Jan 2025, at 5:07 am, Noam Preil <n...@pixelhero.dev> wrote: > > >> >> Provide a trivial on-ramp to Plan9. >> Your ideas here (yes, that means you). > > One idea i've flirted with, if only for my own use, is to just add some > tools - similar to 9front's existing installer - that automate setup > tasks for first-time users. > > Or, at least, man pages that guide through which steps are needed and > what they accomplish. > > e.g. setting up upas is a PITA the first time around: have to figure out > where to put TLS certs, keys into factotum / how to keep them there, > which can mean figuring out how to set up secstore, have to update the > script for sending mail, configure the accounts, ... > > Once you've done it once, it's easier to do again, but nontrivial. > Setting up _multiple_ accounts, even more so. > > The existing manuals aren't cohesive towards the goal of "read and send > mail," so much as they are "this is how upas/fs works, this is how Mail > works, this is how factotum works, ..." > > Recently had to set up upas on my Reform, having not touched the config > in 2+ years since doing so on a Thinkpad, and it was much more annoying > than it needed to be. > > A simple draw client that makes reading man pages easier, is included in > riostart by default, jumps to intro(1), and adding more useful man pages > and links to them from the intro man page, could make a world of > difference in terms of accessibility. > > Anywho, I don't have time to flesh this out now, I probably shouldn't > have written this email right now either but gotta procrastinate > _somehow_, right? > > - Noam Preil > ------------------------------------------ 9fans: 9fans Permalink: https://9fans.topicbox.com/groups/9fans/T88b1ba241b319a33-M00b3bef2f82b912efb4b36ab Delivery options: https://9fans.topicbox.com/groups/9fans/subscription
