pythoncoder wrote: ↑Mon Oct 15, 2018 7:11 am
mattyt wrote: ↑Sun Oct 14, 2018 10:56 am
...But I don't see any good reason to leave methods in
pyb that already have equivalents...
I do. It would break almost all of my code.
I don't want to break anyone's code.

I'm not suggesting removing anything, at least not in any short timeframe. The order should be: ensure there are appropriate replacement methods, mark 'old' ones as deprecated, sometime later (or maybe never) remove the old methods.
pythoncoder wrote: ↑Mon Oct 15, 2018 7:11 am
For all that there may be an "equivalent" in
machine, they often differ in detail. Sufficiently to cause a major headache if you have a lot of code to maintain.
I'd fight any removal of features from
pyb. Judging by Damien's comments on GitHub I think it's unlikely to happen.
OK, maybe I need to let go of the idea of
ever removing them. I certainly don't want to fight you.

I'm ok with leaving them in - my main concern is to a) provide new users clear guidance what to use and b) figure out how to better handle when port must diverge.
pythoncoder wrote: ↑Mon Oct 15, 2018 7:11 am
The ideal outcome would be one where
machine improves to the point where
pyb can be deprecated for all but a few special STM-specific purposes.
Agree completely.
OutoftheBOTS_ wrote: ↑Sun Oct 14, 2018 8:27 pm
I like the idea of an exception being raised if the feature doesn't exist on that port. That way code is portable and if u try to use a feature the hardware doesn't have then u get an exception.
I think this makes sense too. Peter, do you have an opinion?
OutoftheBOTS_ wrote: ↑Sun Oct 14, 2018 8:27 pm
The big advantage is 1 standard docs for all ports. although MP seems to be able to get contributors to write code getting contributors to write docs seems a little harder
I have a strong desire to at least create ESP32 docs based on the current documentation system, even if it is for the most part duplicates of ESP8266. This shouldn't take a huge amount of effort; it's writing and updating the docs to
describe the ESP32 differences that will take more of an effort. But if I can at least put in place the stubs we can build on it...
Looking further out I would like to think we could have common documentation for all the ports with callouts where specific ports differ from the generic implementation. However this will take some time and is beyond my current commitment level.