microsoft / win-student-devs

This repo aims to help student developers to build apps that run on Windows.

Win Student Devs

This repo aims to help student and early-in-career developers build awesome apps that run on Windows.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

win-student-devs's Issues

[BUG] RSS feed should build on main with certain label

Describe the bug
Right now the RSS feed will build on main branch for every push. It should only build for content change. We should control this via a label.

Day 5: Caching your app’s data

Definition	How does the Cache API work?
Differentiation	Are there more organized approaches to Cache management?
Adoption	What caching strategies should I consider for my PWA?
Exercise	Set up and manage multiple caches. Prune stale data.
Related	Get a primer on caching in Week 1: Core Concepts.

Improve the docsify style to make it easier to read the content

Proposal: Improve the CSS styles we use with docsify to make it easier to read the articles

Description

I find it a bit hard to read the content on the docsify site. Here are 3 specific things that I think could be improved:

• The page doesn't seem to have any max-width set, so if you have your browser on a big monitor, the lines of text are really long, which makes it hard to read.
• The default font-size seems pretty small, at least for me, but even comparing with popular blogging platforms, it seems to be a couple steps down.
• Color contrast seems a bit low too.
  • The background color for inline code and code blocks is very light and almost unreadable.
  • The font color for <em> text is too light too.

Globally, I feel like the site could also benefit from a slightly more modern redesign too.

Add favicon to gh-pg

30 Days of PWA blog series GitHub page needs a favicon

feat: add article PWA with authentication

Proposal: Add article explaining PWA with some authentication integration

Description

Most real world applications have an authentication step before the user can use the application. It would be helpful to include an article explaining a simple example of this. Possibly using OAuth or a PWA behind cookie authentication.

Rationale

Showing examples of this I think would improve real world PWA adoption.

Day 4: Displaying content more like an app

Definition	How can I control the way my PWA is displayed?
Differentiation	Can I do anything about my PWA window’s titlebar?
Adoption	What are some good examples of sites managing how they are displayed?
Exercise	Test different display modes. Play with the Window Controls Overlay feature.
Related	Look for other OS integrations throughout Week 2: Advanced Capabilities.

Publicize the availability of the RSS feed

As a quick follow-up to #32, you want to publicize the feed's existence.

• Add…

   <link rel="alternate"
            type="application/atom+xml"
            title="RSS Feed for #30DaysOfPWA"
            href="https://microsoft.github.io/win-student-devs/feed.xml"
   />

  …to all the pages (or page templates).

• Add a regular user-visible link…

  <a href="https://microsoft.github.io/win-student-devs/feed.xml">
    RSS feed
  </a>

  …to all the pages (or page templates).

Day 2: Creating application shortcuts

Definition	What is an application shortcut?
Differentiation	How can shortcuts make my PWA more useful? What OSes support them?
Adoption	What are some real-world examples of shortcuts?
Exercise	Add shortcuts to your own PWA.
Related	Look for other OS integrations throughout Week 2: Advanced Capabilities.

Add analytics

Consider adding Clarity or Adobe Analytics

This repo is missing important files

There are important files that Microsoft projects should all have that are not present in this repository. A pull request has been opened to add the missing file(s). When the pr is merged this issue will be closed automatically.

Microsoft teams can learn more about this effort and share feedback within the open source guidance available internally.

Merge this pull request

Update kickoff article

Kickoff article will be officially published on 2/10.

• survey link
• pre-requisite
• resources

[email protected]

Proposal: [your title here]

Description

Rationale

Preferred Solution

Additional Context

Day 1: Introducing the advanced capabilities of Progressive Web Apps

Definition	What do we mean by advanced capabilities?
Differentiation	How can the web compete with traditional apps?
Adoption	How are these capabilities created? Are they standardized?
Exercise	Check out what your browser can do today.
Related	Learn more about "Project Fugu".

Day 7: Notifying your users of updates

Definition	What options are there for alerting a user of new data?
Differentiation	How do I set up Push Notifications?
Adoption	What PWAs do a really good job with notifications and what makes their approach notable?
Exercise	Experiment with the Badging and Notification APIs.
Related	Look for other OS integrations throughout Week 2: Advanced Capabilities.

30 Days PWA Not Installable By Default

Seems to be a couple issues causing this.

Day 3: Sharing content from and with your app

Definition	What does it mean to share content between apps? What kind of content are we talking about?
Differentiation	How can I enable content from my app to be shared elsewhere? How do I set up my app to receive content?
Adoption	Who is using this capability?
Exercise	Enable content to be shared from your app.
Related	Look for other OS integrations throughout Week 2: Advanced Capabilities.

No RSS feed for the #30DaysOfPWA series

I’d love to add the site to my feed reader. Thanks!

Day 6: Synchronizing app data in the background

Definition	Can I sync data without my PWA being open?
Differentiation	What are my options for syncing data?
Adoption	What are some good examples of sites syncing data in the background?
Exercise	Create a sync task.
Related	Look for other advanced capabilities throughout Week 2: Advanced Capabilities.