From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Xue Fuqiao Newsgroups: gmane.emacs.devel Subject: Re: Improving the presentation of Emacs user documentation Date: Mon, 8 Feb 2016 10:49:24 +0800 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1454899780 23249 80.91.229.3 (8 Feb 2016 02:49:40 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Feb 2016 02:49:40 +0000 (UTC) To: John Wiegley , Emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Feb 08 03:49:33 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aSbtL-0007PK-Cg for ged-emacs-devel@m.gmane.org; Mon, 08 Feb 2016 03:49:31 +0100 Original-Received: from localhost ([::1]:40513 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSbtK-0001KG-EG for ged-emacs-devel@m.gmane.org; Sun, 07 Feb 2016 21:49:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33357) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSbtG-0001Jr-Uw for emacs-devel@gnu.org; Sun, 07 Feb 2016 21:49:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aSbtF-0006Ke-RC for emacs-devel@gnu.org; Sun, 07 Feb 2016 21:49:26 -0500 Original-Received: from mail-ig0-x22c.google.com ([2607:f8b0:4001:c05::22c]:33724) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSbtF-0006Ka-MG; Sun, 07 Feb 2016 21:49:25 -0500 Original-Received: by mail-ig0-x22c.google.com with SMTP id y8so21731742igp.0; Sun, 07 Feb 2016 18:49:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=+RXR8N6rTIZ2T++BuRkAdi7h4ECRQFnl1FBz86LWaZs=; b=zPLtSCM44r2Vt5hoWyajhIki2r2K+RX9FxOJxZl30z24eF8eEJnfsyO8XwK/tQaA4k cAc9pl1yyCOFnSKJWmdH2bWWYXxkF4v+17NzyLHzsFUIRg+Y4fEMOV6/+ouIAisndm9F Pz/VH/w8wq603pXmEsnOcPZG9g65+vlaT4W32kYqVlDC+DmPVHkSrArU1plrzXwT/kRi Ki0qWoV+6oMUT4mGW/5MAom7/CLEquprOk+N3LTLBQAlJ2YQEWhuIXgO+iDKiyo6sUVF GULCn7kmNYJ1m2FgsSa8tRijZTU4jl83quRbf1oh9tOdB64mvKMTnTVbb13P1O3cy4uT Qo5A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:date :message-id:subject:from:to:content-type; bh=+RXR8N6rTIZ2T++BuRkAdi7h4ECRQFnl1FBz86LWaZs=; b=iXAU6n7po2SY2ZMTSpKc3bh4kSJEtBJUHI4+2zCn3IoQx4lVaH1DCxoj0kMEYB+Vj7 57ekPudl39UinZUcDUhv3ixEwRUlsyVlf3ojyK+xPwvVTlBasBUEgZKFgSgqS+dOF2Yf LVbuAJW5kMESoHSufvCsvs+tVnvSP3MRzR6A9goBSpW2BwLJ5Ip6eMrJR+60oy2r6sJq uDrOkv0a5yEoRykX+oEo5+eXk6wl/AU3h9Jz+//9E7DQZiVydjqqJBYZu+0LOCmv2V3r ZK9rH2EK62J8OBu5A91mgUeEXHQlEys4V/E6srZLSjwyBzOm6f+/GQsHGZ/1mfsL/JMm ER/w== X-Gm-Message-State: AG10YOQeGY8+n58bzjr96t5n9xpunyPbqUaTNetGWxc0oi/Z5O+R0G1i9dkKcNfirlRWKHFrzUhU4OB0jk1/PQ== X-Received: by 10.50.143.41 with SMTP id sb9mr11862035igb.4.1454899764997; Sun, 07 Feb 2016 18:49:24 -0800 (PST) Original-Received: by 10.79.30.131 with HTTP; Sun, 7 Feb 2016 18:49:24 -0800 (PST) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:4001:c05::22c X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:199479 Archived-At: On Mon, Feb 8, 2016 at 7:19 AM, John Wiegley wrote: > A Spacemacs user just showed me: > > http://spacemacs.org/doc/DOCUMENTATION.html > > And compared it to: > > https://www.gnu.org/software/emacs/manual/html_mono/emacs.html As a relatively new Spacemacs user, here are some problems I see in the Spacemacs docs: 1. There is no indices[1][2]. 2. The anchors are unstable, like the '#orgheadline180' part in: http://spacemacs.org/doc/DOCUMENTATION.html#orgheadline180 Although Emacs's URIs are not permanent either[3], Spacemacs's links are even more unstable. 3. I can't use convenient key bindings in Info like 'm', '1 .. 9', 'n', 'p', and '^' to browse Spacemacs's docs. Anyway, the CSS styles of the Spacemacs docs are beautiful. Footnotes: [1] https://www.gnu.org/software/emacs/manual/html_node/emacs/Concept-Index.html#Concept-Index [2] https://www.gnu.org/software/emacs/manual/html_node/elisp/Index.html#Index [3] https://lists.gnu.org/archive/html/emacs-devel/2016-01/msg00079.html