Initial skeleton of the cookbook in mdbook format #63
Conversation
cookbook/README.md
Outdated
|
|
||
| And then build it: | ||
|
|
||
| mdbook build |
There was a problem hiding this comment.
Prefer mdbook serve and instructions with opening browser.
There was a problem hiding this comment.
Good idea. How does it look now?
|
What are your thoughts on the advantages of having this as a separate book vs just having it as a new section in the existing guides? |
|
This comment which references the rust cookbook made me think that an mdBook was the target format. But if that's not the case, then we can simply drop this PR. On the other hand, if we want mdBook for everything (not just the cookbook), then I can easily modify the structure to bring everything under the mdBook structure. |
|
mdbook provides links to run in the browser, expand hidden lines, and is backed by rust-skeptic. It looks like your ci is integrated with tests, but I'm not sure how convenient they are running locally. |
|
Ah, I was only referencing the rough structure (one page per category and many examples per page). If mdBook can be made to integrate into the Tokio website's layout and CSS (https://tokio.rs), then I would be fine wity replacing the docs section entirely with mdBook. My primary goal is to maintain a cohesive website feel. |
|
That said, the sketch looks good at a glance 👍 |
|
@AndyGauge @eminence if you want, someone can open an issue here to discuss mdBook for the website. |
|
let me take a stab at bringing in the tokio website style into this book skeleton to see how that looks. then we can see how to move forward from there. |
This creates an initial skeleton of the cookbook in mdbook format (the same format used by the rust cookbook).
The only content here is a copy of
cookbook.md, but split up into multiple files. Hopefully this layout matches what you had in mind for the cookbook.Preview of the rendered book