SmartmanApps

Like Git, GitHub

Not sure how many times I need to tell that that it isn't a pre-requisite.

… I did.

No you didn't. I just added screenshots in my other reply pointing out all the links that you didn't click on.

you mention commits.

for those who are taking the option of following the repo.

Knowing wtf you are talking about is a prerequisite to literally understanding the words you are typing

You think people would be following along in the repo if they didn't know what a repo was?? 😂

To anyone that knows nothing about programming your words are completely nonsense here

Why would "anyone that knows nothing about programming" be reading a blog about how to write a MAUI page in C# instead of XAML? 😂 And, again, this is covered by the links in the pre-requisites, the whole point to begin with.

they will think “then why did this author mention it?”

Because it's optional

The first mention of layouts is when you

...go read the information at the pre-requisite links.

which is nonsense to someone that doesn’t know anything about layouts

And why would "someone that doesn’t know anything about layouts" be reading a blog about layouts in MAUI? 😂

you literally just had us delete it!

I also covered the process for (re)creating the whole project at the beginning, for those who didn't have the common sense to read through what what was going to happen after we delete it, or they can click on the first version in the repo, and these are Windows developers, so it's probably still in the recycle bin, so yes, they most definitely can.

you said we don’t need to click on the link to the code

That's right.

you said everything would be provided in the article!

Yep, including links to pre-requisites.

All of which are false at this point

Nope, none of which are false.

WTF are ScrollView and VerticalStackLayout

Covered by links in the pre-requisites and subsequent directions on what to do.

This requires prerequisite knowledge of how layouts work.

Covered at the pre-requisite links.

This is not in any of the prerequisite links

I already proved you didn't look at any of the links there, like...

(meaning we can’t just read the tutorial to find the information we need

You can if you're already familiar with everything in the pre-requisites.

you’re forcing users to do the coding

How am I forcing them? They can just read it all if they want. Also, you know that's why they are reading the blog in the first place, right? 😂

no you literally don’t

Yes I literally do. "gives us a consistent look throughout the app, and in fact a consistent look across all our platforms (because we are now replacing the default colours with our own colours)", etc.

The first link is a download link.

It's a download page. Scroll down past the download link.

The second link is a download link

Ditto...

The third link is a link to a single tutorial titled “Introduction to C#”

Ditto

git, or even github

Still not a pre-requisite

Do you really need me to go paste all of the text from those pages here into a comment so you can see for yourself?

I just pasted screenshots showing where you can go deeper as needed on the actual pre-requisites.

this either needs to be combined with the first sentence or needs to be capitalized

It's a reserved keyword, always in lower-case.

you also switch between colour and color numerous times

color is a reserved keyword, colour is correct English (since I'm not American).

there’s more

And several that you've referred to already are in fact not typo's.

Just stop arguing about having a perfect tutorial

I never said that Mr. Strawman. I gave it as an example of how to cater to all levels of reader. i.e. pre-requisite links, etc.

Claiming that you have is honestly ridiculous

And you claiming that I did is ridiculous.

I also would never choose to do a tutorial on dev.to.

It's there because that's where some of the MAUI team post blogs themselves - all in one place. - but good on you for criticising me without even asking why it's there.

You never once show the full file in the article

Again, yes I do, at the beginning

so stating that you need to leave your article to see the full code is the exact opposite of what your tutorial has stated

No it isn't. I stated that was optional at the beginning.

your tutorial is severely lacking

says person picking on typo's (some of which aren't) and didn't explore any of the pages linked to in the pre-requisites. I guess you expect me to re-invent the wheel in the latter case...

continue writing tutorials like this one

that have links to pre-requisites, which is the whole point to begin with, but sure, pick on some typo's (some of which aren't) because you can't refute the actual point... 🙄

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.

It’s like the difference between going to a mechanic that has you sit by the coffee machine in the office ...

Good example. I just wanted to add that the place I go to for tyres, if there's some kind of issue (like with balance or alignment), sometimes they even take me into the workshop (where customers are usually not allowed) to show me what the issue is.

Others are debating the point about the doc itself

Most of those others have shown they only read the first paragraph (which is literally the introduction, not the start of the tutorial itself).

just because you enjoyed doing it, doesn’t mean others do, or have the time

I never implied otherwise. I simply used it to show it only takes a few minutes to include pre-requisites for the thing you are writing, compete with links to relevant resources. Microsoft documentation never does either of those things, and those people are paid to write it. Then they ignore your issues that you raise. I forget his name now, but I remember one guy there who did this all the time - would just close your issue and not update the document. I remember one time James Montemagno fixed up an issue I raised, but this other guy, never. I just gave up on raising issues. I'm surprised his name isn't burnt into my memory with PTSD 😂

Of course. But that wasn’t the complaint/satire of the satirist whose article we’re discussing

I think you'll find that's a huge part of the complaint - unexplained terminology. See Microsoft tutorials that never tell you what any of their TLA's are, nor link to any explanations of them, exactly as is satirised

So maybe the tutorial the satirist was satirising just wasn’t quite aimed at the satirist

I think many people here have seen exactly such tutorials - indeed aimed at them - hence the huge upvotes. See Microsoft tutorials that never link to any pre-requisites at all (leaving you looking for a Youtube by an Indian programmer).

I can’t start the tutorial at 1+1=2

But you can put it in the pre-requisites

there’s no need for the apostrophe

Ok, I fixed the typo.

There’s a difference between “a beginner” and “someone who is very experienced but hasn’t done X”.

If they haven't done X then they are a beginner at doing X - no difference - this is in fact the target audience for many tutorials. The other things which aren't covered in the tutorial you put in the pre-requisites.

not a “developer who understands and uses 90% of the same tech stack, but is looking to do something new related to it”

and yet, a lot of tutorials written for developers who have used 90% of it are written just as badly, hence the huge upvotes.

If it were aimed at true beginners it would be written completely differently

That's the point! Many tutorials need to be written completely differently! 😂 For starters all of the ones at Microsoft.

A university teacher preparing a lecture about shakespeare doesn’t write the same lecture if their audience is a bunch of 5 year olds

That's because the course has pre-requisites that you must have passed before you can enrol in that course - if you don't, then you have to go study those things before you'll be allowed to enrol - and they are explicitly spelt out in the guide to enrolling, hence the professor can write the lecture safe in the knowledge that all students in his class have completed all of the necessary pre-requisites.

You know that’s not true, right?

I know it's absolutely true. Even my threads on Maths are written with the assumption that the reader doesn't know all of the background knowledge (in fact are written quite intentionally for those who are being bullied by gaslighters, and they lack the proof to debunk them).

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.

I don’t want to make this a “gotcha”, but you say no xaml knowledge needed but then talk about it and have the reader touch them (mostly delete).

I only have them delete the XAML files. You don't need to know anything about what's inside a file to delete it 😂 Also, I only talk about the benefits of getting rid of them, which also doesn't require any knowledge of XAML.

You say you usually delete this xaml file but I don’t need to do that. Why?

No I don't! I say disabling implicit usings is optional, and do explain why I do it, then delete the XAML files. You seem to have conflated 2 successive paragraphs.

I thought I didn’t need to know xaml?

You don't. They're never used anywhere in the whole thing. We only delete the XAML files, then replace them with C#.

I read your entire tutorial.

Not very carefully apparently.