From: dsmich@roadrunner.com
To: "'Vijay Marupudi'" <vijay@vijaymarupudi.com>
Cc: 'guile-devel' <guile-devel@gnu.org>
Subject: Re: a cookbook
Date: Mon, 14 Feb 2022 22:00:04 +0000 [thread overview]
Message-ID: <b118412ae084648ec3cf6934365da3fbfb805a73@webmail> (raw)
[-- Attachment #1: Type: text/plain, Size: 884 bytes --]
> From: "Vijay Marupudi"
> To: "Catonano", "guile-devel"
> Subject: Re: a cookbook
> > Is there any interest/possibility to have such a cookbook hosted
> > within the Guile official documentation (as it is for Guix) ?
> I personally think that a Cookbook should be an independent effort,
> with
> links from the Guile Manual if possible. This would lighten the load
> on
> the maintainers, and allow for quicker collaboration.
I found this interesting: https://diataxis.fr/
Classifies documentation into 4 types
Tutorials: Learning oriented
How-To Guides: Task oriented
Explanation: Understanding oriented
Reference: Information oriented
The Guile Manual is a Reference. Mainly a Reference. There are some
tutorial-like things in it, and some explanations, but not much.
It really would be good to have more non-reference documentation.
-Dale
[-- Attachment #2: Type: text/html, Size: 1078 bytes --]
next reply other threads:[~2022-02-14 22:00 UTC|newest]
Thread overview: 18+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-02-14 22:00 dsmich [this message]
2022-02-14 23:06 ` a cookbook Vijay Marupudi
-- strict thread matches above, loose matches on Subject: below --
2022-02-18 14:32 dsmich
2022-02-20 0:48 ` Vijay Marupudi
2022-02-14 6:44 Catonano
2022-02-14 15:47 ` Max Brieiev
2022-02-14 16:56 ` Olivier Dion via Developers list for Guile, the GNU extensibility library
2022-02-16 7:12 ` Catonano
2022-02-14 17:01 ` Vijay Marupudi
2022-02-16 7:21 ` Catonano
2022-02-16 9:54 ` Neil Jerram
2022-02-16 21:13 ` Catonano
2022-02-19 13:18 ` Neil Jerram
2022-02-20 11:07 ` Catonano
2022-02-16 14:19 ` Olivier Dion via Developers list for Guile, the GNU extensibility library
2022-02-17 2:11 ` Vijay Marupudi
2022-02-17 7:00 ` Catonano
2022-02-17 17:34 ` Vijay Marupudi
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/guile/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=b118412ae084648ec3cf6934365da3fbfb805a73@webmail \
--to=dsmich@roadrunner.com \
--cc=guile-devel@gnu.org \
--cc=vijay@vijaymarupudi.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).