https://web.archive.org/web/20241202062809/https://modelcontextprotocol.io/introduction

Anthropic's Model Context Protocol MCP documentation. Includes basic server exercises. The spec doesn't say much at first glance about how resources would actually be connected to a MCP server to serve as context.

TRSP Desirable Characteristics PID Service Providers SHOULD document a summary of their maintenance and availability provisions publicly.

TRSP Desirable Characteristics

Alle Titel der Nordrhein-Westfälischen Bibliographie (NWBib) beinhalten folgendes Datum: "inCollection.id": "http://lobid.org/resources/HT014176012#!"

Zur Einschränkung einer API-Abfrage auf das NWBib-Subset muss die Abfrage entsprechend hiermit ergänzt werden: inCollection.id:"http://lobid.org/resources/HT014176012#!".

Beispiel: Alle Titel der NWBib mit "Köln" im Titel:

title:Köln AND inCollection.id:"http://lobid.org/resources/HT014176012#!"

Name

Rolle

Beschreibung

Enthält die Rolle des Akteurs als Eintrag aus der MARC Code List for Relators mit lobid-spezifischem Label.

Verwendungsbeispiele

• Ressourcen mit "Robert Craft" als Dirigenten.
• Ressourcen mit Angabe von Schauspieler:innen und Dirigent:innen im Stadttheater zu Düsseldorf.
• Ressourcen mit Harry Rowohlt als Übersetzer

URI

http://id.loc.gov/ontologies/bibframe/role

Name

Erscheinungsende

Beschreibung

Bei Werken mit Erscheinungsverlauf wird hier das Erscheinungsende in der Form YYYY aufgeführt.

Vorkommen

Ca. 1,5 Millionen Einträge besitzen ein Datum zum Erscheinungsende.

MARC-Felder

Stammt aus dem MARC-Feld 260 und 264 $c.

URI

http://schema.org/endDate

Name

ISSN

Beschreibung

Enthält die ISSN (International Standard Serial Number) ohne Bindestrich.

Abdeckung

Ca. 600.000 Einträge besitzen eine ISSN (Stand: Mai 2024).

Beispiel

Unter den vielen anderen Ausgaben die regelmäßig erscheinende Frankfurter Allgemeine Zeitung finden.

MARC-Felder

Stammt aus dem MARC-Feld 022.

URI

http://purl.org/ontology/bibo/issn

Name

Schlagwort

Beschreibung

Enthält Schlagwörter, Klassifikationen und Schlagwortfolgen, ihre URI und meistens eine Klasse.

Abdeckung

Es gibt über 11,2 Mio Einträge, die mindestens ein Schlagwort besitzen, welches nicht aus der NWBib-Sachsystematik stammt (siehe nwbibSpatial im Artikel-Beispiel).

Beispiel

Alle Werke, die mit "Sonne" und "Mond" verschlagwortet sind.

Name

ZDB-ID

Beschreibung

Enthält die ZDB-ID.

Abdeckung

Enthalten bei ca. 2,2 Mio. Einträgen. Bei ca. 2,1Mio., Periodika und Serien enthalten, fehlt bei ca. 548.000 Periodika und Serien (Stand: Mai 2024).

Verwendungsbeispiel

Die Lokalausgabe einer Zeitung ohne ISSN finden (z.B. die Ausgabe für Enger und Spenge der Zeitung Neue Westfälische).

MARC Feld

Aus dem MARC Feld 035.

URI

http://purl.org/lobid/lv#zdbID

Name

Enthalten in

Beschreibung

Dies ist ein Aufsatz-spezifisches Feld. Es enthält die URI der übergeordneten Ressource (meist eine Aufsatzsammlung oder Zeitschrift), in der ein Aufsatz enthalten ist.

Abdeckung

Ca. 750.000 Aufsätze haben einen Link zur übergeordneten Ressource.

URI

http://purl.org/lobid/lv#containedIn

Name

Klasse

Beschreibung

