Fog client confusion


  • Moderator

    @Junkhacker I think the exact wording doesn’t matter much as long as the direction is expressed clearly (using to and from), imo


  • Developer

    @Quazz i have never heard anyone say to image a drive and mean to create an image. I’ve heard “capture an image,” “create an image,” “pull an image,” “make a backup image” but never “image the drive” the only way to completely eliminate confusion would be to make the description ridiculously verbose.


  • Senior Developer

    @Quazz The phrasing is what I’m talking about. It doesn’t matter how you word it, somebody may make some correlation in the opposite direction.


  • Moderator

    @Tom-Elliott I think people are confused because in certain software/circles, to image a system is to capture the image, not deploy it.

    I think most people will operate from the perspective of the client device since they’ll be present at it to use Quick Image. This is also how the terminology is used in the WebGUI for scheduling tasks.

    At the end of the day it’s all semantics, and if I’m not mistaken well documented on the wiki.

    edit: Perhaps something like “Deploy image to this client device” is a decent way to phrase it?


  • Senior Developer

    To add on further:

    What is Capture?

    What is Deploy?

    Here’s why I ask those. While most will agree on the definition as we use it today, what if somebody says:

    “Isn’t the server being deployed to when the host is sending an image?”

    “Isn’t the host capturing the image from the server?”

    The phrasing really doesn’t matter, but somehow people expect context to work one way, but not the other.


  • Senior Developer

    I feel I need to clarify things.

    I understand why this question is brought up, but disagree with changing the text. Why you might ask? Because ultimately it doesn’t matter what is there. Somebody, somewhere, somehow will dislike and suggest it to be changed to something else regardless of what is there. For example, changing the “Would you like to image this system now?” question from the inits. How would we phrase it so it is definitive to EVERYBODY who reads it? Just think of your answer, then think about what somebody else might think is the “proper” answer. The reason these questions are asked the way they are, in some sense, is to help alleviate what would otherwise be a word brawl.

    Capture is relative.

    Deploy is relative.

    Image is relative.

    In verbal context, to image is to clone “this” system like another. Here’ the definition if you don’t believe me:

    Search: What is imaging
    COMPUTING
    make an exact copy of (a computer’s hard disk).
    “the hard disk drive should be imaged using a specialized bitstream backup product”

    Why does this matter, the Context is the fact that it’s to make that system’s HDD an exact copy of what’s already available. If the definition exists, but the image hasn’t been loaded, it won’t create the task because it has nothing to copy from.

    Getting “too wordy” can also be a point of problems. Somebody will essentially get a “TL;DR;” in their mind and still possibly mess it up then come in saying it wasn’t described enough.

    At what point do I stop making revisions and schema changes over text? Even with that, you still have to think of things in context of where you’re at. I’m not going to change this text in either case because somebody else somewhere down the line may make a totally separate distinction and then I’ll be “expected” to change it then.


  • Senior Developer

    How is quick image not self explanatory? It is telling you exactly what it’s going to do. It’s going to image that system.

    What do you call “uploading” then? I don’t understand how it is confusing.

    That said, there’s already a way you can change the label however you want. This is under FOG Configuration Page->iPXE Menu Configuration->fog.quickimage.

    Feel free to change the text however you see fit.


  • Testers

    @coco65 I have to disagree with this. When you use “image” as a verb, it implies that you are downloading the image to the computer.



  • @Tom-Elliott For newbies “Quick image” is not self-explanatory.



  • @coco65 Good question. I can see how a new comer would be confused. Often, too my co-workers are confused about uploading/capturing and I need to explain this is only done in the web interface.

    @Tom-Elliott can we change the text on “quick image” to “quick deploy” ? Also for full host registration, change it to something along the lines of “would you like to deploy an image now?”


  • Senior Developer

    When it’s dealing with “extras” such as during reg or at boot it is always download/deploy. To image a system is to place the data on, to capture an image is to pull it off.


Log in to reply
 

589
Online

6.1k
Users

13.5k
Topics

127.4k
Posts