New features page! - Githubissues

github-education-resources / classroom

GitHub Classroom automates repository creation and access control, making it easy for teachers to distribute starter code and collect assignments on GitHub.

https://classroom.github.com

1.35k stars 569 forks source link

New features page! #2259

Open stephaniegiang opened 5 years ago

stephaniegiang commented 5 years ago

Feature request :sparkles:

We should create a place where we can announce new features to user.

This could be something like a drop down listing the latest three features and then a link on the bottom bringing to a page listing all new features.

The problem statement

Introducing changes always has the potential to disrupt existing users' behavior/workflow. Even if it optimizes/improves their workflow in the long run, we want to present changes in a way that gently introduces change so they can adapt and re-learn if needed. We also need to be mindful that teachers don't often have time to read

femmebot commented 5 years ago

I'm guessing this was the intent behind Check out what's new, just not well-executed.

whats-new

EricPickup commented 5 years ago

I like this idea! We could have a changelog or something like that for user-facing changes.

We could do this pretty easily using a markdown page.

stephaniegiang commented 5 years ago

Yep! I think the PR list isn't super helpful since there are a lot of low level fixes going in. Especially when we are making smaller PRs to build a feature. Would love to work with you @femmebot on this after the roster import improvements 😄

femmebot commented 5 years ago

Sounds great! Yes, I think there are a couple of potentially helpful announcements for updates:

A changelog — something that summarizes all the noteworthy changes in a more consumable way than what we are doing now (which is to point them [here] )(https://github.com/education/classroom/pulls?q=is%3Apr+is%3Amerged+sort%3Aupdated-desc)
Some mechanism for highlighting bigger ships like LMS integration, and faster code imports using template repos. (We're currently using the message of the day banner for this. Sorta.)

BTW I added a problem statement which we can edit/refine later on. I just wanted to be able to refer to something that helps define what problem we're solving and why they have this problem.

stephaniegiang commented 5 years ago

Update: We are going to start working on this project in conjuction to the new roster updates 😄

femmebot commented 5 years ago

I started to put together a bunch of "What's new" examples from various applications. Let me know if there are others you can think of that we should add for inspiration (they don't necessarily need to be well-executed)

stephaniegiang commented 5 years ago

I like the idea of Netflix, instead of a notification bell it can be a different icon?