Is there a glossary somewhere? New minds are overwhelmed. about windowsappsdk HOT 4 CLOSED

Adding onto this, I think it could be very helpful to have a sort of "quick start" to help both those who are new altogether, and those who may not be 100% familiar with all the terminology and concepts used.

TypeScript does a fantastic job of this IMO, they have a brand new website that outlines exactly what TypeScript is, and how to get started, whether you are new to programming, or coming from another language like JavaScript, Java, or C#. https://www.typescriptlang.org/docs/handbook/typescript-from-scratch.html

I think this could be a good model for Project Reunion. There's been numerous issues in both this repo (#17 #30 #36 #40 #53) and some others (MAUI #47 #122) expressing confusion, and a lot of questions about how things relate to each other. A "get started" guide like how TypeScript has could be a good way to get everyone on the same page, no matter what background they come from.

Something structured like this basically:

• Project Reunion for new programmers and/or students

  • What is Win32 (pros and cons)
  • What is UWP (pros and cons)
  • How Project Reunion unites them under a single platform
  • Quick explanation of C++ vs .NET (WPF/Forms/UWP) vs React/JS, how you can use any one to develop for Windows
    • Links off to other tutorials, like UWP
    • Needs to be clear that Project Reunion is not a way to develop apps - aka "go develop these somewhere else, then come back and read the appropriate next section to learn how to take advantage of Project Reunion" - as this seems like an easy point of confusion

• Project Reunion for Win32 developers

  • What is Project Reunion
  • What components are available, how they can be useful, etc...

• Project Reunion for UWP developers

  • What is Project Reunion
  • Migrating to WinUI
  • Migrating to .NET 5? (answers to questions in #17 #40 #53)
  • ??? (does Project Reunion bring anything new to UWP devs? future plans here?)

• Project Reunion for React developers

  • What is Project Reunion
  • Bringing apps to Windows
  • Using new components, how they can be useful, etc...

That's just a quick skeleton off the top of my head - I'm not sure how much of this is actually feasible, and it doesn't necessarily need to be full articles like TS has, but I think a tailored approach would definitely be a good way to go.

Best to separate out students, UWP fans, longtime Windows developers, and developers from other platforms, since from my experiences in a couple of MS repos here, these are very different groups, with different needs.

from windowsappsdk.

@alphahorse - please do add a comment with the set of terms you're interested in! @mevey or I will be happy to put together an update to the FAQ (or a new GLOSSARY.md) with them.

from windowsappsdk.

@mevey can you take point? Several of us could collaborate on the content.

from windowsappsdk.

I've started a Glossary wiki page that we will develop more.
@KyleNanakdewa You make some great suggestions and we are working to make sure that the docs, FAQ and Glossary can be informative for all categories of Windows developers.

from windowsappsdk.