5 ms·

That is indeed too technical. Try to explain how inserting an image is not just copy paste.

• rcarr 4y ago
  1. Paste image into assets folder. 2. Write . It's not that hard really is it.
  • vasco 4y ago
    Have you worked with non-technical teams, ever? Perhaps in teams of very young and gamer-type people this would work, but in any real world team I've been in, this would not in fact be easy unless there's a real time preview and a button you can click that auto-generates that snippet. People would forget the exclamation mark, mixup the brackets with the parenthesis, not know how to reference the right path to the image, and ask a developer to help them out.
    • someguydave 4y ago
      If someone is confused by markdown syntax it is hard to imagine how they contribute professionally.
      • mym1990 4y ago
        Maybe you should try to imagine a little harder. "If You Judge a Fish by Its Ability to Climb a Tree, It Will Live Its Whole Life Believing that It is Stupid"...or in this case you will live your whole life believing every non-technical person around you is stupid...which just sounds miserable for everyone involved.
    • rcarr 4y ago
      Well presumably this would be less of an issue if you had easy to use, easy to search and easy to maintain documentation, you know, maybe in the form of markdown files with a search bar where you could type 'how to paste image into documentation' in case you forgot... At the end of the day, if you've got someone who can't work out how to drag a file into a folder and then type  after you've shown them a couple of times, is this really the person you want writing the documentation for your process?
      • koonsolo 4y ago
        At the end of the day, if you've got someone that can't figure out there are people that are not good at technical things, do you really want them to develop your user facing software?
        • rcarr 4y ago
          Ok mate we’ll all go back to living in huts because we decided we had to go at the pace of the slowest people in society.
  • goatlover 4y ago
    So you're replaced something that's simple as paste in office documents with two separate steps, one outside the app requiring the user to navigate to the assets folder, and the second requiring remembering specific syntax.
    • rcarr 4y ago
      Not really because if you're using Obsidian you can just copy paste images and it will handle the syntax and moving the asset into the correct location anyway. But is taking an hour to read through a markdown cheatsheet really the worst thing in the world if what you end up with is far more useful and maintainable documentation? Seems like a pretty big pay off for not a lot of staff training.
      • phailhaus 4y ago
        > But is taking an hour to read through a markdown cheatsheet really the worst thing in the world if what you end up with is far more useful and maintainable documentation? This makes no sense given that you get the same payoff by using something like Atlassian's wiki. No git, no markdown, none of this nonsense, users can just immediately hit the ground running with advanced formatting support and version history. I think you're lacking a lot of empathy for nontechnical users. I don't see how you could ever argue that your git + Obsidian stack is "more valuable" than an off-the-shelf wiki solution.
        • rcarr 4y ago
          Because I'm tied into Atlassian's ridiculous way of doing things as opposed to a completely open file format I can take anywhere and edit in any number of editors. I have empathy for non technical people in that I believe Markdown is far easier to use than Atlassian's interface. Every single developer I've worked with has been tearing their hair out when trying to write documentation on Confluence and documentation never got written as a result. If this is the experience for technical people, what on earth is the experience like for non-technical people?
  • koonsolo 4y ago
    I can already picture it: "Hey rcarr, how do you insert a picture again?" "With " "My image is not showing up!" "Let me take a look at it..., oh, it seems you mistyped the filename", "Oh yeah, sorry about that". Welcome to the world of non-technical people.
• tgsovlerkhgsel 4y ago
  Make it copy-paste. Automatically upload it to the image blob storage and insert the image code, then show the WYSIWYG preview.
  • koonsolo 4y ago
    Sure, and then the question comes of why you have a separate editor and preview, and you finally end up with a WYSIWYG editor.