indieweb / micropub-extensions

Issue tracking for Micropub extensions
https://indieweb.org/Micropub-extensions
11 stars 1 forks source link

"extensions": ["…"] extension / registry #44

Open prof-milki opened 3 years ago

prof-milki commented 3 years ago

The extension discussion / consolidation process appears slightly hamstrung by not having a way to communicate explicit support. Even if most are just proposals or singular implementations, there should be a semi-unique identifier for each. Thus you could at least document and survey them via …/micropub?q=config endpoints.

For example:

{
 "media-endpoint": "…",
 "syndicate-to": [],
 "post-types": [],
 "q": [],
 "extensions": ["q", "post-types", "post-types-h", "mp-slug", "http-link-rel-micropub", "bug-token-local-only"]
}

Now some of the names are purely decorative. You can tell that post-types and q are supported by merely looking at the other config properties. It gets more relevant when documenting optional features (post-types-h) within existing structures.

Registry:

This obviously ought to go into the wiki:

extension shorthand description status
post-types Supported vocabulary standard
mp-slug (command) Proposed URL slug stable
post-status (property) Draft publication stable
visibility (property) Ghost publication stable
q List of supported queries consensus
post-types-h Adds h-type in vocabulary list uncommon
http-link-rel-micropub Self-references per header ... (?) proposed
post-types-properties-list Allowed property names as list singular
post-types-properties-dict-input Prop support documented within post-types singular
bug-local-token-only Only supports same-server tokens common(?)
p-me One of the sent properties should be a me: reference fictional
http-content-location Server sends C-L for 201 response (bug) rejected

The names can be arbitrary. Though some common prefixes http-, mp- or bug- (for honesty points) will probably emerge. It doesn't seemt necessary to mark up commands or properties in a special way. Any shorthand would do.

Pros/Cons:

jalcine commented 3 years ago

I like this idea a lot. I do think that this should live in the Wiki which each extension shorthand as an link-able anchor on the page for searching as well.

jalcine commented 3 years ago

Scanning the issues, this looks like it could be an extension (heh) of what #7 was aiming to provide.