Enthält den Publikationstyp. Jede lobid-Ressource hat den generischen Typ BibliographicResource (=bibliographische Ressource) und einen oder mehrere weitere Typen.

Beispiel

Spiele, die sich mit Mathematik beschäftigen.

MARC-Felder

Der Publikationstyp stammt meistens aus Leader+008, 006, 007, 245 $h, 300 $a

URI

type ist auf das JSON-LD-Keyword "@type" gemappt, das in diesem Zusammenhang (als node type) in RDF mit http://www.w3.org/1999/02/22-rdf-syntax-ns#type übersetzt wird.

Name

Titel

Beschreibung

Titel der Ressource

Abdeckung

Es gibt ca. 3900 Einträge, die keinen Titel besitzen (Stand: Mai 2024).

Beispiel

Suche nach Werken mit "Schwimmen" und "Essen" im Titel.

MARC-Felder

Stammt aus dem MARC-Feld 245 $a $n $p

URI

http://purl.org/dc/terms/title

Name

Identisch mit

Beschreibung

Enthält URIs von anderen Ressourcen, die mit der beschriebenen identisch sind. Verlinkte Quellen sind derzeit Culturegraph, ZDB-Linked-Data-Service, WorldCat, DNB, NWBib, DOI-Link, URN-Link.

Abdeckung

Über 25 Mio mit sameAs-Element: http://lobid.org/resources/search?q=exists%3AsameAs und ca. 2,2 Mio ohne http://lobid.org/resources/search?q=NOT+exists%3AsameAs

URI

http://schema.org/sameAs

Name

Erscheinungsort

Beschreibung

Enthält die Angabe der Erscheinungsorte in unkontrollierter Form (siehe etwa das Kürzel u.a.).

Abdeckung

Enthalten bei ca. 23,9 Mio. Einträgen, fehlt bei ca. 3,8 Mio..

MARC-Feld

Stammt aus den MARC-Feldern 264 $a, 260 $a, 533 $b

URI

http://schema.org/location

Name

Sprache

Beschreibung

Die Sprache, in der eine Ressource verfasst ist, identifiziert anhand der URI beim Normvokabular der LoC mit Angabe der deutschsprachigen Benennung.

Abdeckung

Enthalten bei über 19 Millionen Einträgen, fehlt bei ca. 8,6 Millionen.

Verwendungsbeispiel

Alle 2016 in polnischer Sprache erschienen Ressourcen.

MARC-Feld

Basiert auf Kontrollfeld 008 Pos 35-37 und 041 $a $d $j

URI

http://purl.org/dc/terms/language

Name

Modifizierende Institution

Beschreibung

Enthält die URI der Institution, die als letztes eine Modifikation des entsprechenden Alma-Datensatzes vorgenommen hat.

MARC-Feld

Basiert auf Feld 040 $d

URI

http://open-services.net/ns/core#modifiedBy

Name

Beschrieben durch

Beschreibung

Dieses Objekt enthält Informationen zur Beschreibung (den Datensatz/Katalogeintrag) selbst. Neben Benennung und URI des beschreibenden Datensatz sind dies insbesondere Erstellungs- und Modifikationsdatum (describedBy.resultOf.object.dateCreated und describedBy.resultOf.object.dateModified) und Angaben zu den eingebundenen Einrichtungen. Es handelt sich wohlgemerkt, um die Modifikation der zugrundeliegenden MARC-/ALMA-Quelldaten, die nicht notwendigerweise eine Änderung in den lobid-Daten nach sich ziehen.

Verwendungsbeispiel

Diese Angaben sind besonders relevant, um sich inkrementelle Updates zu ziehen. Eine Liste aller Ressourcen, die seit dem 1. April 2024 geändert oder ergänzt wurden: https://lobid.org/resources/search?q=*+AND+describedBy.resultOf.object.dateCreated%3A%3E2024-04-01+OR+describedBy.resultOf.object.dateModified%3A%3E2024-04-01

