[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation

From: Jose E. Marchesi
Subject: Re: Documentation
Date: Tue, 15 Sep 2020 08:10:23 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)

Hi Mohammad-Reza.

Sorry for the delay replying this: I had a week off :)

> Suggestion 1:
>   Please add HTML version of reference documentation (Texinfo) in the
>   web site.

The manual is way far from being finished.  I think publishing it could
confuse people at this point.

> Suggestion 2:
>   We need more tutorials for newcomers (in text format). Currently Jose have
>   two great talks (at "All Systems Go! 2019" and "Kernel Recipes 2019") and
>   these are the only tutorials for the editor and the language.
>   They are absolutely awesome but they're not enough!

Nope :)  They are also quickly getting obsolete.

>   So I wrote a tutorial for Poke; you can find it [here][1]. It's inspired by
>   tutorials at [LearnXinYminutes.com](https://learnxinyminutes.com/).
>   The source is located [here][2]
>   I'd be happy if you put (improved version of) this tutorial on the web site.
>   What do you think about this? Comments? Feedbacks?

Very nice stuff!

Went thru it and have a few comments, but it would help if you could
send learn-poke-in-y-minutes.pk as either inline or as an attachment so
we can discuss it here.  (The gitlab.com link you provided won't work
with a Javascript-disabled browser, and wget'ting it gives a useless
.html document.)


> Thanks,
> Mohammad-Reza
> [1]: https://mnabipoor.gitlab.io/poke-journey/learn-poke-in-y-minutes.pk.html
> [2]: 
> https://gitlab.com/mnabipoor/poke-journey/-/blob/master/doc/learn-poke-in-y-minutes.pk

reply via email to

[Prev in Thread] Current Thread [Next in Thread]