- Feb 2021
We decided against paid documentation, so all will be freely available on our shiny new website.
What this means is: I better refrain from writing a new book and we rather focus on more and better docs.
I'm glad. I didn't like that the book (which is essentially a form of documentation/tutorial) was proprietary.
I think it's better to make documentation and tutorials be community-driven free content
- free content
- I agree
- finally / at last
- paid content
- knowledge commons (information/data/content)
- non-free content
- welcome/good change
- I'm glad they did it this way
- focus on the user
- community-driven development
- gratis content
- annotation meta: inherit same annotation/tags
- Jun 2015
Inclusion Guidelines for Webmasters
This documentation describes the technology behind indexing of websites with scholarly articles in Google Scholar. It's written for webmasters who would like their papers included in Google Scholar search results. Detailed technical information is helpful if you're trying to fix an error in indexing of your own website, or you need to make sure that your article hosting product is compatible with Google and Google Scholar search services.
- Feb 2014
Ho w to R ead a Judicia l Opin ion: A G uid e for N ew L aw Stu den ts Professor Orin S. Kerr George Washington University Law School Washington, DC Version 2.0 (August 2005) This essay is desig ned to help entering law students understand ho w to read cas es for class. It explains what judicial opinions are, how they are structured, and what you should look for when you read them. Part I explains the various ingredients found in a typical judicial opinion, and is the most essential section of the essay . Par t II discusses what you should look for when you re ad an opinion for class. Part II I con clu des with a brief discussion of why law schools use the case method.
I need a way to add tags to a document that will apply to all annotations in a particular document (except where explicitly canceled).
The problem is that I often want to query all annotations related to a specific document, collection of documents, or type of activity.
Type of activity requires further explanation: Given a document or collection of documents I may annotate the document for different reasons at different times.
For example, while annotating the reading materials, video transcripts, and related documents for the CopyrightX course there are certain types of annotations that may be "bundled together" so that when I search for those things later I can easily narrow my searches to just that subset of annotations; but at the same time I need a way to globally group things together.
While reading judicial opinions the first activity/mode of interaction with a particular document may be to identify the structure of the judicial opinion (the document attached to this annotation describes the parts of the judicial opinion I might want to identify: *caption, case citation, author, facts of the case, law of the case, disposition, concurring and/or dissenting opinions, etc).
The above-described mode I may use for multiple documents in one session related to the course syllabus for the week.
To connect each of these documents together I might add the tags: copyx (my shorthand for the name of the course, CopyrightX), week 1 (how far into the course syllabus), foundations (the subject matter in the syllabus which may span week 1, week 2, etc), judicial opinions (the specific topic I am focused on learning at the moment (may or may not be related to the syllabus).
Later on another day I might update my existing annotations or add new ones when I am preparing to study for an exam. I might add tags like to study, on midterm, on final to mark areas I need to review.
After the exam I might add more tags based on my test score, especially focusing on areas that received a poor score so I can study that section more or, if I missed some sections so didn't study and it resulted in a poor score in that area, add tags to study for later if necessary.
I have many more examples and modes of interaction in mind that I can explain more later, but it all hinges on a rich and flexible tagging system that:
- allows tagging a document once in a way that applies to all annotations in a document
- allows tagging a session once in a way that applies to all annotations in all documents connected to a particular session
- allows tagging a session and/or a document that bundles together new tags added to an annotation (e.g. tags for grammar/spelling, tags for rhetological fallacy classification, etc)
- fast keyboard-based selection of content
- batch selection of annotation areas with incremental filling-- I may want to simply select all the parts of a document to annotate first and then increment through each of those placeholders to fill in tags and commentary
- Mark multiple sections of the document at once to combine into a single annotation
- Excerpting only parts of a text selection, but still carry the surrounding textual context with the excerpt to easily expose the surrounding context when necessary
- A summary view of a document that is the result of remixing parts of the original document with both clarifications or self-containing summary re-writes and/or commentary from the reader
- structural tagging vs content tagging