URI

http://www.w3.org/2007/05/powder-s#describedby

Name

Exemplar

Beschreibung

Eine Aufzählung aller physischer und elektronischer Exemplare der Ressource im hbz-Verbundkatalog.

Abdeckung

Etwa 3,4 Millionen Ressourcen haben kein angehängtes Exemplar (teilweise auch, weil es sich um unselbständige Werke – Bände, Zeitschriftenartikel – handelt).

MARC-Felder

Basiert auf hbz ALMA Publishing spezifischen Felder: ITM, HOL, H52, POR

URI

http://id.loc.gov/ontologies/bibframe/hasItem

Name

Bearbeitungsdatum

Beschreibung

Enthält das Datum, an dem das Katalogisat zum letzten Mal in Alma bearbeitet wurde im Format jjjj-mm-tt.

Abdeckung

Ca. 2,1 Millionen Ressourcen haben kein Bearbeitungsdatum, das heißt die Katalogeinträge wurden nach ihrer Erstellung nicht mehr angefasst.

Verwendungsbeispiele

• Eine Liste aller Ressourcen, die am oder nach dem 1. April 2024 das letzte Mal verändert wurden: https://lobid.org/resources/search?q=*+AND+describedBy.resultOf.object.dateModified%3A%3E2024-01-01

MARC-Feld

Basiert auf hbz ALMA Publishing spezifisches MARC spezifisches Feld MGN $d

URI

http://purl.org/dc/terms/modified

Name

Erstellungsdatum

Beschreibung

Enthält das Datum an dem die Ressource in Alma erfasst wurde oder durch Fremddatenübernahme in den Katalog kam im Format jjjj-mm-tt.

Verwendungsbeispiele

• Einschränken einer Suche auf Titel, die nach der RDA-Einführung im hbz-Verbund (1.1.2016) ergänzt wurden: https://lobid.org/resources/search?q=bibliothek+AND+describedBy.resultOf.object.dateCreated%3A%3E2016-01-01

Abdeckung

Alle Resourcen haben ein Erstellungsdatum.

MARC-Feld

Basiert auf hbz ALMA Publishing spezifisches MARC spezifisches Feld MNG $b

URI

http://purl.org/dc/terms/created

Name

JSON-LD-Kontext (@context)

Beschreibung

@context ist ein JSON-LD-Keyword, mit dem das JSON-LD-Kontext-Dokument angegeben wird. Es beinhaltet ein Mapping von JSON Keys auf RDF-Properties und von Typen auf RDF-Klassen. Mit dem JSON-LD-Kontext kann aus dem angebotenen JSON, RDF generiert werden.

Abdeckung

Der JSON-LD-Kontext ist in jedem Eintrag verlinkt.

Verwendungsbeispiele

• Dieser Beispieleintrag lässt sich etwa in verschiedene andere RDF-Serialisierungen überführen.

Name

Beilagen

Beschreibung

Enthält URIs von Beilagen zur Ressource.

MARC-Felder

Stammt aus MARC-Feld 770 Ind1=0 Ind2=8.

URI

http://id.loc.gov/ontologies/bibframe/supplement

Name

Verantwortlichkeit

Beschreibung

Enthält die Verantwortlichkeitsangabe. Es können z.B. einfache Autorenangaben (siehe Beispiel Buch), Doktoranden oder auch Beteiligte an Musikwerken hier angegeben sein.

MARC-Feld

Basiert auf Feld 245 $c

URI

http://id.loc.gov/ontologies/bibframe/responsibilityStatement

Name

Veröffentlicht von

Beschreibung

Enthält den Verlag oder die verlegerisch tätig werdende Institution bzw. Person.

Abdeckung

Enthalten bei ca. 22,9 Mio Einträgen, fehlt bei ca. 4,8 Mio..

MARC-Feld

Stammt aus den Feldern 264 $b, 260 $b, 533 $c

URI

http://schema.org/publishedBy

