You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
github is great for collaborating on the specs, issuing releases, version controlling, and tracking changes.
github is not that great for publishing the resulting documents.
i propose to publish the specs in a web-friendly way, so that non-tech people can read and browse the spec without the overhead of github's file browser and rendering/UI burdens.
minimal requirements
MUST: all relevant documents are hosted as web-ages:
MUST: the latest (master branch) is published automatically
MUST: have a list of contents rendered
non-requirements
may have a machine-readable page index rendered in SEO typical way.
no need for a fancy look-and-feel or theme: goal is to have human-readable publishing for the web - at first, we dont care for bright colors, appealing shapes and such
out-of-scopes & non-use cases
versioned publish: since there are no releases yet, we do not need to publish a set of documents per version -- latest is enough
providing prepress: we do not need to publish PDF or something. If needed, users can issue this via PDF/PS converters themselves, as modern browsers have this built in.
split publishing: yes, this is a mono-repo containing the PURL-spec and the VERS-spec; anyway, we do not need to split the publishing quite yet. this might be done as soon as the release-processes of the various specs are clarified.
The text was updated successfully, but these errors were encountered:
this is an RFC; feel free to comment.
i might modify the initial request to reflect the latest consensus. :D
Lets discuss requirements.
I do not want to discuss actual solutions right now.
(yet, we could publish to github pages, or readthedocs.io, or something else...)
(yes, we could generate via pandoc, or phinx, or rst2html, or something else...)
Anyway, if you have a solution that meats all (current) requirements, please let us know: post the URL to the publishing here 👍 and tell where we might find the CI pipelines and configs
github is great for collaborating on the specs, issuing releases, version controlling, and tracking changes.
github is not that great for publishing the resulting documents.
i propose to publish the specs in a web-friendly way, so that non-tech people can read and browse the spec without the overhead of github's file browser and rendering/UI burdens.
minimal requirements
master
branch) is published automaticallynon-requirements
out-of-scopes & non-use cases
The text was updated successfully, but these errors were encountered: