emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Where has the manual on one html page gone?
@ 2021-02-12 16:13 Christine Köhn
  2021-02-12 16:24 ` Diego Zamboni
  2021-02-15 22:45 ` Nick Dokos
  0 siblings, 2 replies; 9+ messages in thread
From: Christine Köhn @ 2021-02-12 16:13 UTC (permalink / raw)
  To: emacs-orgmode

Hi,

I always used the manual online as one html page but it does not seem to
be available since (?) the website revamp. I prefer the manual as one
page for many reasons. Is it still available online?

Best,
Christine


^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-02-12 16:13 Where has the manual on one html page gone? Christine Köhn
@ 2021-02-12 16:24 ` Diego Zamboni
  2021-02-12 16:43   ` Christine Köhn
  2021-02-15 22:45 ` Nick Dokos
  1 sibling, 1 reply; 9+ messages in thread
From: Diego Zamboni @ 2021-02-12 16:24 UTC (permalink / raw)
  To: Christine Köhn; +Cc: Org-mode

[-- Attachment #1: Type: text/plain, Size: 462 bytes --]

Hi Christine,

I found it here: https://orgmode.org/org.html

But it doesn't seem to be linked from the new website.

--Diego


On Fri, Feb 12, 2021 at 5:13 PM Christine Köhn <christine@chark.eu> wrote:

> Hi,
>
> I always used the manual online as one html page but it does not seem to
> be available since (?) the website revamp. I prefer the manual as one
> page for many reasons. Is it still available online?
>
> Best,
> Christine
>
>

[-- Attachment #2: Type: text/html, Size: 881 bytes --]

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-02-12 16:24 ` Diego Zamboni
@ 2021-02-12 16:43   ` Christine Köhn
  0 siblings, 0 replies; 9+ messages in thread
From: Christine Köhn @ 2021-02-12 16:43 UTC (permalink / raw)
  To: Diego Zamboni; +Cc: Org-mode

Hi Diego, hi all,

Diego Zamboni writes:

> I found it here: https://orgmode.org/org.html

Thanks a lot. I've just bookmarked it.

> But it doesn't seem to be linked from the new website.

Has there been a discussion about what manual to link to from the front
page?

As far as I can remember, I've always prefered the complete manual -
even as a new org-mode user.

Best,
Christine


^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-02-12 16:13 Where has the manual on one html page gone? Christine Köhn
  2021-02-12 16:24 ` Diego Zamboni
@ 2021-02-15 22:45 ` Nick Dokos
  2021-02-16  9:22   ` Diego Zamboni
                     ` (2 more replies)
  1 sibling, 3 replies; 9+ messages in thread
From: Nick Dokos @ 2021-02-15 22:45 UTC (permalink / raw)
  To: emacs-orgmode

Christine Köhn <christine@chark.eu> writes:

> Hi,
>
> I always used the manual online as one html page but it does not seem to
> be available since (?) the website revamp. I prefer the manual as one
> page for many reasons. Is it still available online?
>

I've always used the one-page per section version on the web (although
I tend to use Info much more often), primarily because I thought that
downloading the whole manual to just look at a section or two or five
would be inefficient - in fact, I've wondered why the single-page
versions of various manuals (particularly the larger ones: emacs and
elisp) are made available. So it is idle curiosity on my part, but
what are the the reasons for your preference?

-- 
Nick

"There are only two hard problems in computer science: cache
invalidation, naming things, and off-by-one errors." -Martin Fowler



^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-02-15 22:45 ` Nick Dokos
@ 2021-02-16  9:22   ` Diego Zamboni
  2021-02-16  9:37   ` Marcin Borkowski
  2021-03-21  8:54   ` Christine Köhn
  2 siblings, 0 replies; 9+ messages in thread
From: Diego Zamboni @ 2021-02-16  9:22 UTC (permalink / raw)
  To: Nick Dokos; +Cc: Org-mode

[-- Attachment #1: Type: text/plain, Size: 1212 bytes --]

I'm not the OP, but I find the one-page manual useful when I'm not sure
what I'm looking for or where in the manual it might be, makes it easier to
search through the whole document iteratively.

--Diego

On Mon, Feb 15, 2021 at 11:47 PM Nick Dokos <ndokos@gmail.com> wrote:

> Christine Köhn <christine@chark.eu> writes:
>
> > Hi,
> >
> > I always used the manual online as one html page but it does not seem to
> > be available since (?) the website revamp. I prefer the manual as one
> > page for many reasons. Is it still available online?
> >
>
> I've always used the one-page per section version on the web (although
> I tend to use Info much more often), primarily because I thought that
> downloading the whole manual to just look at a section or two or five
> would be inefficient - in fact, I've wondered why the single-page
> versions of various manuals (particularly the larger ones: emacs and
> elisp) are made available. So it is idle curiosity on my part, but
> what are the the reasons for your preference?
>
> --
> Nick
>
> "There are only two hard problems in computer science: cache
> invalidation, naming things, and off-by-one errors." -Martin Fowler
>
>
>

[-- Attachment #2: Type: text/html, Size: 1666 bytes --]

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-02-15 22:45 ` Nick Dokos
  2021-02-16  9:22   ` Diego Zamboni
@ 2021-02-16  9:37   ` Marcin Borkowski
  2021-02-16 12:49     ` Devin Prater
  2021-03-21  8:54   ` Christine Köhn
  2 siblings, 1 reply; 9+ messages in thread
From: Marcin Borkowski @ 2021-02-16  9:37 UTC (permalink / raw)
  To: Nick Dokos; +Cc: emacs-orgmode


