MicroPython Forum (Archive)

I see that Micropython was selected for the season of Docs.

Joannah here, a Python core dev and contributor to other Python open-source projects.

I want to use GSoDs to help write docs on the internals of Micropython.

Happy to hear from you so I can share a plan I have in mind.

Best,
Joannah

Hi,
sounds like a neat idea. I do some teaching with Micropython for some classes and albeit docs for usage are available exactly the internals are the most difficult part to find information about. Second to this would be documentation how to port Micropython to another board or another architecture.
Would be happy to hear about your ideas.

Actually, I was motivated to work on this because I was looking for internals information for MicroPython after the Python language summit at Pycon last year(2019).

I did not think of the part on how to port Micropython to another board or another architecture but I think it makes sense to be covered as part of this work.

Now, If no one is working on this as a project, I propose to use the following plan of action:
- Use the next three weeks to tinker some more and come up with an outline. It would be two but I have a research paper to write this week.
- Submit a PR for the outline for review.
- The community gives suggestions on the outline.
- If the PR is approved, I start writing based on this.
- we can follow GSoDs timelines.

I think we will just add another section here: http://docs.micropython.org/en/latest/ named "MicroPython Internals".

As Joannah has already revealed, MicroPython has been selected for the Google Season of Docs 2020 program!

For those that unfamiliar with SoD, it's an annual effort by Google - in just the second year - to improve the documentation of open source projects. There is a process where Organisations and then Tech Writers apply to be involved. Google selects from each group and assigns - and pays - a Tech Writer to work on the Organisation's documentation for around three months.

Currently the SoD program has selected the Organisations and is now accepting applications for Tech Writers. Work is scheduled to begin in August/September.

Jim and I, and many others, are excited at the potential improvements SoD could deliver for MicroPython! Please take a look at the Season of Docs Project Ideas - 2020 and please let us know if you have any feedback.

So I see three major areas to tackle for documenting micropython internals

- The core
- cross-compilation
- Porting

A more concrete outline of what I want to cover is developing as I dig deep. I am still investigating micropython core.

I was on the fence about including details on micropython-lib but another part of me thinks we can leave this out of internals documentation. what do you think?

I think the existing documentation has serious problems with accuracy. Many things are outdated, specific to a port or not specific enough (important differences between ports are not listed) or just plain wrong. That's one of the first areas, which I think needs attention.

Let me first start by thanking both Matty and Jim on creating the Project Ideas documentation. I am in full agreement with the list of areas mentioned in the Ideas Summary Section. I think that list is in order of need and should be followed as much as possible.

Once you guys have a more defined plan of how you propose to proceed, please post here and I will be happy to help in any way as I'm sure that others will.

Fantastic job, both of you.

Thanks for the suggestions @SpotlightKid.

I agree, correcting this is a great first step. From the project list, I was looking at creating new documentation specific to micropython internals. That is what I understood. And am coming up with an exhaustive outline for this.

I will open some PRs correcting some of these current inaccuracies but there are ideas on the list that focus on improving current docs and am sure someone else can pick that up too.

I opened a pull request with an outline here; https://github.com/micropython/micropython/pull/6098

I will appreciate any feedback.

Hello, I am Ogheneyoma an electronics and computer engineering student at the University of Port Harcourt and I’m interested in the GSoD idea “Create a Getting Started Guide”
I'd like to share a brief implementation outline I am working on with the community.