Re: [racket-users] Show & Tell - Xiden Documentation Revamp

2021-07-02 Thread Sage Gerard
Yikes, sorry about that. That's what I get for cross-posting HTML from another 
dark mode app. Looked the same to me. :)

Last try.

I did a pretty sweeping edit pass on Xiden's documentation. I'm really proud of 
it, and I'd like to show it off. 
https://docs.racket-lang.org/xiden-index/index.html?q=xiden%20documentation

This revision of the docs uses a Guide [-> Exercises] -> Reference reading 
flow. It allowed me to delete a lot of extra text, but I don't know if it 
became easier or harder to understand.

Could I get some feedback on just the guide and the transition to the 
exercises? What do you find clear/confusing? Did the examples work on your 
machine? etc.

On 7/2/21 6:02 PM, Sage Gerard wrote:

> Hey folks,
>
> I did a pretty sweeping edit pass on Xiden's documentation. I'm really proud 
> of it, and I'd like to show it off. 
> https://docs.racket-lang.org/xiden-index/index.html?q=xiden%20documentation 
> This revision of the docs uses a Guide [-> Exercises] -> Reference reading 
> flow. It allowed me to delete a lot of extra text, but I don't know if it 
> became easier or harder to understand. Could I get some feedback on just the 
> guide and the transition to the exercises? What do you find clear/confusing? 
> Did the examples work on your machine? etc.

--
~slg

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/674c115f-0752-def3-3274-2cee57a05d39%40sagegerard.com.


[racket-users] Show & Tell - Xiden Documentation Revamp

2021-07-02 Thread Sage Gerard
Hey folks,

I did a pretty sweeping edit pass on Xiden's documentation. I'm really proud of 
it, and I'd like to show it off. 
https://docs.racket-lang.org/xiden-index/index.html?q=xiden%20documentation 
This revision of the docs uses a Guide [-> Exercises] -> Reference reading 
flow. It allowed me to delete a lot of extra text, but I don't know if it 
became easier or harder to understand. Could I get some feedback on just the 
guide and the transition to the exercises? What do you find clear/confusing? 
Did the examples work on your machine? etc.

--
~slg

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/35ebe8f7-b8ca-54bb-4ad8-6ecefe403f9b%40sagegerard.com.