Skip to content

Author: Frode Hegland

From Cuttings to Clippings in Liquid | Author

One of the taks for the iOS version of Liquid | Author is that the cuttings should be saved between sessions but on a per document basis, not across documents (this we can deal with later, some type of import/move). The team recommended that they use Clippings for this and I agree, it’s good to keep with an architecture Apple has built rather than do something from scratch.

This then highlighted the issue of having both Clippings (using OS X Clippings architecture for dragging small bits of text to the side of the screen) and Cuttings (multiple clipbard for cut) on OS X. These two commands essentially do the same; move stuff ouf the document for use later. How can they be reconciled?

I decided to use what was previously called cuttings (cmd-x to cut data then shift-cmd-v to see the list of previously cut items and tap/click to paste) and call it Clippings, since data-technically this is what they are.

I also decided to remove the current clippings feature on OS X (where you drag data to the sides of the screen). This was a very hard decsision to make since we have spend so much time and effort on polishing this feautre.

In the end it came down to having documents smoothly usable across OS X and iOS and cmd-x is quicker than drag.

The margins in OS X will be used for something super-cool though, tagging and/or multiple windows. But not for version 1.

Leave a Comment

Author Update

Met with Keith today and redesigned the top bar in Author iOS and changed the way citations work – they now look more like real citations but can be interacted with. Lunch demo yesterday also went well and I have asked the team to be ready with Beta Monday week, so let’s see…

Leave a Comment

Updating the Academic Citation System

The current default citation systems are out of date and now is a great time to update them for the 21st Century.

The post is a bit rambly but this is where I am up to this point. Sorry about that. Also please excuse this post from using long traditional URL’s without the type of citation system I’m referring to. We’re working on that. I am so impatient for Liquid “ Author to be ready for real work you have no idea…

First of all, what’s wrong with citations? https://medium.com/advice-and-help-in-authoring-a-phd-or-non-fiction/academic-citation-practices-need-to-be-modernized-6eb2e4a44846 is a good introduction to the issues with legacy paper-based citation systems limits in our digital world.

The issues are numerous but the goal of why and how to update the system should be the focus. So what is the point of citations? The dry definition would be something along the lines of allowing academics to show sources of assertions, data and refer to other information outside the document which somehow validates, supports and puts the work into context. A slightly less dry definition would involve referring to the web of interconnected scientific papers and being able to see what influenced what by doing citation analysis, “…the examination of the frequency, patterns, and graphs of citations in articles and books” http://en.wikipedia.org/wiki/Citation_analysis

A liquid definition would also include the ability for the academic reader and writer to navigate the web of citations and make quick sense at a glance and deep sense when required. The purpose of citations could be more poetically put as: Facilitating the movement and connection of knowledge.

On the Yale website, under “Why Cite?” “When you cite a source, you show how your voice enters into an intellectual conversation and you demonstrate your link to the community within which you work”
http://writing.yalecollege.yale.edu/advice-students/using-sources

The quote from the Yale website puts it really well. It is the conversation that truly matters. So how can we better use citations in conversations?

When someone cites something, it is either to back up, refute or question an assertion, or to provide context. Of course also to avoid plagiarism but that is such a basic point I won’t go into it, since that is the ‘cover your ass’ aspect, rather than a knowledge adding aspect.

Immediate improvements in how citations can support the academic conversation includes:

1) The first point is that there should be Web Addresses attached to any and all citations, wherever possible, to facilitate the connection via digital means. This includes DOI’s and such of course, as the industry changes, this will need to change. The web addresses should support anchors to paragraphs, if not sentences so that you don’t have to refer to a whole document and printed pages don’t mean anything anymore of course. Doug would demand this one.

2) The second point is to integrate the citation into the text, rather than leave it isolated in (bracketed ghettos).

3) The third point is to give the citations a voice, a way for the writer to specify why the citation is used and this can be done with tagging the citation.

4) Fourthly, why not, when possible, take the whole darn cited document and embed it inside the document you are working on? Unless there are commercial reasons not to (should be easy enough to block in commercial cases) why not add the full document? Modern ‘documents’ are really containers with ‘files’ inside them containing multimedia, style sheets and so on. I suggest we add a file for ‘cited documents’ which have names based on their retrieval URLS.

5) Fifthly? I don’t know, but this is where the real innovations come in to play. How about giving any and all comments in a document their own URLs? This way you can refer to what someone said in a comment or conversation and it’ll be just a click away to see the rest of the conversation and context. How about letting the user record their web histories when they are working and provide such histories as journey’s complete with comments and tagging, and of course they need to be addressable too. Vannevar Bush’s MEMEX would start to happen.

This is where I am at the moment. I’d love to hear your thoughts. Please blog and link or email me: frode@hegland.com

Leave a Comment