Skip to content

Conversation

@jacobhylen
Copy link
Contributor

@jacobhylen jacobhylen commented Nov 20, 2023

What This PR Changes

This PR fixes a couple oversights in the MicroPython 101 Course:

  • When we've reordered tutorials within the course, we didn't change the "next chapter" links, so if you follow them the order is jumbled and incorrect.
  • In the installation guide, we were listing the tools to be installed, with links. The links may seem initially like they would be a good idea, but they inherently prompt readers to click, and download. Instead, we should prefer them to wait with downloading until they get to the step by step guide later on the page, for a more intuitive flow.
  • One empty link.

Contribution Guidelines

@gatsby-cloud
Copy link

gatsby-cloud bot commented Nov 20, 2023

✅ docs-content deploy preview ready

Copy link
Contributor

@karlsoderby karlsoderby left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think while we are at it, let's consider changing the top part of this tutorial. It starts with ## Goals and then goes directly in to it. There's currently no other chapter having a "Goals" section as well.

I think maybe it would best to have a gentle introduction at the very start, along the lines of:

To use MicroPython on an Arduino, we need the two following tools: - [MicroPython Firmware Installer]() - a tool that installs a specific firmware on your board, so that you can program it using MicroPython - [MicroPython Lab for Arduino]() - an editor that you can program your Arduino in (like the Arduino IDE).

Doesn't need to be exactly like ^, but some sort of intro!

@jacobhylen
Copy link
Contributor Author

@karlsoderby How's this? :)

jacobhylen and others added 3 commits November 21, 2023 11:10
…-tools.md Co-authored-by: Karl Söderby <35461661+karlsoderby@users.noreply.github.com>
@karlsoderby karlsoderby self-requested a review November 21, 2023 12:53
@jacobhylen jacobhylen merged commit 0c3e183 into main Nov 21, 2023
@jacobhylen jacobhylen deleted the jacobhylen/micropython101-feedback branch November 21, 2023 12:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants