Online Documentation
Online Documentation
UPDATE: Current docs (may be outdated and lagging behind the latest development until GA release): http://micropython.org/resources/docs/e ... t/esp8266/
_____________________________________________________________
Hi,
now that this is going to be an official port, it would be nice to put the documentation online somewhere. I spent some time and effort to make it as up-to-date as possible some time ago (but I was unable to monitor all the commits for eventual changes, and since the developers happily change and move things around without updating the docs, you never know), however, due to the way it is compiled, I was unable to put it up on Read The Docs. The problem is that you have to pass a parameter to the make command to build for ESP8266, and Read The Docs doesn't support that.
I wonder if it would be possible to either do something that would allow putting it on Read The Docs, or to make it available together with the documentation of the other boards here.
_____________________________________________________________
Hi,
now that this is going to be an official port, it would be nice to put the documentation online somewhere. I spent some time and effort to make it as up-to-date as possible some time ago (but I was unable to monitor all the commits for eventual changes, and since the developers happily change and move things around without updating the docs, you never know), however, due to the way it is compiled, I was unable to put it up on Read The Docs. The problem is that you have to pass a parameter to the make command to build for ESP8266, and Read The Docs doesn't support that.
I wonder if it would be possible to either do something that would allow putting it on Read The Docs, or to make it available together with the documentation of the other boards here.
Re: Online Documentation
Documentation is also available here: http://micropython.org/resources/docs/e ... t/esp8266/
That's more up-to-date than Read The Docs because it's compiled twice daily, and compiled for each port. The problem is it doesn't have the nice sidebar like RTD, with version selection, PDF download, etc. You also can't select the port (you must enter it in the URL manually). Once these things are fixed (they've been in my queue for a long time now...) then docs.micropython.org can link to these docs rather than RTD.
That's more up-to-date than Read The Docs because it's compiled twice daily, and compiled for each port. The problem is it doesn't have the nice sidebar like RTD, with version selection, PDF download, etc. You also can't select the port (you must enter it in the URL manually). Once these things are fixed (they've been in my queue for a long time now...) then docs.micropython.org can link to these docs rather than RTD.
Re: Online Documentation
Thanks, I think this is enough for the time being, as long as people can find it here!
Re: Online Documentation
Is there will be a separated domain name for this? it's hard to find .
Re: Online Documentation
deshipu, I'd like to assure you that docs are in the top scope of the work. So far however we didn't get to touch them yet, while running the campaign and having a feature accumulation sprint. Current docs would need to be largely rewritten for the new port.
Awesome MicroPython list
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Re: Online Documentation
All docs have now been moved from read-the-docs and placed on the dedicated MicroPython server. So now everything is available, up-to-date, at:
http://docs.micropython.org
In the side bar you can select the port and version of the docs that you need.
The source for these docs can be found in the docs/ directory of the main git repository. They are rebuilt every 12 hours and put online at the above URL.
http://docs.micropython.org
In the side bar you can select the port and version of the docs that you need.
The source for these docs can be found in the docs/ directory of the main git repository. They are rebuilt every 12 hours and put online at the above URL.
-
- Posts: 463
- Joined: Wed Apr 08, 2015 5:19 am
Re: Online Documentation
A few links on micropython.org are now broken:
- The "Quick-Ref" link in the site header, http://docs.micropython.org/en/latest/p ... ckref.html gives a 404.
- Also the "Tutorials" link in the site footer.
- Also all the links on http://micropython.org/help/
- The "Quick-Ref" link in the site header, http://docs.micropython.org/en/latest/p ... ckref.html gives a 404.
- Also the "Tutorials" link in the site footer.
- Also all the links on http://micropython.org/help/
Re: Online Documentation
Thanks @SpotlightKid for reporting the broken links, they are now fixed!
- pythoncoder
- Posts: 5956
- Joined: Fri Jul 18, 2014 8:01 am
- Location: UK
- Contact:
Re: Online Documentation
Re "ports and versions" on the sidebar, the unix port gives a 404. On other ports if you select an old version, you lose the "ports and versions" section so you can't get back to the current version (via the sidebar).
Peter Hinch
Index to my micropython libraries.
Index to my micropython libraries.
Re: Online Documentation
unix 404 is now fixed, at least for the latest and v1.6 versions (earlier versions had an error in compiling the docs...). Regarding not having the sidebar for old versions, that's harder to fix because it requires patching the old versions to include this new feature!pythoncoder wrote:Re "ports and versions" on the sidebar, the unix port gives a 404. On other ports if you select an old version, you lose the "ports and versions" section so you can't get back to the current version (via the sidebar).