From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Julian Graham Newsgroups: gmane.lisp.guile.devel Subject: ideas for the web site Date: Fri, 11 Feb 2011 00:44:04 -0500 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: dough.gmane.org 1297403064 24441 80.91.229.12 (11 Feb 2011 05:44:24 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 11 Feb 2011 05:44:24 +0000 (UTC) To: guile-devel Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Fri Feb 11 06:44:16 2011 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Pnlnk-0001Nt-HG for guile-devel@m.gmane.org; Fri, 11 Feb 2011 06:44:16 +0100 Original-Received: from localhost ([127.0.0.1]:40794 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Pnlni-0002ip-Uh for guile-devel@m.gmane.org; Fri, 11 Feb 2011 00:44:15 -0500 Original-Received: from [140.186.70.92] (port=33323 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Pnlnd-0002gL-MA for guile-devel@gnu.org; Fri, 11 Feb 2011 00:44:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Pnlnb-0007oe-QA for guile-devel@gnu.org; Fri, 11 Feb 2011 00:44:09 -0500 Original-Received: from mail-iw0-f169.google.com ([209.85.214.169]:59996) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Pnlnb-0007oF-Ir for guile-devel@gnu.org; Fri, 11 Feb 2011 00:44:07 -0500 Original-Received: by iwc10 with SMTP id 10so2264839iwc.0 for ; Thu, 10 Feb 2011 21:44:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:date:message-id:subject:from:to :content-type; bh=BYOphU4kQR6jeIyPoaUvBDcfpyVCK8DkG+6OfX8d4V4=; b=ckt3OS9AX8I30UC5WX4ZMMBJAjGbUx6DLAuQ3OxOinPj6UGze79NUOlIGrwvv+ZsYQ T5RLOJ8ply7g0ei6uPiX8fDBiyTfWyWcuJdL+S+FNa7KtJ2ZmVe0v/x436sBMVSUNaSb YYGm6XXCSyYJ44C8SQs/YcRPFP/p/Lz6C7W78= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:date:message-id:subject:from:to:content-type; b=jZbWrU3gotjdq9QTF5nsWJMeZUs1ZU3lFLQtOqJFJY4X8hRJY6evyVav+BUARNQBWB DIcw0qMEMRcGxluAJiQsQm+8sw9VGWBltzunIpcdess9yxjhV7wSS0FZPmrrTnWj/0x/ 4VixMsXmiYIbETqxy9PZlJG7s3IRhCXBmfMSA= Original-Received: by 10.42.240.133 with SMTP id la5mr108073icb.327.1297403044524; Thu, 10 Feb 2011 21:44:04 -0800 (PST) Original-Received: by 10.42.136.194 with HTTP; Thu, 10 Feb 2011 21:44:04 -0800 (PST) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 209.85.214.169 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:11551 Archived-At: Hey all, As part of preparing for the upcoming release, I thought it would be a good idea to review the contents of the Guile web site at gnu.org. Here are some initial thoughts I had, in no particular order: The "What is Guile?" page should be what http://www.gnu.org/software/guile/ gives you, not the "Recent news" page. The first section should spell out what Guile stands for and play up the fact that it's the "official" extension language for the GNU project. This section shouldn't list all those non-Guile-using projects that are extensible via a scripting language. While these projects might serve as examples of the benefits of extension languages, their presence on the page is confusing, since it leads the reader to assume that those projects use Guile -- and then it's a bit disappointing when you realize that they don't (yet). Instead, why don't we list some prominent Guile-using GNU projects like TeXmacs, GnuCash, and LilyPond? And let's ditch the links to Perl and PHP. They needlessly direct attention away from Guile. In the "Guile is a programming language" section, we should go into a bit more detail about what "Guile Scheme" actually is -- R5RS- and R6RS-compatible, with some implementation-specific features those standards don't require, like easy integration with C code, GOOPS, and a large set of useful modules. Let's emphasize that Guile is a modern Scheme implementation and tracks current standards, because that is actually the case now; we can do this by using terminology that users in the Scheme community will recognize (R6RS, SRFIs, hygienic macros, etc.). This would also be a good place to mention the web client / server modules Andy's been working on. The ability to interact with systems over the web is, for better or for worse, a requirement for a language's standard library these days, so we should point out that Guile can do it. We should add a new section after that one with a heading like "Guile is a platform for extension languages," which briefly describes the VM and compiler, as well as Guile's support for other programming languages -- particularly ECMAScript, which will turn heads, and Emacs Lisp. This might be a good place to play up the work that's being done on supporting additional languages, like Lua, if that's far enough long yet. Let's edit down the section called "The true cost of doing it yourself" or discard it completely. As above, I don't think it's necessary to mention or link to other languages on the front page. The argument for extension languages is probably familiar to application developers these days; the points about complexity are a bit murkier now that Guile has a greatly expanded its feature set. Would it make sense to move the "Getting Guile" section to its own page linked from the sidebar? That way there'd be a space for information that's too important to only be in the manual but not important enough to be on the front page, like supported platforms, distributions known to package Guile, and direct links to the latest releases in each of the 1.6.x, 1.8.x, and 2.0.x series. Let's add a pointer on the sidebar (under the link to the mailing lists) to the Freenode IRC channel, since that's pretty active these days. Thoughts? Regards, Julian