DistributedProofreaders / ppwb

Post Processor's Workbench
GNU General Public License v3.0
5 stars 6 forks source link

Remove rfrank's contact info (with his consent) #6

Closed cpeel closed 3 years ago

cpeel commented 3 years ago

Generalize where users can get help and add links to the documentation. Also add a link to github in the rare case we have people who want to help improve the tooling or get access to the source code.

Demo-able in the contact-update sandbox.

asylumcs commented 3 years ago

Yes this makes sense and I confirm my consent.

asylumcs commented 3 years ago

This change from going to a person to going to a forum works only if someone in the forum knows what to do if there is a report. These reports are generated when the underlying code cannot process what the user has provided. Early on it was usually a limitation in the underlying code, but after thousands of runs it appears the underlying code is mostly bulletproof. But someone needs to know if a report does come in, it has a project number. Logging in and going to the project, you will find the exact command that the user invoked to get the failure. You can then run the same command on the command line and see the error messages from the underlying program. That's how to tell the user what they need to do to get the project to work with the Workbench.

This is all straightforward but it requires someone who can ssh and cd into the Workbench. I can do that on TEST but I have no credentials on the production machine. Therefore, someone who does needs to be reading that forum to be able to handle the reports, if any. I haven't seen any in months and the Workbench is being used about 750 times each month so this might not be a problem. I will monitor the forum thread as long as I'm around but I wouldn't be able to do anything to resolve a report if there were one.

cpeel commented 3 years ago

This change from going to a person to going to a forum works only if someone in the forum knows what to do if there is a report.

That's an excellent point. My hope is that by pointing people to the forum then there will either be someone monitoring the forum who can assist directly or someone who can poke a SA/dev for assistance. If this becomes unwieldy we can change it later to an email address but I'd like to start with the forums like we do for Guiguts as that seems more future-proof.

srjfoo commented 3 years ago

This change from going to a person to going to a forum works only if someone in the forum knows what to do if there is a report.

That's an excellent point. My hope is that by pointing people to the forum then there will either be someone monitoring the forum who can assist directly or someone who can poke a SA/dev for assistance. If this becomes unwieldy we can change it later to an email address but I'd like to start with the forums like we do for Guiguts as that seems more future-proof.

Sounds like a good approach to me.