schmatic.md: UART_TX and UART_RX pins are falsely labled

[jkoeppeler]

According to this commit message ( nrf-rs/microbit@10484c6 ) and testing this myself, the pins are falsely labeled. The RX pin should be TX and vice versa.

[sagrawal-mips]

@microbit-carlos Can you please merge this pull request? This will help us new folks a lot.

[microbit-carlos]

These are the docs for the schematic, and so they follow the naming convention used there, which in this case present the internal UART from the perspective of the Interface chip.

I know this is unfortunate, as the majority of developers will look at these signals from the perspective of the Target MCU.
We've taken this as a lesson learned, and in the future we'll use longer and more clear names, like UART_INT_TARGET_TX_INTERFACE_RX, but for the time being is better to keep the references in sync between the schematic and the docs.

That being said, we should definitely add a note!
@jkoeppeler or @sagrawal-mips would you be happy to add a * next to the pin names and a clarification below the table?

[jkoeppeler]

@microbit-carlos @sagrawal-mips I updated the description and added the footnote. Let me know if you like it, or if I should change it.
And thanks a lot for the clarification on that issue.

[microbit-carlos]

Thanks @jkoeppeler!
I think the markdown parser might drop the * if they are placed on their own, maybe it'll work better adding backticks like this: `*`

[microbit-carlos]

@microbit-robert do you know if the current Markdown parser for the Tech Site Jekyll builds (is it still using Jekyll?) accepts the footnotes notation?

[jkoeppeler]

yeah I just tried it, and it places the footnote at the end of the page, which I don't like. I will change to the * as you suggested as its the better way I guess.

[microbit-carlos]

Looks like we are using kramdown and that should work:
https://stackoverflow.com/a/19507591

[microbit-carlos]

yeah I just tried it, and it places the footnote at the end of the page, which I don't like. I will change to the * as you suggested as its the better way I guess.

Ah, good point, thanks for checking, I agree it's better with the note below the table!

[jkoeppeler]

Just let me know if there's anything left or requires changes. Happy to apply them :)

[microbit-carlos]

Perfect, thanks @jkoeppeler!
And thanks @sagrawal-mips for the ping as well!

[jkoeppeler]

Thanks a lot @microbit-carlos @sagrawal-mips