unofficial mirror of guile-devel@gnu.org 
 help / color / mirror / Atom feed
* a cookbook
@ 2022-02-14  6:44 Catonano
  2022-02-14 15:47 ` Max Brieiev
  2022-02-14 17:01 ` Vijay Marupudi
  0 siblings, 2 replies; 18+ messages in thread
From: Catonano @ 2022-02-14  6:44 UTC (permalink / raw)
  To: guile-devel

[-- Attachment #1: Type: text/plain, Size: 310 bytes --]

In this discussion
https://lists.gnu.org/archive/html/guile-user/2022-02/msg00113.html

we hinted on the possibility of having a Guile Cookbook, along the lines of
the Guix Cookbook

Is there any interest/possibility to have such a cookbook hosted within the
Guile official documentation (as it is for Guix) ?

[-- Attachment #2: Type: text/html, Size: 513 bytes --]

^ permalink raw reply	[flat|nested] 18+ messages in thread
* Re: a cookbook
@ 2022-02-14 22:00 dsmich
  2022-02-14 23:06 ` Vijay Marupudi
  0 siblings, 1 reply; 18+ messages in thread
From: dsmich @ 2022-02-14 22:00 UTC (permalink / raw)
  To: 'Vijay Marupudi'; +Cc: 'guile-devel'

[-- 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 --]

^ permalink raw reply	[flat|nested] 18+ messages in thread
* Re: a cookbook
@ 2022-02-18 14:32 dsmich
  2022-02-20  0:48 ` Vijay Marupudi
  0 siblings, 1 reply; 18+ messages in thread
From: dsmich @ 2022-02-18 14:32 UTC (permalink / raw)
  To: 'Vijay Marupudi'; +Cc: 'guile-devel'

[-- Attachment #1: Type: text/plain, Size: 689 bytes --]

> From: "Vijay Marupudi" 
> To: "Catonano"
> Subject: Re: a cookbook

>> I'd like to have continuable exceptions covered, though
 >>
 >> Those are the main departure of Guile from more widespread
exception
 >> handling solutions and as far as I can tell something similar is
available
 >> only in Common Lisp so drawing experience/intuition from other
languages is
 >> more difficult/rare
 >
 >Sure. I've added new text covering those as well. If you refresh the
 >page, it should appear:
 >https://vijaymarupudi.com/blog/2022-02-13-error-handling-in-guile.html

This is *really* good. Pull in all the separate pieces and how they
fit together. Great job!

-Dale



[-- Attachment #2: Type: text/html, Size: 887 bytes --]

^ permalink raw reply	[flat|nested] 18+ messages in thread

end of thread, other threads:[~2022-02-20 11:07 UTC | newest]

Thread overview: 18+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-02-14  6:44 a cookbook 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
  -- strict thread matches above, loose matches on Subject: below --
2022-02-14 22:00 dsmich
2022-02-14 23:06 ` Vijay Marupudi
2022-02-18 14:32 dsmich
2022-02-20  0:48 ` Vijay Marupudi

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).