Christopher Allan Webber <cweb...@dustycloud.org> skribis: > Chad Albers writes:
[...] >> b. More robust documentation system - texinfo is not the greatest. And >> it's non-trivial to generate any documentation (including texinfo) for >> modules. > > Texinfo is pretty nice to use if you're an emacs user... in fact, if > you're an emacs user, it's the best documentation reading system in the > world. But not everyone's an emacs user. I think Texinfo is OK even if you’re not an Emacs user, no? Especially with the just-release 6.1 where menus can (finally!) be automatically generated. > If the html export was nicely themed It can be nicely themed. FWIW, Gnulib’s gendocs.sh, which is what most projects use to export their HTML to gnu.org, now includes a CSS by default (see <https://gnu.org/s/guix/manual> as an example.) We can change this CSS anytime, and in fact, I would love it if someone talented would come up with improvements! >> d. An easier build system. I see most projects using autoconf and >> make. Using build tools designed for the C language presents a higher >> barrier to those that want to contribute libraries to the guile >> community. FWIW, I think what we’re using now is the easiest build system *for users*: ./configure && make && make install. It’s admittedly trickier for developers, but not insurmountable (and someone working on Guile doesn’t touch it every day either.) >> e. Refactors - I have a _long_ list in my head, but here's one: the >> "ice-9" namespace is cute but confusing to the beginner I once was. > > Yes, I encountered frustration here too. It's faded to the background > now, but I think ice-9 is confusing for newcomers, so is srfi-*. As > much as I love robots, these robot names are kind of jarring. We've > talked about some ice-9 stuff being factored into (guile foo) instead of > (ice-9 foo) but I think Mark Weaver said he'd want a lot of careful > cleanup going through that process (could be misremembering). Some talk > of aliases for srfi modules was made as well.. Agreed, aliases and a plan for future modules would be nice. Thanks for the feedback! Ludo’.
