Where has the manual on one html page gone?

Where has the manual on one html page gone?

[Christine Köhn]

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

Re: Where has the manual on one html page gone?

[Diego Zamboni]

[-- 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 --]

Re: Where has the manual on one html page gone?

[Christine Köhn]

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

Re: Where has the manual on one html page gone?

[Nick Dokos]

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

Re: Where has the manual on one html page gone?

[Diego Zamboni]

[-- 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 --]

Re: Where has the manual on one html page gone?

[Marcin Borkowski]

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

Re: Where has the manual on one html page gone?

[Devin Prater]

[-- 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 --]

Re: Where has the manual on one html page gone?

[Christine Köhn]

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.

Re: Where has the manual on one html page gone?

[Russell Adams]

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