Hey Catonano,
Sorry it took a bit longer for me to get around to it.
I liked the style of your text. I've taken the liberty to expand on it
some more — but I'm happy to go with your version if you / the
maintainers prefer.
Also, I changed references from guile-hall to Hall. Whilst the name of
the folder etc is guile-hall, the project itself is called Hall, or
Guile Hall to make it part of the Guile family :-)
I would love for this section to be added to the Guile manual.
Wdyt?
>From 3f8c9fca63e3ddeb6f051d9d16e0c21b8cce8a30 Mon Sep 17 00:00:00 2001
From: Alex Sassmannshausen <a...@komputilo.eu>
Date: Sun, 24 May 2020 23:18:32 +0200
Subject: [PATCH] Added a reference to Guile Hall in the manual.
* doc/ref/scheme-using.texi: Add a section on Hall.
---
doc/ref/scheme-using.texi | 24 ++++++++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/doc/ref/scheme-using.texi b/doc/ref/scheme-using.texi
index ac265fcca..55ce778d2 100644
--- a/doc/ref/scheme-using.texi
+++ b/doc/ref/scheme-using.texi
@@ -744,6 +744,30 @@ using a CPAN-like system.
A complete list of guild scripts can be had by invoking @code{guild
list}, or simply @code{guild}.
+@menu
+* Hall::
+@end menu
+
+
+@node Hall
+@subsection Bootstrapping projects and distributing them
+
+There's a tool that doesn't come bundled with Guile and yet can be very
+useful in your day to day experience with it. This tool is
+@uref{https://gitlab.com/a-sassmannshausen/guile-hall, Hall}.
+
+Hall helps you create, manage and package your Guile projects through a
+simple commandline interface. When you start a new project, Hall
+creates a folder containing a scaffold of your new project. It contains
+a directory for your tests, for your libraries, for your scripts and for
+your documentation. This means you immediately know where to put the
+files you are hacking on.
+
+In addition, the scaffold will include your basic Autotools setup, so
+you don't have to take care of that yourself. Having Autotools set up
+with your project means you can immediately start hacking on your
+project without worrying about whether your code will work on other
+people's computers.
@node Installing Site Packages
@section Installing Site Packages
--
2.23.0
Alex
Catonano <caton...@gmail.com> writes:
> Il giorno gio 21 mag 2020 alle ore 12:03 Alex Sassmannshausen
> <alex.sassmannshau...@gmail.com> ha scritto:
>
> Heya,
>
> On Thu, 2020-05-21 at 12:00 +0200, Catonano wrote:
> >
> >
> > Il giorno mer 20 mag 2020 alle ore 17:58 Catonano <caton...@gmail.com
> > > ha scritto:
> > >
> > > Ok this is the last revision for today
> > > Now I'm gonna do something else, really ! 😀
> > >
> >
> >
> > So, today is another day and I have a new update
> >
> > I'm watching this talk
> > https://peertube.social/videos/watch/8f27a614-aa63-4811-af6a-b9e11effc399
> >
> > and it made up my mind that in this patch I'm intermingling reference
> > type content and tutorial type content
> >
> > Guile desperately lacks some good tutorial and how to materials
> >
> > Because, as the person on the video says, programmers tend to assume
> > that what people want is information
> >
> > But the solution is not to spray the reference manual with bit of
> > tutorials here and there
> >
> > Because, according to the person talking, that decreases the quality
> > of both reference and tutorials
> >
> > Today I'm a bit busy but I'll submit a proper patch maybe tomorrow
>
> I think these are very good points. I think that's where the
> difference between the Guix Manual and the Cookbook come from.
>
> The Guile manual is definitely a reference manual! :-)
>
> I'll await your update tomorrow.
>
> Alex
>
> here we go
