From mboxrd@z Thu Jan 1 00:00:00 1970 From: Reuben Thomas Subject: Re: Bug: Please supply stable releases on ELPA or MELPA Stable [8.3.4 (8.3.4-dist @ /usr/local/share/emacs/25.1.50/site-lisp/org-mode/)] Date: Tue, 1 Nov 2016 10:59:02 +0000 Message-ID: References: <87mvhltqpw.fsf@sc3d.org> <87oa21tmp0.fsf@gmail.com> <87ins8ftyv.fsf@nicolasgoaziou.fr> <87lgx3v6bw.fsf@bzg.fr> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a11401b226962bb05403b3641 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38235) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c1WmZ-0007eJ-GN for emacs-orgmode@gnu.org; Tue, 01 Nov 2016 06:59:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c1WmY-0000yi-7l for emacs-orgmode@gnu.org; Tue, 01 Nov 2016 06:59:07 -0400 Received: from mail-lf0-x235.google.com ([2a00:1450:4010:c07::235]:33801) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c1WmX-0000xq-Qq for emacs-orgmode@gnu.org; Tue, 01 Nov 2016 06:59:06 -0400 Received: by mail-lf0-x235.google.com with SMTP id b81so123129028lfe.1 for ; Tue, 01 Nov 2016 03:59:05 -0700 (PDT) In-Reply-To: <87lgx3v6bw.fsf@bzg.fr> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Bastien Guerry Cc: Josiah Schwab , "emacs-orgmode@gnu.org" --001a11401b226962bb05403b3641 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On 1 November 2016 at 10:32, Bastien Guerry wrote: > Hi, > > I changed the order of presentation for installation methods on the > website, promoting Org ELPA method. > =E2=80=8BThat's much better, thanks. However, I still find the first section of the main page rather confusing. I think there are two main problems: 1. The top heading is "Download and install", but the second half of the section is a list of links that look like they belong in a different section (List of features, Manuals and tutorials=E2=80=A6). 2. The various types of download are still too mixed up. For normal users, there is no need to offer anything other than the ELPA method (unless you think some users still use pre-package.el Emacs?) Suggested solution: I suggest that you move these items to the "Documentation and literature" section: Manuals and tutorials, Worg, History & acknowledgements, Talks, GSoC. Remove the heading "Download and install", but instead make the entire list heading-sized text. The top-most item in the list should be something like: "Install Org mode from [GNU ELPA]: M-x package-install RET org RET (for the [bleeding edge], use [Org ELPA]!)" The bits in square brackets are links, respectively, to GNU ELPA, the bleeding edge Worg page, and the Org ELPA page. The rest of the list is then: Mailing list and goodies Org tools (outside Emacs) How to contribute to Org [no question mark!] The development version info should move to "How to contribute to Org?". =E2=80=8BThe link to "More on installing Org mode" can be moved to the deve= loper documentation. I think this would make the page much easier to parse, and hence attract more casual users, as well as saving more experienced users time. --=20 http://rrt.sc3d.org --001a11401b226962bb05403b3641 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
On = 1 November 2016 at 10:32, Bastien Guerry <bzg@gnu.org> wrote:
<= /div>
Hi,

I changed the order of presentation for installation methods on the
website, promoting Org ELPA method.

=E2=80=8BThat&= #39;s much better, thanks.

However, I still find the first section of the main page rather con= fusing.

I think there are= two main problems:

1. Th= e top heading is "Download and install", but the second half of t= he section is a list of links that look like they belong in a different sec= tion (List of features, Manuals and tutorials=E2=80=A6).

2. The various= types of download are still too mixed up. For normal users, there is no ne= ed to offer anything other than the ELPA method (unless you think some user= s still use pre-package.el Emacs?)

Suggested solution:

I suggest that you move these items to the "Documentation a= nd literature" section: Manuals and tutorials, Worg, History & ack= nowledgements,=C2=A0Talks, GSoC.

Remove the heading "Download and install", but instead ma= ke the entire list heading-sized text. The top-most item in the list should= be something like:

=
"Install Org mode from [GNU ELPA]: M-x pa= ckage-install RET org RET (for the [bleeding edge], use [Org ELPA]!)"<= /div>

The bits in square brackets are links, respectively, to GNU = ELPA, the bleeding edge Worg page, and the Org ELPA page.

The rest of the list is then:

Mailing list= and goodies
Org tools (outside Emacs)
How to contribut= e to Org [no question mark!]

The development version info should= move to "How to contribute to Org?".

=E2=80=8BThe link to "More on instal= ling Org mode" can be moved to the developer documentation.

I think this would make the page mu= ch easier to parse, and hence attract more casual users, as well as saving = more experienced users time.

--
http://rrt.sc3d.org
--001a11401b226962bb05403b3641--