Name

Medientyp

Beschreibung

Angabe von URI und Namen des Medientyps, identifiziert unter Nutzung verschiedener kontrollierter Vokabulare.

Verwendungsbeispiel

Audio-Werke in französischer Sprache.

MARC-Felder

Basiert auf den Feldern Leader+008, 006, 007, 245 $h, 300 $a, 337 $a, 338 $b, 340, 546, 655 $a

URI

http://purl.org/dc/terms/medium

Name

ISBN

Beschreibung

Enthält 10- und 13-stellige ISBNs ohne Bindestriche.

Abdeckung

Insgesamt besitzen über 8,8 Millionen Einträge eine ISBN. Bei den Büchern besitzen ca. +8,7 Millionen Einträge eine ISBN, bei ca. 5,7 Millionen Einträgen von 1969 (Einführungsjahr der ISBN) bis 2024 fehlt sie.

Verwendungsbeispiel

Alle Publikationen, die im Jahr 2030 erscheinen und schon eine ISBN besitzen.

MARC-Feld

Basiert auf Feld 020 $a

URI

http://purl.org/ontology/bibo/isbn

Name

Urheber des Datensatzes

Beschreibung

Enthält die URI der Institution, die den ursprünglichen Datensatz erstellt hat.

MARC-Feld

Basiert auf Feld 040 $a

URI

http://schema.org/sourceOrganization

Name

hbz-Id

Beschreibung

Alphanumerische Zeichenkette zur Identifizierung des Datensatzes im hbz-Verbundkatalog. Sie wurde als Bestandteil der lobid-URIs verwendet. Als deprecatedUri ist sie weiterhin auflösbar.

Abdeckung

Bei allen Verbundtiteln und bei allen ZDB-Titeln, die im Verbundkatalog bis zur Umstellung eine hbz-Id erhalten haben.

MARC-Feld

Basiert auf Feld 035 ## $a, wenn der Wert ein Prefix (DE-605) hat

URI

http://purl.org/lobid/lv#hbzID

Name

Umfang

Beschreibung

Gelieferte Umfangsangabe.

Abdeckung

-- nicht indexiert --

MARC-Feld

Basiert auf Feld 300

URI

http://id.loc.gov/ontologies/bibframe/extent

Name

Auflage

Beschreibung

Unstrukturierte Angaben über die Auflage des Werks.

Abdeckung

Enthalten in ca. 5,5 Millionen Einträgen.

Marc-Feld

Basiert auf Feld 240 $a.

URI

http://purl.org/ontology/bibo/edition

Name

Beschreibung

Beschreibung

Dieses Feld beinhaltet einen Link zum Beschreibungstext einer Resource. In den meisten Fällen ist dies der Klappentext auf den Servern der Deutschen Nationalbibliothek (DNB).

Abdeckung

-- nicht indexiert --

Marc-Feld

Stammt aus dem MARC-Feld 856, Ind1=4 $u insofern in $3 angegeben ist, dass es sich um ein Inhaltstext handelt.

URI

http://purl.org/dc/terms/description

Name

ALMA-Mms-Id

Beschreibung

Numerische Zeichenkette zur Identifizierung des Datensatzes in ALMA. Sie wird als Bestandteil der lobid-URIs verwendet, z.B. http://lobid.org/resources/990212549810206441

Die letzten vier Ziffern verweisen auf die Zugehörigkeit eines Datensatzes zur NZ des hbz-Verbund (6441) oder IZ einer Verbundbibliothek.

Abdeckung

100%

MARC Feld

Basiert auf 001

URI

http://purl.org/lobid/lv#almaMmsId

Name

Alternativer Name / Bezeichnung

Beschreibung

Enthält Namensvarianten der Person oder Institution, aber auch von Schlagworten. Basis dieser Varianten sind die über ALMA bereitgestellten GND-Anreicherungen.

Verwendungsbeispiele

