esp8266-hal VS mdBook

Hi! ESP8266 is not really supported! You can use https://github.com/esp-rs/esp8266-hal but it may even fail to compile. I would suggest using any ESP32. All the ESP32 Series (ESP32, ESP32-Cx, ESP32-Sx) do have support for Rust (see the esp-rs organization) for more information. Just take into account that Xtensa targets (ESP32 and ESP32-Sx) require to install Espressif fork of Rust with support for Xtensa targets, see https://esp-rs.github.io/book/installation/index.html

Hi, I'm trying to run a simple Rust program on my D1 Mini clone (using the ESP8266-HAL. After a bunch of problems along the way, I have reached a point, where my programs seemingly compile and flash to the board without error.

I'm trying to get the ESP8266-HAL up and running. I've worked my way through a bunch of problems, but I'm currently stuck with the following error when trying to run an example using: cargo +esp espflash --release --example blinky COM3:

I'm responsible for a number of Java products. I try to provide high-quality Javadoc for all public library interfaces, library user's guides where appropriate, and development guides for applications. The latter two take the form of MDBook documents (https://rust-lang.github.io/mdBook/), with the document source living in the GitHub repo so that it's tied to the particular software release in a natural way.

My org has used mdBook: https://rust-lang.github.io/mdBook/ (That link is itself a rendered mdBook, so that'll give you an idea of the feature set.)

(While it's definitely a Rust "thing", if you just have a set of .md files, all you need is a "SUMMARY.md" (which contains the ToC) and a small config file; i.e., you don't have to have any Rust code to use it, and it works fine without. We document a large, mostly non-Rust codebase with it.)

If you want the lowest friction, open source, easily extensible Markdown to Web, Kindle, PDF, etc. tool, highly recommend mdBook: https://github.com/rust-lang/mdBook it’s written in Rust, but you don’t have to know any Rust to use it. And then wing is all CSS; for which there are many good (free) themes.