Scheme.org work you've already done Arthur A. Gleckler 23 Nov 2020 05:08 UTC
Re: Scheme.org work you've already done Lassi Kortela 23 Nov 2020 19:24 UTC

Re: Scheme.org work you've already done Lassi Kortela 23 Nov 2020 19:24 UTC

> Hi, Lassi. You've already done a bunch of infrastructure work to prepare
> for the new Scheme.org and subdomains, including a prototype home page.
> Would you like to describe that here now that the list has been
> established, and advertise the Github repos as well?

It's all in public repos here: <https://github.com/schemeorg>.

The two main repos are:

* schemeorg -- This repo contains a full description of all current
Scheme.org projects. The master file that drives everything else is
"projects.scm". Each project is associated with exactly one direct
subdomain of scheme.org: for example, the "doc" project maps to
"doc.scheme.org", the "api" project maps to "api.scheme.org", etc. All
nested subdomains of the form "*.doc.scheme.org" also belong to the
"doc" project, etc. For example, if Fantastic Scheme was hosted under
scheme.org, its website could be at fantastic.scheme.org, and version
control under git.fantastic.scheme.org.

Each project is responsible for bringing its own servers (usually that
means a Linux VPS running suitably configured web server software). A
VPS doesn't need to be dedicated to one project; nginx and other web
servers allow easy setup of virtual hosts so one VPS can drive any
number of low-traffic domains and subdomains.

When a project has a server set up, then A/AAAA or CNAME records for
that server are added to "projects.scm" and "dns.sh" is run to
re-generate the "dns.zone" file. Our domain registrar, Gandi, has a
wonderful DNS API whereby we can directly upload a zone file using
"dnsput.sh", making DNS administration easy. If you read at "dns.zone",
that file is exactly what goes onto the DNS server and shows the current
state of Scheme.org at a glance.

Each project is associated with one or more individuals who can be
contacted in case of questions or problems.

* linux-configurations -- This repo holds the configurations for the
current Debian Linux VPS that runs the Scheme.org web server. The main
config is written as an S-expression which a small Scheme program
<https://github.com/lispunion/lander> turns into an Ansible
configuration. Ansible is then run to push the config to the server. I
didn't write an Ansible config directly because its native config format
consists of deeply nested directories full of little YAML files, which
is hard to edit. Nginx configuration files are similarly hard to edit,
so "nginx.scm" generates that stuff. Things are getting slightly hacky
at this point, and there's some repetition in the main config
"schemeorg.scm" but it definitely beats manual configuration and the
native formats for convenience. We can gradually develop these tools
into a more polished form.

It might be a good idea to standardize on Debian Linux for all the
"community-owned", consensus-driven servers. Debian is well-known among
schemers, and it would be the same familiar environment everywhere. For
subdomains that are operated by a particular group for their own project
(not consensus-driven), that group can of course use whatever software
they want.