Hi Max and Guillaume: Could I have comments from the two of you on these changes?
If Mark Stosberg is paying attention, this may be a good one for you to comment on too (did I already ask you if you wanted to join the Marketing Team? after 3, I'll likely assume the team can take care of its own recruitment) On Sat, May 16, 2009 at 00:31:52 -0700, Trent W. Buck wrote: > A do-over of the one-big-patch I made some time ago. I've tried to > put the most contentious changes last, so that they won't kibosh the > others due to dependency issues. > > I also refrained from rewriting the introductory text at all, since > that was the area that seemed to be bike-shedded most. > > Oh, and I checked it against a graphical browser this time (webkit), > and tried harder to preserve the visual layout there. Good thinking. > Sat May 16 15:13:06 EST 2009 Trent W. Buck <[email protected]> > * Make index.html XHTML 1.0 Strict (was HTML 4). > This is the bare minimum necessary to make it pass. Applied! > Sat May 16 15:13:26 EST 2009 Trent W. Buck <[email protected]> > * Capitalize Darcs' name. Applied! Somebody should update the Wikipedia entry. I'm a bit attached to the old way, but my job here is to just go with the flow here. > Sat May 16 15:22:56 EST 2009 Trent W. Buck <[email protected]> > * Don't abuse <table> as presentational markup (use CSS instead). > This should improve the rendering on tty, print and handheld media, > without (hopefully) changing much on conventional screens. I think this is good in principle, but I'm leaving this to Mark + marketing. > Sat May 16 17:13:14 EST 2009 Trent W. Buck <[email protected]> > * Point out up-front how dated LWN's recommendation is. > Someone should find a Darcs 2 era quote to replace this one. I'll apply this one straight away > Sat May 16 17:20:07 EST 2009 Trent W. Buck <[email protected]> > * Rewrite "see also" sections of home page. > Particularly, separate links "for users" from those "for developers". > > Sat May 16 17:30:22 EST 2009 Trent W. Buck <[email protected]> > * Demote one-paragraph sections into a definition list. > Increases vertical density of the introductory text, which hopefully > increases the visibility of the links at the bottom of the page. No further comments on my part. I'm including the patches to be reviewed for Max and Guillaume's convenience. Make index.html XHTML 1.0 Strict (was HTML 4). ---------------------------------------------- > Trent W. Buck <[email protected]>**20090516051306 > Ignore-this: 2e4ae262c435b9a634328c6ba1c866a3 > This is the bare minimum necessary to make it pass. > ] hunk ./doc/index.html.in 1 > - -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > "http://www.w3.org/TR/html4/loose.dtd";> > - -<html lang="en"> > +<?xml version="1.0" encoding="utf-8"?> > +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" > + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";> > +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> > <head> > <title>darcs</title> > hunk ./doc/index.html.in 7 > - - <meta http-equiv="Content-Type" content="text/html; > charset=ISO-8859-1"> > - - <meta name="description" content="darcs is an advanced revision > control system."> > - - <meta name="keywords" content="darcs scm subversion alternative CVS > free software gpl linux debian"> > - - <link rel="stylesheet" type="text/css" href="darcs.css"> > + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> > + <meta name="description" content="darcs is an advanced revision control > system." /> > + <meta name="keywords" content="darcs scm subversion alternative CVS free > software gpl linux debian" /> > + <link rel="stylesheet" type="text/css" href="darcs.css" /> > </head> > > <body> > hunk ./doc/index.html.in 14 > - - > - - <div align="center"> > - - <img src="http://www.darcs.net/logos/logo.png"; border="0" > width="242" height="79" alt=""><br> > + <div style="text-align: center"> > + <img src="http://www.darcs.net/logos/logo.png"; width="242" height="79" > alt="" /><br /> > <strong>Distributed. Interactive. Smart.</strong> > </div> > > hunk ./doc/index.html.in 19 > - - <table align="center"> > + <table style="margin-left: auto; margin-right: auto"> > <tr> > hunk ./doc/index.html.in 21 > - - <td width="150" valign="top"> > + <td style="vertical-align: top; width: 150px"> > <p> </p> > <p> </p> > <p> </p> > hunk ./doc/index.html.in 26 > <div style="font-size:smaller; background-color:#CCCCFF; padding: > 4px; "> > - - <i>"Project leaders should certainly consider its adoption." > <br> > + <i>"Project leaders should certainly consider its adoption." <br > /> > —<a href="http://lwn.net/Articles/109719/";>Linux Weekly > News</a></i> > </div> > > hunk ./doc/index.html.in 32 > > </td> > - - <td width="15"></td> > - - <td width="500"> > + <td style="width: 15px" /> > + <td style="width: 500px"> > > <p><a name="intro">Darcs is a free, open source source code > management system.</a> </p> > > hunk ./doc/index.html.in 60 > in ways that would otherwise not be possible. For example, learn > about <a > href="http://wiki.darcs.net/DarcsWiki/SpontaneousBranches";>spontaneous > branches</a> with darcs.</p> > > - - <hr> > + <hr /> > > <h3>Darcs team</h3> > <p>First released in 2003, Darcs is now managed by a sizable > hunk ./doc/index.html.in 91 > <h3>Documentation</h3> > > <ul> > - - <li><a href="manual">darcs manual</a> <br></li> > - - <li><a href="api-doc/">darcs API docs</a> <br></li> > + <li><a href="manual">darcs manual</a> <br /></li> > + <li><a href="api-doc/">darcs API docs</a> <br /></li> > </ul> > > <h3>Community</h3> > hunk ./doc/index.html.in 111 > <p>Note, to get the Darcs source you must already have Darcs > version 2 or greater (Darcs 1 will give an obscure error). If necessary, > download a binary or build the source tarball to get a working Darcs 2.</p> > > </td> > - - <td width="150"></td> > + <td style="width: 150px" /> > </tr></table> > > </body> Don't abuse <table> as presentational markup (use CSS instead). --------------------------------------------------------------- > Trent W. Buck <[email protected]>**20090516052256 > Ignore-this: b5c769defbd52cd47dd21d4d25e1e4f4 > This should improve the rendering on tty, print and handheld media, > without (hopefully) changing much on conventional screens. > ] hunk ./doc/index.html.in 13 > <link rel="stylesheet" type="text/css" href="darcs.css" /> > </head> > > - - <body> > + <body style="max-width: 87ex; margin-left: auto; margin-right: auto"> > <div style="text-align: center"> > <img src="http://www.darcs.net/logos/logo.png"; width="242" height="79" > alt="Darcs" /><br /> > <strong>Distributed. Interactive. Smart.</strong> > hunk ./doc/index.html.in 19 > </div> > > - - <table style="margin-left: auto; margin-right: auto"> > - - <tr> > - - <td style="vertical-align: top; width: 150px"> > - - <p> </p> > - - <p> </p> > - - <p> </p> > - - <div style="font-size:smaller; background-color:#CCCCFF; > padding: 4px; "> > - - <i>"Project leaders should certainly consider its adoption." > <br /> > - - —<a href="http://lwn.net/Articles/109719/";>Linux Weekly > News</a></i> > - - </div> > - - > - - > - - </td> > - - <td style="width: 15px" /> > - - <td style="width: 500px"> > + <blockquote style="float:right; max-width: 33%; padding: 1ex; > background-color:#CCF; border: 1px solid #BBF"> > + <p>"Project leaders should certainly consider its adoption."<br /> > + —<a href="http://lwn.net/Articles/109719/";>Linux Weekly > News</a></p> > + </blockquote> > > <p><a name="intro">Darcs is a free, open source source code > management system.</a> </p> > > hunk ./doc/index.html.in 99 > </ul> > <p>Note, to get the Darcs source you must already have Darcs > version 2 or greater (Darcs 1 will give an obscure error). If necessary, > download a binary or build the source tarball to get a working Darcs 2.</p> > > - - </td> > - - <td style="width: 150px" /> > - - </tr></table> > - - > </body> > </html> Rewrite "see also" sections of home page. ----------------------------------------- > Trent W. Buck <[email protected]>**20090516072007 > Ignore-this: 9e9cebdab8b4df34b41437aab4739d3f > Particularly, separate links "for users" from those "for developers". > ] hunk ./doc/index.html.in 66 > member projects. > </p> > > - - <h3>Download</h3> > - - > - - <p> > - - <a href="http://wiki.darcs.net/DarcsWiki/Binaries";>Binaries and > source of the latest stable release</a> of darcs for various platforms > including Windows, Mac OS X, FreeBSD and its siblings, Solaris, and AIX, a > dozen flavors of Linux, and Cygwin.</p> > - - > - - <p>While using a binary from above is recommend, here is the > latest source code for those who want it.</p> > - - <ul> > - - <li><a href="dar...@[email protected]">Latest Prerelease > Source</a> (@VERSION@). <br/></li> > - - <li><a href="dar...@[email protected]">Latest Stable Source</a> > (@RELEASE@). <br/></li> > - - </ul> > - - > - - <h3>Documentation</h3> > - - > - - <ul> > - - <li><a href="manual">darcs manual</a> <br /></li> > - - <li><a href="api-doc/">darcs API docs</a> <br /></li> > - - </ul> > - - > - - <h3>Community</h3> > - - > - - <ul> > - - <li><strong><a href="http://wiki.darcs.net/DarcsWiki";>The > Darcs Wiki</a></strong> -- The best source for further information.</li> > - - <li><a > href="http://lists.osuosl.org/mailman/listinfo/darcs-users";>mailing list</a> > </li> > - - <li><a href="http://bugs.darcs.net/?user=guest;pass=guest";>Bug > Tracking System</a> </li> > - - <li><a href="http://allmydata.org/trac/darcs-2/browser";>Darcs > repository browser</a></li> > - - </ul> > - - > - - <h3>Darcs source repository</h3> > - - <ul> > - - <li>darcs get --lazy http://darcs.net</li> > - - </ul> > - - <p>Note, to get the Darcs source you must already have Darcs > version 2 or greater (Darcs 1 will give an obscure error). If necessary, > download a binary or build the source tarball to get a working Darcs 2.</p> > + <h3>User Resources</h3> > + <ul> > + <li>Pre-built <a > + href="http://wiki.darcs.net/DarcsWiki/Binaries";>Darcs > + binaries</a> are available for Windows and many Unix-like > + platforms.</li> > + <li>The Darcs <a href="manual">user manual</a> and <a > + href="http://wiki.darcs.net/DarcsWiki";>wiki</a>.</li> > + <li>The <a > + href="http://lists.osuosl.org/mailman/listinfo/darcs-users";>darcs-users > + mailing list</a>, now also used for developer discussion.</li> > + </ul> > > hunk ./doc/index.html.in 79 > + <h3>Developer Resources</h3> > + <ul> > + <li><a href="dar...@[email protected]">Latest Prerelease > + Source</a> (@VERSION@).</li> > + <li><a href="dar...@[email protected]">Latest Stable Source</a> > + (@RELEASE@).</li> > + <li>The <a href="api-doc/">API documentation</a> (haddock).</li> > + <li>The <a > + href="http://lists.osuosl.org/mailman/listinfo/darcs-devel";>darcs-devel > + mailing list</a>, now only used for automatic commit > + messages.</li> > + <li>The <a > + href="http://bugs.darcs.net/?user=guest;pass=guest";>bug > + tracker</a> (roundup).</li> > + <li><a href="http://allmydata.org/trac/darcs-2/browser";>Darcs > + repository browser</a>.</li> > + </ul> > </body> > </html> Demote one-paragraph sections into a definition list. ----------------------------------------------------- > Trent W. Buck <[email protected]>**20090516073022 > Ignore-this: 979b7271be2893f0dfc55dfc63185659 > Increases vertical density of the introductory text, which hopefully > increases the visibility of the links at the bottom of the page. > ] hunk ./doc/index.html.in 24 > —<a href="http://lwn.net/Articles/109719/";>Linux Weekly > News</a>, 2004</p> > </blockquote> > > - - <p><a name="intro">Darcs is a free, open source source code > management system.</a> </p> > + <p><a name="intro" />Darcs is a free, open source source code management > system.</p> > + <dl> > + <dt>Distributed</dt> > + <dd>Every user has access to the full command set, removing > + boundaries between server and client or committer and > + non-committers.</dd> > > hunk ./doc/index.html.in 31 > - - <h2>Distributed</h2> > + <dt>Interactive</dt> > + <dd>Darcs is easy to learn and efficient to use because it asks > + you questions in response to simple commands, giving you choices > + in your work flow. You can choose to record one change in a > + file, while ignoring another. As you update from upstream, you > + can review each patch name, even the full "diff" for interesting > + patches.</dd> > > hunk ./doc/index.html.in 39 > - - <p>Every user has access to the full command set, removing > - - boundaries between server and client or committer and > non-committers.</p> > - - > - - <h2>Interactive</h2> > - - > - - <p>Darcs is easy to learn and efficient to use because it asks > - - you questions in response to simple commands, giving you choices > - - in your work flow. You can choose to record > - - one change in a file, while ignoring another. As you update > - - from upstream, you can review each patch name, even the full > "diff" > - - for interesting patches. </p> > - - > - - <h2>Smart</h2> > - - > - - <p>Originally developed by physicist David Roundy, darcs is > - - based on a unique algebra of patches. </p> > - - > - - <p>This smartness lets you respond to changing demands > - - in ways that would otherwise not be possible. For example, learn > - - about <a > href="http://wiki.darcs.net/DarcsWiki/SpontaneousBranches";>spontaneous > branches</a> with darcs.</p> > + <dt>Smart</dt> > + <dd>Originally developed by physicist David Roundy, darcs is > + based on a unique algebra of patches. This smartness lets you > + respond to changing demands in ways that would otherwise not be > + possible. For example, learn about <a > + href="http://wiki.darcs.net/DarcsWiki/SpontaneousBranches";>spontaneous > + branches</a> with darcs.</dd> > + </dl> > > hunk ./doc/index.html.in 48 > - - <hr /> > + <p>First released in 2003, Darcs is now managed by a sizable team > + of programmers. Daily improvements, combined with tight quality > + control, culminate in frequent releases.</p> > > hunk ./doc/index.html.in 52 > - - <h3>Darcs team</h3> > - - <p>First released in 2003, Darcs is now managed by a sizable > - - team of programmers. Daily improvements, > - - combined with tight quality control, culminate in frequent > - - releases. > - - </p> > - - > - - <p> > - - Darcs is a member of the <a > - - href="http://conservancy.softwarefreedom.org/";>Software > - - Freedom Conservancy</a>, a non-profit organisation which > - - provides valuable financial and administrative services to its > - - member projects. > - - </p> > + <p>Darcs is a member of the <a > + href="http://conservancy.softwarefreedom.org/";>Software Freedom > + Conservancy</a>, a non-profit organisation which provides valuable > + financial and administrative services to its member projects.</p> > > <h3>User Resources</h3> > <ul> -- Eric Kow <http://www.nltg.brighton.ac.uk/home/Eric.Kow> PGP Key ID: 08AC04F9
pgpr3DnJdGaIg.pgp
Description: PGP signature
_______________________________________________ darcs-users mailing list [email protected] http://lists.osuosl.org/mailman/listinfo/darcs-users
![http://www.darcs.net/logos/logo.png"](http://www.darcs.net/logos/logo.png"){kind=link}