Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Page needs clarity for people brand-new to .NET Core #13

Closed
cartermp opened this issue Jul 23, 2015 · 7 comments
Closed

Page needs clarity for people brand-new to .NET Core #13

cartermp opened this issue Jul 23, 2015 · 7 comments
Assignees
Milestone

Comments

@cartermp
Copy link
Contributor

Listing the issues here on a per-section basis.

Get Started

What is .NET Core? link leads to another landing page, not something that tells me what .NET Core is.

.NET Core Platform

Text here references BCL - a newcomer to .NET probably doesn't understand the acronym (I didn't until I looked it up online)

License

This section describes multiple licenses, so the plural form should probably be used here.

Understand the relationship between .NET Core and the .NET Framework.

  • The whole first paragraph needs to be rewritten. After re-reading it a few times, I'm still not sure about what it's telling me. Is .NET Core a part of .NET Framework? Does .NET Framework call into .NET Core? Describing their relationship as a subset-superset is confusing.
  • The last sentence isn't really helpful. I'm already assuming Microsoft is improving these components.

Learning about ASP.NET and .NET Core

"ASP.NET is the new cross-platform version of ASP.NET" is confusing. I understand that one is a link to the "new" ASP.NET, but referring to two different things with the same name is confusing.

@JimArtificer
Copy link

@Petermarcu
Copy link
Member

@cartermp, I took a stab at making these updates. The only one I couldn't find better wording for was the relationship between .NET Core and .NET Framework. I'll keep thinking about how to explain that better.

@cartermp
Copy link
Contributor Author

(It's interesting reading this now that I'm no longer new to the team/project)

@BethMassi 's blog post about understanding .NET was very helpful to me in terms of understanding what things looked like for the last release. Perhaps a similar sort of diagram would suit this section well?

@nteague22
Copy link

I know personally that the teams on some sub projects to the dotnet oss push have strong pythonic backgrounds, and the new direction seems to emulate a lot of aspects of the pyenv philosophy. Perhaps that would be a good angle to reference/allude to

@joshfree joshfree added this to the 1.1.0 milestone Jul 13, 2016
@blackdwarf
Copy link

@cartermp can we close this one? Or move it to dotnet/core-docs?

@cartermp
Copy link
Contributor Author

cartermp commented Jul 15, 2016

Scratch closing:

I think we can leave it open for now. We can copy stuff from docs into here.

@blackdwarf
Copy link

I will close this one as we have the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

7 participants