Skip to content
This repository was archived by the owner on Apr 13, 2022. It is now read-only.
This repository was archived by the owner on Apr 13, 2022. It is now read-only.

Task: rewrite Solid spec in W3C template #170

Description

@RubenVerborgh

The current Solid specification has a couple of issues;

  • It is a collection of Markdown documents, as opposed to a single authoritative document
  • The specification contains parts that are (purposely) not implemented
  • Some parts that are implemented (and necessary) are not in the spec
  • The spec is insufficiently precise to be implemented in an unambiguous way

As such, I propose to start from scratch with a Solid spec in a W3C template, where we pull in curated parts of the current Solid v0.7 spec, with the aim of reaching a v1.0.

Activity

  1. elf-pavlik commented on May 14, 2019

    @elf-pavlik
    Member

    I suggest https://tabatkins.github.io/bikeshed/ many specs on REC track use it and it still allows using convenient markdown.

  2. justinwb commented on May 14, 2019

    @justinwb
    Member

    As such, I propose to start from scratch with a Solid spec in a W3C template, where we pull in curated parts of the current Solid v0.7 spec, with the aim of reaching a v1.0.

    I'm in 100% agreement with this proposal.

  3. Mitzi-Laszlo commented on May 14, 2019

    @Mitzi-Laszlo

    Perhaps in a new repo GitHub.com/solid/specification?

  4. michielbdejong commented on May 14, 2019

    @michielbdejong
    Contributor

    +1 to converting the format
    +1 to fixing points where the text diverts from current practice
    +1 to fixing ambiguities
    -1 to "pull in curated parts" if by that you mean making changes to the meaning of the spec
    -1 to " the aim of reaching a v1.0" if by that you mean changing its technical details into different ones

    In this phase (I would say from now to roughly the end of 2019), we should only change the spec to make it better describe the current practice, or to fix (security) bugs.

  5. RubenVerborgh commented on May 14, 2019

    @RubenVerborgh
    ContributorAuthor

    -1 to "pull in curated parts" if by that you mean making changes to the meaning of the spec
    -1 to " the aim of reaching a v1.0" if by that you mean changing its technical details into different ones

    conflict with

    +1 to fixing points where the text diverts from current practice

    but I agree with the overall sentiment.

  6. RubenVerborgh commented on May 14, 2019

    @RubenVerborgh
    ContributorAuthor

    But really, we should move away from the idea that v0.7 is untouchable, or even a spec. It's mainly a set of documentation written together, without any consensus process or anyone wondering whether something is a good idea. Let's have a minimum of oversight here.

    Regarding timeline specifically:

    In this phase (I would say from now to roughly the end of 2019),

    Why wouldn't we want a v1.0 by the end of 2019?

  7. removed their assignment
    on May 14, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions