Skip to content
This repository has been archived by the owner on Mar 29, 2024. It is now read-only.

Consider writing book/tutorial #14

Open
yupferris opened this issue Sep 4, 2020 · 6 comments
Open

Consider writing book/tutorial #14

yupferris opened this issue Sep 4, 2020 · 6 comments

Comments

@yupferris
Copy link
Owner

This is significant effort for arguably not much payoff at this point, but I'd still like to track it and have this ticket as a place where I can dump ideas etc.

@turbinenreiter
Copy link

I'd buy you at least a cup of coffee for a tutorial!

@jdonszelmann
Copy link
Contributor

Working on this. Using MDBook + github pages (through Github CI). Going to frame it as a book in which the goal is to build a simple CPU using Kaze. While achieving that goal, many examples are included as reference, concepts are explained and in general a good introduction to the library is given. How does that sound?

@yupferris
Copy link
Owner Author

That sounds good, but I'd appreciate it if you waited until #23 is addressed. I've been putzing on it for a couple months on this branch along with a matching branch in my xenowing project. Granted, I'm not 100% sure I'm convinced of the design changes, but I think they're generally in the right direction.

In fact, you seem quite eager to help with the project, which is appreciated - what I would like most, if you have the time/will, is critical feedback on #23, esp. with motivating examples, if that's possible :)

@yupferris
Copy link
Owner Author

Also, bear in mind that my response capacity is somewhat limited these days; I've recently had a child and changed jobs, and the dust is still settling.

@jdonszelmann
Copy link
Contributor

Hey, that's alright. I found the project and thing it's quite cool. I can handle slow responses. I'll look at #23 :)

@yupferris
Copy link
Owner Author

cheers, let me know if something is strange/unclear!

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants