• 7 Posts
  • 15 Comments
Joined 1 year ago
cake
Cake day: June 9th, 2023

help-circle
  • Good documentation should, in part, tell people where to click. I have designed software documentation for high performing individuals at leading global companies, and I have designed software and hardware documentation for minimum wage fast food workers with limited English proficiency. In both extremes, I showed them exactly where to click on the screen at each step.

    You might not need that level of help, but many people do. Others do not strictly need it, but they prefer the simple instruction set. “Click here then here,” instructions ease the transition into a new system one needs to learn, or it removes the need entirely to learn a system one uses infrequently.

    The problem is that making good documentation is difficult and time consuming. It relies on a fundamentally different skill set than coding or even UI design.

    I agree that the ideal is for software to not need any documentation. In my experience, I have yet to see software that rises to that task and is used across a variety of experience levels and societal cross sections.











  • EssentialNPC@lemmy.worldOPtoFoodPorn@lemmy.worldCheeseburger soup!
    link
    fedilink
    English
    arrow-up
    3
    ·
    10 months ago

    I added the recipe link and notes to the post as an edit.

    If anything, it’s consistency was a little thicker than many chowders. Between the roux, the cheese, and the many small bits in the soup, it is very thick. I liked it this way, but I could see using more broth to thin it out a bit.

    The soup is heavy. I am a big guy who can easily put back a few bowls of soup at dinner. I could barely finish two half-full bowls.








  • EssentialNPC@lemmy.worldOPtoFoodPorn@lemmy.worldPrime rib with all the fixings
    link
    fedilink
    English
    arrow-up
    9
    arrow-down
    3
    ·
    10 months ago

    It is 100% medium rare by texture, color, and temperature. My wife prefers medium-rare bordering on medium, and this roast was acceptable to her. She strongly dislikes rare beef.

    I chose between a couple easy color correction filters on my phone, and this gave the best overall representation of the meal. It made the color a little too red, but my other choice made it a little too brown/beige and sucked the color out of the scene.