edit

From IndieWeb
(Redirected from ✏️)
Jump to: navigation, search

✏️


An edit (AKA diff, change) is a special type of reply that indicates a set of suggested changes to the post it is replying to. A collection of (presumably related) suggested edits in open source is often called a patch or pull request.

Why

Reasons why you should publish edit posts, and support having a reader show them. Each of these are use-cases of their own merit.

Own Your Edits

Contents

Why post your own edits

E.g. edit a Wikipedia page by posting an edit on your own site, and notifying the original.

  1. Find a Wikipedia page you want to edit
  2. Make a local copy on your own site
  3. Edit it on your own site
  4. Publish an edit post on your own site
  5. Notify the original page about your edit response by sending a webmention to Wikipedia.
  6. Wikipedia verifies the webmention and accepts the edit as being authored by your personal domain, like the User: domain accounts we already have here on IndieWebCamp (e.g. User:Tantek.com).

This is very similar to the existing git model of making a pull request from your own fork of a repository, and having that pull request automatically accepted because a repo policy.

Federated IndieWebCamp Edits

While the above user scenario with Wikipedia is hypothetical and would require Wikipedia and thus MediaWiki to support receiving webmentions from edit posts, and understanding IndieWeb identity, there is something we can do first to prove it can work.

We can implement this scenario on IndieWebCamp's MediaWiki installation first:

  1. Find a IndieWebCamp.com page you want to edit
  2. Make a local copy on your own site of the wiki source, and make a note of the permalink of specific version of the page (and section if you're only editing that)
  3. Edit the wiki source on your own site
  4. Publish an edit post on your own site with
    • the wiki source as e-content
      • (might have to use p-content with anything resembling markup escaped instead of e-content so the edit post doesn't look weird on your own site. so more like a special note with whitespace preserved than a special article)
    • a u-edit-of hyperlink to the version of the page you're editing.
  5. Notify the original page about your edit response by sending a webmention to IndieWebCamp.com (which already supports receiving webmentions, just doesn't do anything with them other than share with Loqi thus to IRC).
  6. IndieWebCamp.com verifies the webmention and accepts the edit as being authored by your personal domain, like the User: domain accounts we already have here on IndieWebCamp

And presto, you can edit IndieWebCamp.com without ever logging into it.

Quick typo fixes from friends

Why support receiving edits from others to your posts?

If someone you know and trust to edit your posts sends you an edit reply to your post, it would be nice to be able to automatically (or semi-automatically with a single "Accept" button click) to have those edits incorporated into your post, and somehow cite the edit post as having contributed.

This would require that the edit operations themselves (insertions, deletions, replacements) be explicitly marked up in a way that was automatically machine processable.

View Edits From Elsewhere

Why show edit posts in your reader?

By implementing the consumption and display of edit posts in your reader, you can view edits made by your account on another site, or edits to a particular page, or even all edits to a wiki.

E.g. if third party wiki commons (like Wikipedia) supported marking up their edit permalinks as edit posts, and in their streams of edits as well, it would be possible to follow/subscribe to them in an indie reader and see your edits on another site show up in the stream of posts in your reader.

Lightweight Pull Request

Why publish edits you would otherwise publish elsewhere?

The idea was discussed regarding the posting of git/code diffs in a post as a way to create a lightweight pull request. The post could contain action tags to trigger some kind of diff handler to open and inspect diff in the correct repo using git.

A Pull Request could be a published as:

How

We haven't quite figured out the "how" of a good way to markup edit posts.

A good start seems to be to write an "edit" like a reply, but with class="u-edit-of" instead of class="u-in-reply-to"

The details of how to markup the diffs (deletions, insertions, replacements) of an edit are still being figured out.

IndieWeb Examples

Kyle Mahan

Kyle Mahan has posted an edit post on 2015-02-02:

Open Source Examples

MediaWiki

MediaWiki, e.g. like on this wiki, has permalinks of individual edits:

As well multiple places where streams of edit summaries are displayed:

Commons Examples

Wikipedia

Wikipedia, an openly licensed commons, being the biggest deployment of MediaWiki, effectively has permalinks to diffs which show all the changes made in an edit. E.g.:

Silo Examples

Facebook

On Facebook, edit posts can be some of the most popular posts, e.g.

  • updated profile photo (perhaps most common)
  • changed relationship status to engaged to (person name)
  • changed relationship status to married to (person name)

(specific permalinks needed)

In each of these cases, such posts typically generate numerous responses (e.g. likes and comments), far more than the average on that person's other posts.

Facebook also allows others to suggest changes to your profiles e.g.:

  • Suggested your city is (city name)

Facebook Events

(stub - this section could use expansion and broader coverage)

While the create event UI lacks an option to select an existing photo, after the event has been created there is a button at the top right "Change Event Photo" which drops down several options, including "Choose from My Photos" and "Choose from Event Photos"

Facebook-edit-event-2016-03-07.png

(needs screenshot of the screen/dialog like the create#Facebook_Events screenshot)

...

Facebook Event Restrictions

Facebook has some event editing restrictions, including in particular capitals and punctuation in the event name, e.g.:

2016-06-03-facebook-event-rename-error.png

Event names need to use standard capitalization and can't make excessive use of special characters.

Note also the "Suggested name:" below the field.

Obviously no such restrictions exist on the IndieWeb.

You can name your indie events whatever you want.

GitHub

GitHub, a silo, has permalinks to pull requests which are a collection of commits, or edit posts. E.g.:

as well as permalinks to individual commits (edit posts)

ThinkUp

ThinkUp, a tool that monitors twitter and facebook posts edits to people's biographies as coloured diffs. E.g.:

thinkupeditexample.png

Brainstorming

Edit a specific property

Thoughts on how to publish an edit of a specific property.

Below is an example of updating a photo property of an h-card as discussed on IRC 2015-05-27 and iterated on github.

Consumers of this post must act only on non-empty property values on the object embedded on the "p-update" property.

<div class="h-entry">
  <a href="http://aaronparecki.com" class="u-author h-card">Aaron Parecki</a> updated 
  <a href="http://aaronparecki.com" class="u-edit-of">his</a> profile photo
  <div class="p-update h-card">
    <img src="http://example.com/photo2.jpg" class="u-photo">
  </div>
  at <time datetime="2015-05-27T13:37-0700">13:37</time>
</div>
{
  "items": [
    {
      "type": [
        "h-entry"
      ],
      "properties": {
        "author": [
          {
            "type": [
              "h-card"
            ],
            "properties": {
              "name": [
                "Aaron Parecki"
              ],
              "url": [
                "http:\/\/aaronparecki.com"
              ]
            },
            "value": "Aaron Parecki"
          }
        ],
        "update": [
          {
            "type": [
              "h-card"
            ],
            "properties": {
              "photo": [
                "http:\/\/example.com\/photo2.jpg"
              ],
              "name": [
                ""
              ]
            },
            "value": "http:\/\/example.com\/photo2.jpg"
          }
        ],
        "edit-of": [
          "http:\/\/aaronparecki.com"
        ],
        "name": [
          "Aaron Parecki\r\nupdated his profile photo\r\n \r\nat 13:37"
        ]
      }
    }
  ],
  "rels": {
    
  }
}


Similar to p-update

  • p-delete with embedded object with a property, or specific value of a property, indicating deletion granularity
  • p-add with embedded object with property with a value to add

Related:

reuse structure from Micropub?

Micropub has edits, maybe that structure could be adapted? (With the benefit that accepting an edit could be a straight-forward translation of a proposed edit to an MP-request).

fragmention

A very basic option (e.g. to propose a spelling correction) could be a fragmention for content selection and just the proposed replacement text.

See Also

Retrieved from "https://indieweb.org/edit"
Personal tools
Namespaces
Variants
Actions
Recent & Upcoming
Resources
Toolbox