560
How I, a non-developer, read the tutorial you, a developer, wrote for me, a beginner - annie's blog (anniemueller.com)
submitted 11 months ago by to c/programmer_humor@programming.dev
175 comments fedilink hide all child comments
you are viewing a single comment's thread
view the rest of the comments
[–] [S] 1 point 11 months ago (1 child)

I think your tutorial depends too much on your editor UI

You mean the UI which is specified in the pre-requisites, that UI? 😂 It's not a bug, it's a feature - no bloat from going through everything twice (once for VS, once for VS Code). That's why it's in the pre-requisites.

It reminds me of those tutorials (often written by Microsoft) where the IDE has changed enough to break the tutorial.

You know I needed to write this because Microsoft hasn't written a tutorial for this topic, at all, right? That does remind me though, MAUI have changed the parameters for Grids - I better check that part of my tutorial is still valid.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [–] 1 point 11 months ago (1 child)

    It’s not a bug, it’s a feature

    It's a bad one: if I'm unable to get that version of your IDE, the tutorial becomes useless. If it had stuck to programming essentials like the source code & configuration files, then it'd have enduring value as the reader could understand without unnecessary concealment of basic information dependent on an IDE.

    no bloat from going through everything twice (once for VS, once for VS Code)

    Not implied: the tutorial would properly focus on the programming without IDE complications as it shows the files generated & dependencies linked. (eg, "I did this in my IDE: here's what it did".) The reader could in principle use any text editor. It's not an IDE tutorial.

    Microsoft hasn’t written a tutorial for this topic, at all, right?

    And you made another Microsoft-grade tutorial: that's not a compliment.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [–] [S] 1 point 11 months ago

    if I’m unable to get that version of your IDE, the tutorial becomes useless.

    No it doesn't. Clicking on the link gives you the latest version, which obviously is above the minimum version.

    without unnecessary concealment of basic information dependent on an IDE

    Haven't concealed anything - it's there in the pre-requisites

    “I did this in my IDE: here’s what it did”

    I have many screenshots showing exactly that.

    The reader could in principle use any text editor

    No they can't. Several times I cover the Intellisense options which make it easy. This isn't available in a text editor, hence the pre-requisite of using Visual Studio if you want to follow this blog.

    It’s not an IDE tutorial

    It's not meant to be. It covers what you need to know to do what I have done in the blog.

    And you made another Microsoft-grade tutorial

    Nope! They don't include pre-requisites at all, never mind links to them, never mind step-by-step processes with screenshots, etc.

  • permalink
  • fedilink
  • source
  • parent