Prinzipiell sollte eine Suche nach Ressourcen anhand beteiligter Personen auch die Namensvarianten abfragen. Beispiel: Eine Suche über die Namen und variierende Namensformen aller beitragenden Personen: https://lobid.org/resources/search?q=contribution.agent.label:Charles+Dodgson+AND+contribution.agent.altLabel:Charles+Dodgson

MARC-Felder

Basiert auf den hbz ALMA spezifischen Publishing Feldern GPN, GKS, GEL, GKT, GST, GGN

URI

http://www.w3.org/2004/02/skos/core#altLabel

Name

Beitrag zu einem Werk

Beschreibung

Zu einem Werk gehören ein oder mehrere Beiträge, die als Objekte in einer sortierten Liste angegeben werden. Ein Beitrag besteht aus der Angabe der beitragenden Institution oder Person und ihrer Rolle in bezug auf die beschriebene Ressource.

Neben Organisationen und Personen können auch zugehörige Veranstaltungen als contribution ausgewiesen sein.

Abdeckung

Vorhanden bei ca. 22,7 Millionen Einträgen, fehlt bei ca. 4,9 Millionen Treffern.

Verwendungsbeispiele

Eine Suche über die Namen und variierende Namensformen aller beitragenden Personen: https://lobid.org/resources/search?q=contribution.agent.label:Harry+Rowohlt+AND+contribution.agent.altLabel:Harry+Rowohlt

Marc-Felder

Basiert auf 100,110,111, 700, 710, 711.

URI

http://id.loc.gov/ontologies/bibframe/contribution

Name

Reihen- oder Bandzählung

Beschreibung

Enthält die Zählung des Bandes innerhalb eines mehrbändigen Werks oder einer Reihe.

Abdeckung

--- nicht indexiert ---

MARC-Felder

Stammt aus folgenden MARC-Feldern: 490 $v, 773 $q und 830 $v

URI

http://purl.org/lobid/lv#numbering

Name

Erscheinungsfrequenz / Periodizität

Beschreibung

Enthält die Erscheinungsfrequenz eines Periodikums unter Nutzung des kontrollierten Vokabulars MARC21-008: Frequency of continuing resource.

Vorkommen

Über 700.000 Einträge besitzen eine Angabe zur Erscheinungsfrequenz, bei mehr als 1,5 Millionen Periodika fehlt eine Angabe zur Erscheinungsfrequenz (Stand: Mai 2024).

MARC-Felder

Stammt aus dem MARC Feld 008 und 006 .

URI

http://id.loc.gov/ontologies/bibframe/frequency

Name

Angaben zur übergeordneten Publikation

Beschreibung

Dieses Feld findet sich hauptsächlich bei Aufsätzen. Es enthält bibliographischen Angaben zur Ressource, in der der Aufsatz enthalten ist.

Abdeckung

