* [ANN] olddoc 1.7.0 - old-fashioned RDoc generator
@ 2019-04-22 2:06 5% Eric Wong
0 siblings, 0 replies; 3+ results
From: Eric Wong @ 2019-04-22 2:06 UTC (permalink / raw)
To: ruby-talk, olddoc-public
olddoc contains old-fashioned document generators for those who do not
wish to impose bloated, new-fangled web cruft on their readers.
olddoc contains dark216, a HTML generator without any images, frames,
or JavaScript. It is designed for users of text-based browsers
and/or low-bandwidth connections; yet respects user preference for
light color schemes in new CSS browsers while favoring darkness for
power savings on OLED and CRT displays. dark216 focuses on text as
it is the lowest common denominator for accessibility and compatibility
with people and hardware.
Changes:
Since most users are on horrible GUI browsers which default
to light backgrounds, implement the "dark216" color scheme
which saves power on OLED and CRT displays. This still
respects "prefers-color-scheme:light" on newer browsers,
so users can burn their eyes out if they wish :P
While we're at it, switch to perlpod for our own documentation
since Perl5 and POD tooling is more common on most *nix systems
than pandoc. Finally, update our documentation to avoid the
term "mailing list" because centralized subscriber lists limit
forkability compared to an "archives first" approach to email.
3 changes since v1.6.0 (2019-01-07):
add dark216 color scheme for power savings
doc: switch to perlpod for documentation
doc: update wording to avoid "mailing list"
* https://80x24.org/olddoc/ - homepage + sample
* https://80x24.org/olddoc-public/ - mail archives
* nntp://news.public-inbox.org/inbox.comp.lang.ruby.olddoc
* olddoc-public@80x24.org - public inbox (no subscription)
* license: GPL-3.0+
* git clone https://80x24.org/olddoc.git
^ permalink raw reply [relevance 5%]
* [PATCH 3/3] doc: update wording to avoid "mailing list"
2019-04-22 1:49 6% [PATCH 0/3] Earth Day changes! Eric Wong
@ 2019-04-22 1:49 7% ` Eric Wong
0 siblings, 0 replies; 3+ results
From: Eric Wong @ 2019-04-22 1:49 UTC (permalink / raw)
To: olddoc-public
The concept of a "mailing list" infers the existence of a
centralized subscriber list, and hurts forkability. Mail
archives are easily forkable, subscriber lists are not.
---
Documentation/olddoc.5.pod | 5 ++---
README | 13 +++++++------
2 files changed, 9 insertions(+), 9 deletions(-)
diff --git a/Documentation/olddoc.5.pod b/Documentation/olddoc.5.pod
index bda770f..6e03e3a 100644
--- a/Documentation/olddoc.5.pod
+++ b/Documentation/olddoc.5.pod
@@ -19,9 +19,8 @@ configuration to deal with.
HTML file that will be merged into RDoc after-the-fact. It is useful
for merging non-RDoc generated HTML into the project.
-`ml_url` is the mailing list archive location.
-`public_email` is the email address of a publically archived mailing list
-at `ml_url`
+`ml_url` is the mail archive location.
+`public_email` is the email address of a mail archived at `ml_url`
As of olddoc 1.2.0, `ml_url` and `nntp_url` may be YAML arrays
with multiple URLs.
diff --git a/README b/README
index b9538e7..e902589 100644
--- a/README
+++ b/README
@@ -64,14 +64,15 @@ with git(7)) and send them via email to <olddoc-public@80x24.org>
== Contact
All feedback (comments, results, feature requests, bug reports, patches,
-pull-requests) via plain-text mail to the mailing list is very much
-appreciated.
+pull-requests) via plain-text email is very much appreciated.
-Please send plain-text mail to the list at <olddoc-public@80x24.org>
+Please send plain-text email to us at <olddoc-public@80x24.org>
+Use reply-to-all as we do not require any sort of subscription.
HTML will not be read. olddoc is for GUI-phobes, by GUI-phobes.
-Mailing list archives available at https://80x24.org/olddoc-public/
-and nntp://news.public-inbox.org/inbox.comp.lang.ruby.olddoc
-No subscription will ever be necessary to post to the mailing list.
+We archive all of our mail publically at:
+
+ https://80x24.org/olddoc-public/
+ nntp://news.public-inbox.org/inbox.comp.lang.ruby.olddoc
== License
--
EW
^ permalink raw reply related [relevance 7%]
* [PATCH 0/3] Earth Day changes!
@ 2019-04-22 1:49 6% Eric Wong
2019-04-22 1:49 7% ` [PATCH 3/3] doc: update wording to avoid "mailing list" Eric Wong
0 siblings, 1 reply; 3+ results
From: Eric Wong @ 2019-04-22 1:49 UTC (permalink / raw)
To: olddoc-public
Since most users are on horrible GUI browsers which default
to light backgrounds, implement the "dark216" color scheme
which saves power on OLED and CRT displays. This still
respects "prefers-color-scheme:light" on newer browsers,
so users can burn their eyes out if they wish :P
While we're at it, switch to perlpod for our own documentation
since Perl5 and POD tooling is more common on most *nix systems
than pandoc. Finally, update our documentation to avoid the
term "mailing list" because centralized subscriber lists hurt
forkability compared to an "archives first" approach to email.
Eric Wong (3):
add dark216 color scheme for power savings
doc: switch to perlpod for documentation
doc: update wording to avoid "mailing list"
Documentation/.gitignore | 1 +
Documentation/GNUmakefile | 77 ++++++++++++++------
Documentation/olddoc.1.pod | 21 ++++++
Documentation/olddoc.1.txt | 21 ------
Documentation/{olddoc.5.txt => olddoc.5.pod} | 19 ++---
Documentation/podtxt2html | 54 ++++++++++++++
GNUmakefile | 2 +-
README | 27 ++++---
Rakefile | 2 +-
lib/dark216.rb | 40 ++++++++++
lib/olddoc.rb | 3 +-
lib/oldweb.rb | 1 +
lib/oldweb/_head.rhtml | 6 +-
13 files changed, 202 insertions(+), 72 deletions(-)
create mode 100644 Documentation/olddoc.1.pod
delete mode 100644 Documentation/olddoc.1.txt
rename Documentation/{olddoc.5.txt => olddoc.5.pod} (77%)
create mode 100755 Documentation/podtxt2html
create mode 100644 lib/dark216.rb
--
EW
^ permalink raw reply [relevance 6%]
Results 1-3 of 3 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2019-04-22 1:49 6% [PATCH 0/3] Earth Day changes! Eric Wong
2019-04-22 1:49 7% ` [PATCH 3/3] doc: update wording to avoid "mailing list" Eric Wong
2019-04-22 2:06 5% [ANN] olddoc 1.7.0 - old-fashioned RDoc generator Eric Wong
Code repositories for project(s) associated with this public inbox
https://80x24.org/olddoc.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).