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

use of AspNetCore.Docs-master #13414

Closed
edikaufmann opened this issue Jul 21, 2019 — with docs.microsoft.com · 9 comments
Closed

use of AspNetCore.Docs-master #13414

edikaufmann opened this issue Jul 21, 2019 — with docs.microsoft.com · 9 comments
Labels
Source - Docs.ms Docs Customer feedback via GitHub Issue

Comments

Copy link

As a retired (mid seventies !) 'hobby' developer I'm struggling to follow/use the instructions given in
the document: "Introduction to ASP.NET Core" it says:
....
How to download a sample

Many of the articles and tutorials include links to sample code.

  1. Download the ASP.NET repository zip file.
  2. Unzip the Docs-master.zip file.
  3. Use the URL in the sample link to help you navigate to the sample directory.
    Preprocessor directives in sample code
    ....

HOW do I now use "AspNetCore.Docs-master" to simply download e.g. the "ef-mvc" sample ?
OR "view" the final "ef-mvc" e.g. in VS2019 ?
(as the sample suggests in every chapter ["Download or view the completed application."])

Of course I downloaded "AspNetCore.Docs-master" BUT I'm obviously to old/dumb to understand.
I must be the only one struggling with this approach ....

Therefore thanks for your time to help me out or, at least, give me the right kick to start ..!

PS: yes I have gone through the course "ef-mvc" to build it step by step, successfully!
thanks, ek


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

@dotnet-bot dotnet-bot added the Source - Docs.ms Docs Customer feedback via GitHub Issue label Jul 21, 2019
@guardrex
Copy link
Collaborator

Hello @edikaufmann ...

Looking at the landing page of the GitHub repository, download the ZIP archive of the whole repo ...

Capture

Decompress it and navigate through the folders to the same location that is indicated by the URL of the sample. For this sample, dig down through the folders to ...

AspNetCore.Docs/aspnetcore/data/ef-mvc/intro/samples/cu-final/

Capture2

The docs engineers were planning a way to download just a single sample a while back for all of the Microsoft repositories, not just ours. Not sure if that plan was dropped or if they still plan to do it.

For now, downloading the entire repo is required. After doing so, you have all of the samples. Just make sure that you pull down a new repo every so often because we're regularly updating sample apps, especially around the time of a framework release.

If you wonder about a given sample's current version and to track the work on sample updates, we have a tracking issue at #5495.

@edikaufmann
Copy link
Author

Hi Luke,
thanks a lot for taking the time.
I have attached a screenshot like yours (gitshot.png). As you see I DO NOT have the 'Clone or Download' button - as I mentioned in my first msg (#13403).

I think if I would see the ZIP button - problem solved! (I have a history button instead - see attachement)

So again, what I'm doing wrong NOT to have that button!?

Gitshot

@guardrex
Copy link
Collaborator

Back out ... you don't get the button within the repo, only at the top level of the repo. Click on "AspNetCore.Docs" link at the top-left of your screenshot.

@guardrex
Copy link
Collaborator

I'm going to make an instruction change there to surface that.

@guardrex guardrex reopened this Jul 21, 2019
@guardrex guardrex self-assigned this Jul 21, 2019
@guardrex guardrex added the Pri1 High priority, do before Pri2 and Pri3 label Jul 21, 2019
@guardrex guardrex added this to the 2019 Q3 ends Sept 30 milestone Jul 21, 2019
@guardrex guardrex changed the title use of AspNetCore.Docs-master Surface additional instruction for downloading samples Jul 21, 2019
@guardrex
Copy link
Collaborator

Nevermind ... it's already done. The download instruction links to the download archive directly. That's best.

@guardrex guardrex removed their assignment Jul 21, 2019
@guardrex guardrex removed the Pri1 High priority, do before Pri2 and Pri3 label Jul 21, 2019
@guardrex guardrex removed this from the 2019 Q3 ends Sept 30 milestone Jul 21, 2019
@guardrex guardrex changed the title Surface additional instruction for downloading samples use of AspNetCore.Docs-master Jul 21, 2019
@guardrex
Copy link
Collaborator

Good news @edikaufmann ... Yes! They're working on it.

See 👉 MicrosoftDocs/feedback#982

Copy link
Author

I'm obviously getting older than I thought - i.e. I'm now totally confused!

I downloaded AspNetCore.Docs-Master before; did it again; I find aspnetcore/date/ef-mvc - no problem!

How do I now VIEW (run) this ef-mvc ? in VS2019 ?

I do not see any .sln file nor any C# code...….

I apologize for my ignorance but definitely need a kick start on this - perhaps I don't see the forest for trees!?
Thanks again for your time, ed

@guardrex
Copy link
Collaborator

No worries. We hear these questions regularly. We can't document too much on these aspects because we just focus on the programming bits.

Use Open a project or solution when VS first opens. Select the project file (*.csproj file) in the root directory of the project.

VS will create the solution file for you and ask you where to save it when you close the project.

@edikaufmann
Copy link
Author

well, well … thanks a million! In the end it's always clear and obvious!

for me a hint like - would had helped!?
3. Use the URL in the sample link to help you navigate to the sample directory; find the .csproj; open it in VS.

Need now to figure out how to handle the DB
Anyway I appreciate your help, THANKS!
ed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Source - Docs.ms Docs Customer feedback via GitHub Issue
Projects
None yet
Development

No branches or pull requests

3 participants