Enthalten bei ca. 1,1 Mio Einträgen, fehlt bei ca. 151.623 Aufsätzen (Stand: Mai 2024

MARC-Felder

Stammt aus dem MARC Feld 733.

URI

http://purl.org/dc/terms/bibliographicCitation

Name

Art des Inhalts

Beschreibung

Enthält genaure Informationen zur Art des Inhalts unter Nutzung kontrollierter Werte aus der GND, siehe die Liste. Vorhanden bei neuen Einträgen ab Ende 2015.

Abdeckung

Vorhanden bei ca. 4,4 Mio Ressourcen (Stand: Mai 2024).

MARC-Felder

Stammt aus dem MARC-Feld 655.

URI

http://rdaregistry.info/Elements/u/P60584

Name

Inhaltsverzeichnis

Beschreibung

Link zu einem digitalisierten Inhaltsverzeichnis der Ressource.

Abdeckung

-- nicht indexiert --

MARC-Felder

Stammt aus dem MARC-Feld 856, Ind1=4 $u insofern in $3 angegeben ist, dass es sich um ein Inhaltsverzeichnis handelt.

URI

http://purl.org/dc/terms/tableOfContents

Name

Erscheinungsdatum

Beschreibung

Enthält das Erscheinungsjahr bzw. bei Publikationen mit Erscheinungsverlauf den Beginn des Erscheinens.

Abdeckung

Enthalten bei über 24,7 Millionen Einträgen, fehlt bei mehr als 2,9 Millionen.

Verwendungsbeispiel

Publikationen zur allgemeinen Suche "Bibliothek" seit 2013

MARC-Felder

Stammt aus dem MARC-Feld 264 $c, 260 $c, 500 $a, 533 $d, oder 008 Pos 08-11 .

URI

http://schema.org/startDate

Name

Weitere Titelinformationen

Beschreibung

Enthält Informationen, die den Titel (title) der Ressource ergänzen

Abdeckung

Vorhanden bei ca. 12,3 Millionen Ressourcen.

MARC-Felder

Stammt aus den MARC-Feldern 245 $b

URI

http://rdaregistry.info/Elements/u/P60493

These are all basically the same as email steps.

This is the same behavior as email except that being opted in is defaulted to Opt-Out.

Phone number validation is available.

https://docs.oracle.com/en/cloud/saas/marketing/eloqua-user/Help/ContactFields/Tasks/PhoneNumberValidation.htm

https://docs.oracle.com/en/cloud/saas/marketing/eloqua-user/Help/Forms/Tasks/StyleForm.htm#Field

https://diataxis.fr/

See also: https://documentation.divio.com/

I think Peter called this "secret knowledge".

https://documentation.divio.com/

https://docsify.js.org/#/

I think it is absolutely absurd that Apple still(?) chooses to publish "complete" ""feature lists"" in Portable Document Format, of all motherfucking things, but - as always - thank fucking God for mr Hypo Thesis over here!

Pages is so much more impressive than you'd expect in so many ways, but damn...

The way styles are handled still perplexes the shit out of me... even after consuming this document.

Documentation-first culture

High five :)!

What a cool documentation design; I love the all-in-one layout.

Very reminiscent of the old CoffeeScript docs, to me.

See my reference Craft document for an index of said shortcuts. (I intend to publish it in more formats soon.)

Which can be triggered by perhaps the most reliable Safari Extension keyboard shortcut (on iOS/iPadOS) to date: ⌘⇧E.

Kindof astonished Apple acknowledged this, here.

Profile of Ted Nelson

https://s3.amazonaws.com/plan9-bell-labs/7thEdMan/index.html<br /> Unix Seventh Edition Manual

<small><cite class='h-cite via'>ᔥ <span class='p-author h-card'>Brandon Rhodes</span> in Semantic Linefeeds (<time class='dt-published'>12/27/2022 11:35:19</time>)</cite></small>

Web Monetization official site with motivation, wallets, providers, browsers, search engines, tools, documentation link, explainer link, specifications link, awesome list link, github link

https://thomasmdickinson.github.io/lab-soc-about/

<small><cite class='h-cite via'>ᔥ <span class='p-author h-card'>Keeper of the Labyrinth </span> in Keeper of the Labyrinth: "#Mastodon #Hometown #Admin I love documentation…" - Labyrinth.Social (<time class='dt-published'>11/19/2022 01:31:45</time>)</cite></small>

In putting it together, I looked at a lot of other instances to see what kind of docs and policies they had, so now I want to pay it forward and put it out there for others to use as a basis.

If you run a small instance or are thinking of doing so, feel free to repurpose what I've put together!

http://docs.feedland.org/firstThings.opml

Testing if Google Chrome can make annotations on this Auto Hotkey documentation page.

It (and Brave) can't make highlights or annotations for some reason. The prompt doesn't appear when text is highlighted, why is this? Is there a way to force the prompt to appear?

Page: Escape Sequences

I was looking for documentation on escaped characters.

