- From: <elf-pavlik@hackers4peace.net>
- Date: Tue, 14 May 2019 18:04:50 -0500
- To: Ruben Verborgh <ruben.verborgh@ugent.be>
- Cc: public-solid <public-solid@w3.org>
+1 overall +1 to Ruben as one of the editors if he would like to take that responsibility On 2019-05-14 17:12, Ruben Verborgh wrote: > Dear all, > > The current specification for Solid is located at > https://github.com/solid/solid-spec/. > There are a couple of issues with this version: > > – It is a loose set of markdown documents, not a single, authoritative > looking spec. > > – These documents are out of sync with reality: > – Some features that are described, are purposely not implemented. > – Some features that are purposely implemented, are not described. > – Some features are purposely implemented differently than the spec > prescribes. > > – The documents leave ambiguity in many places, > meaning that they are insufficient to implement Solid. > > – Not everything in these documents has gone through a decision > process: > – Some features might be undesirable as basic requirements of Solid, > for instance, for computational reasons. > – Some decisions were taken pragmatically some time ago, > but do not necessarily reflect how we want to continue. > > > The reasons above should show that there is a need > to arrive at a consistent Solid specification. > > > My proposal for this is to start a new document for v1.0 > that follows the W3C specification template, > and to use GitHub’s pull request mechanism > to add curated sections of content to it. > > As a follow-up on https://github.com/solid/solid-spec/issues/170, > I have currently created the repository > at https://github.com/solid/specification/commits/gh-pages > with a live version at https://solid.github.io/specification/. > > These curated sections would come from the current spec documents, > but they would be rewritten to be accurate and unambiguous, > and people in the community should be given the opportunity > to comment on texts that get into the spec. > > This process will require processes for moving forward: > https://github.com/solid/specification/issues/1 > and likely 2–3 spec editors > (in addition to all of the past and current spec authors): > https://github.com/solid/specification/issues/2 > > I have also proposed this as a discussion topic for the next meeting: > https://www.w3.org/community/solid/wiki/Meetings#20190516_1000CEST > > As always, feedback most welcome. > > Best, > > Ruben
Received on Tuesday, 14 May 2019 23:05:21 UTC