On 2021-02-15, at 23:45, Nick Dokos <ndokos@gmail.com> wrote:

> Christine Köhn <christine@chark.eu> writes:
>
>> Hi,
>>
>> I always used the manual online as one html page but it does not seem to
>> be available since (?) the website revamp. I prefer the manual as one
>> page for many reasons. Is it still available online?
>>
>
> I've always used the one-page per section version on the web (although
> I tend to use Info much more often), primarily because I thought that
> downloading the whole manual to just look at a section or two or five
> would be inefficient - in fact, I've wondered why the single-page
> versions of various manuals (particularly the larger ones: emacs and
> elisp) are made available. So it is idle curiosity on my part, but
> what are the the reasons for your preference?

Converting to an ebook format to read on an ebook reader is one possible
use-case.

Best,

-- 
Marcin Borkowski
http://mbork.pl


^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-02-16  9:37   ` Marcin Borkowski
@ 2021-02-16 12:49     ` Devin Prater
  0 siblings, 0 replies; 9+ messages in thread
From: Devin Prater @ 2021-02-16 12:49 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 1387 bytes --]

I like it when I just want to read through the whole document with my screen reader, not having to page through it. I also like being able to search the whole document. And, converting it to EPUB allows me to read it on my phone when I'm away from the computer, if I want to.


On Tue, Feb 16, 2021 at 10:37:29AM +0100, Marcin borkowski wrote:
>
>On 2021-02-15, at 23:45, Nick Dokos <ndokos@gmail.com> wrote:
>
>> Christine Köhn <christine@chark.eu> writes:
>>
>>> Hi,
>>>
>>> I always used the manual online as one html page but it does not seem to
>>> be available since (?) the website revamp. I prefer the manual as one
>>> page for many reasons. Is it still available online?
>>>
>>
>> I've always used the one-page per section version on the web (although
>> I tend to use Info much more often), primarily because I thought that
>> downloading the whole manual to just look at a section or two or five
>> would be inefficient - in fact, I've wondered why the single-page
>> versions of various manuals (particularly the larger ones: emacs and
>> elisp) are made available. So it is idle curiosity on my part, but
>> what are the the reasons for your preference?
>
>Converting to an ebook format to read on an ebook reader is one possible
>use-case.
>
>Best,
>
>-- 
>Marcin Borkowski
>http://mbork.pl
>

-- 
Devin Prater
r.d.t.prater@gmail.com

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 659 bytes --]

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-02-15 22:45 ` Nick Dokos
  2021-02-16  9:22   ` Diego Zamboni
  2021-02-16  9:37   ` Marcin Borkowski
@ 2021-03-21  8:54   ` Christine Köhn
  2021-03-21 14:48     ` Russell Adams
  2 siblings, 1 reply; 9+ messages in thread
From: Christine Köhn @ 2021-03-21  8:54 UTC (permalink / raw)
  To: Nick Dokos; +Cc: emacs-orgmode

Here's why I prefer the one page manual:

I can search it easily. Sometimes I do not find what I'm looking for
where I would expect it to be. Also, searching is convenient way to find
out if something *is not* in the manual.

I'm used to reading and searching in a browser.

For me, it's easier to read a whole chapter/section if I just have to
scroll down. Especially if I only do cursory reading, e.g if I read
about spreadsheets after not having used them in a while. If I can just
scroll down, it's also easier to read on my smartphone (I'd like not to
do that but in the pandemic some things cannot be chosen).

I agree that it's not efficient to download a whole manual but I guess
that's what caching is for? Anyway, I thought about switching to
accessing the manual offline but I haven't gotten to it yet.


^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: Where has the manual on one html page gone?
  2021-03-21  8:54   ` Christine Köhn
@ 2021-03-21 14:48     ` Russell Adams
  0 siblings, 0 replies; 9+ messages in thread
From: Russell Adams @ 2021-03-21 14:48 UTC (permalink / raw)
  To: emacs-orgmode

On Sun, Mar 21, 2021 at 09:54:48AM +0100, Christine Köhn wrote:
> Here's why I prefer the one page manual:
>
> I can search it easily. Sometimes I do not find what I'm looking for
> where I would expect it to be. Also, searching is convenient way to find
> out if something *is not* in the manual.
>
> I'm used to reading and searching in a browser.

Searching and saving are both effective use cases.

> I agree that it's not efficient to download a whole manual but I guess
> that's what caching is for? Anyway, I thought about switching to
> accessing the manual offline but I haven't gotten to it yet.

I disagree. With transparent gzip compression its a few hundred K,
less than all the Javascript libraries that load when you open most
popular websites.

You are also less likely to reopen it repeatedly or reload it.

Perhaps the main link can goto a sectioned manual, but I'd like to see
a link to the one page manual preserved.


------------------------------------------------------------------
Russell Adams                            RLAdams@AdamsInfoServ.com

PGP Key ID:     0x1160DCB3           http://www.adamsinfoserv.com/

Fingerprint:    1723 D8CA 4280 1EC9 557F  66E8 1154 E018 1160 DCB3


^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2021-03-21 14:49 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-02-12 16:13 Where has the manual on one html page gone? Christine Köhn
2021-02-12 16:24 ` Diego Zamboni
2021-02-12 16:43   ` Christine Köhn
2021-02-15 22:45 ` Nick Dokos
2021-02-16  9:22   ` Diego Zamboni
2021-02-16  9:37   ` Marcin Borkowski
2021-02-16 12:49     ` Devin Prater
2021-03-21  8:54   ` Christine Köhn
2021-03-21 14:48     ` Russell Adams

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).