This is the mail archive of the guile@sources.redhat.com mailing list for the Guile project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

FAQ + new idea


I've looked at the beginning of the FAQ and think it looks promising.

Your approach of supplying links into the message archive has pros and
cons.  It is an important advantage that it is easy to add new
questions since you don't have to edit much text.  Since many people
in the project are busy people, it is extremely important that doing
Guile thinks is easy.

However, there is also a disadvantage in that it becomes more
difficult for the reader to browse quickly through the FAQ and to use
"Find" in his browser to look for individual words.

Some time in the future it might therefore be a good idea to try to
include the actual texts in the FAQ document.  (It would probably be
a good idea to retain the links.)


Anyway, I think the current approach to the FAQ is a very interesting
way of summarizing information occuring on the list.

One of our current problems is that there is a lot of interesting
contributions on the Guile list (such as Ian's recent infix arithmetic
parser module) but still no system for sharing Guile source.

Although this is something we're working on, one idea could be
meanwhile to maintain a document, structured the same way as your FAQ,
with pointers to messages on the list contributing interesting Guile
things.  This is similar in mind to the projects list, but not the
same, since this new list would simply be a kind of summary of
worthwhile contributions for later reference.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]