search

CesiumGS / cesium-unreal

Bringing the 3D geospatial ecosystem to Unreal Engine
https://cesium.com/platform/cesium-for-unreal/
Apache License 2.0
932 stars 294 forks source link

Learning Content: Post-Launch Master Issue #352

Closed argallegos closed 3 years ago

argallegos commented 3 years ago

Update: This is now deprecated, visit https://github.com/orgs/CesiumGS/projects/2 for an updated learning content project board.

This is a continuation of https://github.com/CesiumGS/cesium-unreal/issues/227, the pre-launch master issue. Figured it's better to make a fresh issue for learning content going forward. This issue will track the status of individual learning content pages, and also be a discussion board for the structure of tutorials going forward.

With that, I'm proposing a reorganization for learning content in the comment under this.

Please update this comment as tutorials are updated/completed. Each entry should follow the following format:

Status symbols 🔵 Done (Published!) 🟢 Ready for Prismic migration 🟡 In Review 🔴 In Progress ⚪ Not started Urgency symbols ❌ Blocked ❗ High priority, do this first

Task Tracker

Completed tutorials

argallegos commented 3 years ago

As it currently stands, the learning content on the website is in two categories - the standalone Quickstart page, and then the Getting Started tutorials.

Most of the learning content pages I've seen for comparable media tend to have more categories with fewer pages per category, so that users can find things easily. Cesium for Unreal is definitely smaller than Unreal's docs, for example, but it may be best for us to pursue a similar format, especially as the plugin grows and we are able to create more learning content and examples.

With that in mind, I propose that we break this out into a few more categories:

LisaBosCesium commented 3 years ago

@argallegos Thanks for pinging me on this.

Agree, this fits nicely with the plans for the revised Learning Center navigation on the new website - and in fact is a great validation of why we need it. On the new site, the user will:

  1. Go to the Learning Center (cesium.com/docs)
  2. Click on "Cesium for Unreal" in a top subnav (officially called the "sibling nav" - example is the list of industries here)
  3. Be shown a landing page for Cesium for Unreal, and be able to interact with a left nav that is specific to Cesium for Unreal - what you list above

And of course they can bookmark and we can link to the Unreal landing page as helpful.

There are only two more headings in the Unreal nav above than on the current site, so I think we can implement this on the current site without negatively impacting users. I'm glad we're getting the new nav though - will be very crowded pretty soon on the current site, and the current (annoying) scroll behavior when left nav document headings are expanded could potentially get a little worse.

Whatever tutorial content is under development in May will be included in a piloting effort to make sure the nav and other Prismic/site components work as we want them to, so the timing of this work is great. Will also want your input on the Unreal landing page content.

LisaBosCesium commented 3 years ago

@argallegos (and all who have opinions)

1) It's time to decide on the first incarnation of the Cesium for Unreal left nav for the new site. We can easily expand it over time as more content is added. We don't have live content for these sections. Will we by June 11?

2) As noted, in the revised Learning Center we will have an Unreal landing page. The general idea for these is to a) link to key tutorials/guides, b) highlight what's new, and c) link out to cool community content (eg user projects). For Unreal I assume we'll also link to the Unreal Marketplace. I'll draft a first pass and circulate it for review, but let me know if you have additional/different/specific ideas.

argallegos commented 3 years ago

@LisaBosCesium

Thanks for checking in. Currently under review we have a single tutorial page each for Building Realistic World and Lighting and Rendering, and a second tutorial for Lighting and Rendering is in the works. The plan for those three is to merge them all in sometime this week, so they will definitely be live by June 11.

We don't have anything yet for the Technical Guides section, so I think we should omit that category for now, but plan to add it later.

I'm excited to see the new landing page, all the content that you have planned sounds good! I'll let you know if I think of anything specific that needs to be on it.

LisaBosCesium commented 3 years ago

Thanks, @argallegos!

argallegos commented 3 years ago

@LisaBosCesium The merge for the tutorials currently under review is pushed to early next week to align with the plugin update. I'll let you know when they're live!

LisaBosCesium commented 3 years ago

@argallegos Where does Transition Between Locations on the Globe fit in the new outline?

LisaBosCesium commented 3 years ago

@argallegos When the new tutorials are ready to go, let me know and I'll schedule some time for you and me to talk about getting them into Prismic. This is the week for doing a pilot of sorts to see whether you have feedback we want to react to in time for launch of the new Learn at the end of next week.

argallegos commented 3 years ago

@LisaBosCesium

The Transition Between Locations tutorial belongs in the Example Projects section. I'm just doing final touches now, and the new tutorials should be ready to merge by EOD today. We can talk tomorrow if you're free!

LisaBosCesium commented 3 years ago

@argallegos Our schedules today only allowed for 30 minutes, but that should do it - more tomorrow if needed.

argallegos commented 3 years ago

This tracker has been updated to reflect the the new categorization of the learning content, and reorganize based on current status of individual pages. Note that it does not match the categories suggested in the second comment on this issue.

argallegos commented 3 years ago

Now that we have this public project board for tracking learning content, I'm retiring this issue. Visit the project board instead: https://github.com/orgs/CesiumGS/projects/2