This was because Auto Hotkey threw an error when I used <%* %> as an option for the text insert script. It said the illegal character was * but really what was happening was that the unquoted text %* % was treated like a variable since % is used to enclose variables in Auto Hotkey. The solution was to escape the percent sign with one left back tick.

Page on the the Templater syntax <%+ ... %>. It allows use of "dynamic commands" which are only executed in preview mode in Obsidian

Link to video on "Boundaries" doesn't go into depth on the functional core, imperative shell pattern. However, this one does: https://www.destroyallsoftware.com/screencasts/catalog/functional-core-imperative-shell

Keep functional & unit tests separate. Functional for common cases, unit for all others.

Probably means, "Call tox directly if you only want to run the backend test suite."

The article contains no proof of this statement.

If someone knows of research that proves this, please let me know.

generic example of that the concept of an error should be attached to the quantity or a field with <same_name>_error should be added

? What does it mean for a collision data to be sent to an impact object?

In the other implementation, we used impact object rigidbody/single material and assigned to it the impact material we created, which would be used in the tags library.

? What are the details of the ImpactObjectRigidbody in this case?

-~

^ It seems that FixedUpdate is prone to causing overhead

? Must be on the root of the object, the same object as the rigid body? which rigidbody, the parent or the child?

? Impact Triggers must be on the same component as the Rigidbody

? what are static objects and level geometry?

~?

^ Impact Objects can also provide physics data such as rigidbody velocity.

^ Creating an Audio Source Template as a singular source for audio management

? What is an object pool?

-- the Impact Tag Library is where we define the list of tags for our materials.

i.e.: Plastic, Glass, Concrete...etc

~? What are interaction results?

Is it about how many times the object is interacted with in the scene?

How would one go on about measuring that?

? what does it mean that processing will be aborted immediately? what is processing in that case?

Is it meant that the interactions; the sounds emitted would not go through if they were supposed to occur?

~? Are static single material objects, objects without a rigid body?

? What does it mean for a material composition or velocity data to be obtained?

-~ The impact mapping would include the properties of the physics material by Unity and allows us to use Impact functionality, such as using the material to produce specific sounds on impact with it

Setting Material Composition Buffer Size to the number of textures the terrain uses

Tags

Offline docs: - macOS: Dash ($30) - Windows/Linux: Zeal (free) - Windows: [Velocity] (https://velocity.silverlakesoftware.com/) ($20) - Web: DevDocs

I think this satisfies the threshold of "minimum viable publication". So write this up and reference it here.

Full impl.:

getLineStart(tokenPosition, anteTerminators = null) {
  if (tokenPosition > this._edge && tokenPosition != this.length) {
    throw new Error("random access too far out"); // XXX
  }

  // NB: Since line terminators can be the multibyte CRLF sequence, care
  // must be taken to ensure we work for calls where `tokenPosition` is some
  // start minus 1, where that "start" is some line start itself.
  for (let i = this._lineTerminators.length - 1; i >= 0; --i) {
    let current = this._lineTerminators[i];
    if (tokenPosition >= current.position + current.content.length) {
      if (anteTerminators) {
        anteTerminators.push(...this._lineTerminators.slice(0, i));
      }
      return current.position + current.content.length;
    }
  }

  return 0;
}

(Inlined for posterity, since this comes from an uncommitted working directory.)

Believe it or not, finding this sentence, just now was actually a huge breakthrough in my iPhone Keyboard Reference project...

Proud of you, bastards, for actually saying one sentence!

This is a recurring grievance of mine with the way most people approach writing documentation. Closely related: code comments should explain the why, not the what (or worse the how—which just ends up rehashing the code itself).

Too many people try to launch right in and explain what they're doing—their solution to a problem—without ever adequately outlining the problem itself. This might seem like too much of a hassle for your readers, but often when the problem is explained well enough, people don't actually need to read your explanation of the solution.

Documentation is not about developers. Documentation is for the users, folks. There is no excuse - business or otherwise - for poor documentation. If your software is poorly documented, you have failed as a software company.