Update about-page.

This commit is contained in:
barnold 2022-10-11 12:45:14 +01:00
parent 4100f08543
commit 4a8a4c1d0d
1 changed files with 36 additions and 14 deletions

View File

@ -4,20 +4,42 @@
<div class="verbiage">
This is a small app for looking through
<a href="https://www.gutenberg.org/">Project Gutenberg</a>'s
book catalog, as provided via
<a href="https://tildegit.org/barnold/dbix-tutorial">this little project</a>.
<p>
This is a site for looking through the book catalog generously provided by
<a href="https://www.gutenberg.org/">Project Gutenberg</a>. We're
not affiliated with Project Gutenberg, we just gratefully use their
work. This site currently offers 51,922 book records out of 68,670
in the catalog.
</p>
<p>
In its present form it's a little bit of an oversimplification. As
presented here, each book has exactly one "author", or more
specifically one row in an "author" table. In practise, an "author" is
really a list of zero or more <em>contributors</em> - authors,
editors, illustrators etc. So really the relationship between "book"
and "author" is many-to-many between "book" and "contributor". For
simplicity, this app ignores the distinction and pretends that a book
has exactly one author.
In its present form the site is a little bit of an
oversimplification. As presented here, each book has exactly one
"author", or more specifically one row in an "author" table. In
practise, an "author" is really a list of zero or
more <em>contributors</em> - authors, editors, illustrators etc. So
really the relationship between "book" and "author" is many-to-many
between "book" and "contributor". For simplicity, this site ignores
the distinction and pretends that a book has exactly one author. Books
with "excessive" numbers of contributors (more than 64 bytes' worth)
are excluded from this site. A future version might aim to represent
the book-contributor relationship more faithfully.
</p>
<p>
We keep the usual kind of web site logs that include your ip
address, user agent and the page you requested. We use a session
cookie so that you can change the number of records per page. We
don't use javascript, analytics, tracking, CDNs, or make any use of
third-parties.
</p>
<p>
You might notice duplicate book titles, even for a given author. For
example, John Milton has "Paradise Lost" twice. Each instance of the
title has its own identifier in the PG catalog, corresponding to
distinct editions or versions. Each book title links to its page on
PG's site.
</p>
<h2 id="search-help">Searching</h2>
@ -31,8 +53,8 @@ History and Annals", among others.
<p>
There is a variety of not-really authors in the catalog. Some books
have no author entry. For simplicity, these are represented in this
app as having the author named "[no author]" to make them easily
have no author entry at all. For simplicity, these are represented
here as having the author named "[no author]" to make them easily
searchable.
</p>