Update wording for worker maintenance guidance on Flamenco Manager Console #104227
No reviewers
Labels
No Label
Good First Issue
Priority
High
Priority
Low
Priority
Normal
Status
Archived
Status
Confirmed
Status
Needs Info from Developers
Status
Needs Information from User
Status
Needs Triage
Status
Resolved
Type
Bug
Type
Design
Type
Job Type
Type
Known Issue
Type
Patch
Type
Report
Type
To Do
No Milestone
No Assignees
3 Participants
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: studio/flamenco#104227
Loading…
Reference in New Issue
Block a user
No description provided.
Delete Branch "michael-2/flamenco:vue_worker_maintenance_wording"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Original guidance message being updated...
Updated message texts for error and non-error scenarios...
Hi Michael, this patch improves the grammar in the first error message, but makes other messages less readable. I would simply check for "error" state and show a special message in the UI saying "workstation is in error state ", only for "error" state.
Thanks for the input.
Please let me know if I'm misinterpreting... but I think from what you have said, the second message (about being awake) is new?
The vue code does already have two separate messages, one for error states and one for all other states. Maybe I shouldn't have labelled them New Messages, but rather, updated message texts.
I was not adding any more new messages. In this PR I am updating existing messages - although they are still not 100% correct grammatically they read a bit better.
What i meant was:
It's also fine as you have it now.
Thanks for the improvements, they certainly are that. Just a few minor things, I've mentioned those in inline comments.
@ -119,3 +118,1 @@
<template v-if="workerData.status == 'offline'">can be safely removed.</template>
<template v-else>removing it now can cause the Worker to log errors. It
is adviced to shut down the Worker before removing it from the
<p>{{ workerData.name }} is in <span class="worker-status">{{ workerData.status }}</span> state, which means
I agree with @fsiddi that
{name} is awake
is nicer than{name} is in awake state
. For theerror
state your improvement is certainly welcome.@ -120,2 +118,2 @@
<template v-else>removing it now can cause the Worker to log errors. It
is adviced to shut down the Worker before removing it from the
<p>{{ workerData.name }} is in <span class="worker-status">{{ workerData.status }}</span> state, which means
<template v-if="workerData.status == 'offline'">the Worker can be safely removed.</template>
Given that the subject of the sentence is already the worker, I think it's clear enough to replace
the worker
withit
.I have re-arranged the HTML a bit to be readable and not duplicate too much and factor in your feedback. I removed the word "state" entirely as it still reads fine and I had a hell of time trying to include spaces between commas etc in HTML.
@dr.sybren - Sorry for all the commits... I managed to mess up a couple of files on my main branch and have reverted them back.
Let me know if you would rather I start the PR over again.
I have created a cleaner PR #104229 for this update.
Pull request closed