Skip to content
This repository has been archived by the owner on Apr 20, 2019. It is now read-only.

Replace the 'Build your first' tutorial #56

Closed
1 of 5 tasks
guardrex opened this issue Apr 18, 2018 · 9 comments
Closed
1 of 5 tasks

Replace the 'Build your first' tutorial #56

guardrex opened this issue Apr 18, 2018 · 9 comments
Assignees
Labels
🚀 Enhancement Enhance the topic 🚶‍♂️ P1 Normal priority

Comments

@guardrex
Copy link
Collaborator

guardrex commented Apr 18, 2018

Texas two-step ...

  • Choose a replacement sample
  • Finish the sample app
  • List parts (sub-topics) and create outlines+goals for each part
  • Write the sub-topics
  • Publish live version of the sample
@guardrex guardrex added the 🚀 Enhancement Enhance the topic label Apr 18, 2018
@guardrex guardrex added this to the Backlog milestone Apr 18, 2018
@guardrex guardrex self-assigned this Apr 18, 2018
@guardrex
Copy link
Collaborator Author

guardrex commented Apr 26, 2018

@danroth27 @SteveSandersonMS

I've been working on the Galactic Flight Finder for the past couple of weeks here and there in my spare time.

OK ... good news and bad news.

Good News

It worked out as planned. This version of Flight Finder finds flights between famous TV and movie planets (and Earth "spaceports"). If you look at the SampleData.cs file, you'll see what I used. It's a biased list ... it's pretty obvious what show I like the best! ... and the actor who I liked most to play that role! 😉

Anyone want a Jelly Baby?? 😀

Besides planets to visit, I made a number of other little changes:

  • It's 0.2.0 now.
  • Renamed our "spacelines" (e.g., RocketBlue ... British Spaceways ... etc.)
  • Made the duration and flight time less random
  • Some style and layout touches (e.g., fancy Google Font title, different select control, little rockets instead of little airplanes, etc.)
  • Did a tad of work to get codes and names into the UI over just codes alone (what fun are codes alone? ... this concept needs planet names to be fun)

Planet thumbs only appear for the defaults loaded (LHR and GAL). I'd like to continue with a small thumbnail planet picture for each planet. This UI is a bit stale with all of this text. Planet pics are trick! I'll use NASA images ... we own them.

Bad News (probably)

Flight Finder seems awfully HEAVY for a "Build your first" experience. I can definitely see this for a 2nd tutorial ... a more advanced tutorial.

I'm not saying I like that ToDo list app. That's not good imo. Let me brainstorm a list of concepts that we can toss around for the "Build your first" and report back in a few days.

🥁 Drumroll Please 🥁

Here it is! https://github.com/guardrex/GalacticFlightFinder

cc/ @Rick-Anderson

@danroth27
Copy link
Member

danroth27 commented Apr 26, 2018

🥁 Drumroll Please 🥁

Here it is! https://github.com/guardrex/GalacticFlightFinder

Cool! 😄 I think the we should replace the purple with a black + stars/planets/galaxies background.

Flight Finder seems awfully HEAVY for a "Build your first" experience. I can definitely see this for a 2nd tutorial ... a more advanced tutorial.

The idea was that this would be our flagship tutorial, similar to the Angular or React tutorials. I don't think FlightFinder is that much more complicated than the Angular Tour of Heroes app. The tutorial should start as simple as possible introducing basic concepts and working up to more advanced ones. This can be done in multiple parts where at the end of each part you feel like you've made progress and by the end you have the fully functioning app.

@guardrex
Copy link
Collaborator Author

guardrex commented Apr 26, 2018

replace the purple with a black + stars/planets/galaxies background.

👍 👍 👍 👍 👍

I'll do that on the next commit.

I'll work on getting planets in there a few at a time each day ... by the time I get clear of 2.1 issues, I should have all of the planets covered. These will be NASA-generated planets that "we the people" own. I'll also rewire it to serve them from the server app via Static File Middleware.

start as simple as possible introducing basic concepts

Ok ... it just seems like a lot of moving parts (i.e., classes) across the two apps and shared lib. Before I do anything, I'll break it down and float an outline of goals and steps for each of the parts.

@danroth27
Copy link
Member

I'll break it down and float an outline of goals and steps for each of the parts.

Sounds good

@danroth27
Copy link
Member

We should also publish a live version of the tutorial once it's done and published.

@guardrex
Copy link
Collaborator Author

If anyone has favorite sci-fi TV/movie planets, please list them here or add them to the SampleData.cs with a note on the source (I'll add the copyright info). @rstropek, let me know of any that you'd like to see on the list.

I was going to chop a few out anyway ... I went a bit overboard there 😄 ... I was having a good time and got a bit carried away with it! lol 🌍

@guardrex
Copy link
Collaborator Author

We should also publish a live version of the tutorial once it's done and published.

Added to the checklist at the top of this issue. ☝️

@guardrex
Copy link
Collaborator Author

Just wanted to provide an update here: This is still a great idea, especially as an advanced tutorial given the complexity of the code compared to the current ToDo tutorial. I WAS making updates back at the 0.5.1 release, got sidetracked with Core 2.2 work, and was never able to find the time to get back to this. I'll see if I can find some time to get it running under 0.7.0.

@guardrex
Copy link
Collaborator Author

guardrex commented Feb 2, 2019

Issue moved to aspnet/Docs.

@guardrex guardrex closed this as completed Feb 2, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
🚀 Enhancement Enhance the topic 🚶‍♂️ P1 Normal priority
Projects
None yet
Development

No branches or pull requests

2 participants