475 Matching Annotations
  1. Apr 2017
    1. "description"
      Name

      Beschreibung der Öffnungszeiten

      Beschreibung

      Angaben zu den Öffnungszeiten der Einrichtung

      Abdeckung

      Vorhanden bei ca. 7000 Einträgen, fehlt bei ca. 15000 Einträgen.

      Verwendungsbeispiele

      Da das Feld nicht standardisiert ausgefüllt ist, eignet es sich eher für die menschenlesbare Anzeige innerhalb eines Web-Angebots als für die maschinelle Auswertung. Es kann also leider nicht dafür genutzt weden um eine Suche einzugrenzen auf Institutionen die zu einem bestimmten Zeitpunkt geöffnet haben.

    2. "comment"
      Name

      Anmerkung zu den Öffnungszeiten

      Beschreibung

      In diesem Feld finden sich ergänzende oder präzisierende Angaben zu den Öffnungszeiten.

      Abdeckung

      Vorhanden bei ca. 1000 Einträgen.

      URI

      http://www.w3.org/2000/01/rdf-schema#comment

      Provenienz

      Information stammt aus Pica+-Feld 032P $j der ISIL-Daten siehe ISIL-Format-Dokumentation.

    3. "addressCountry"
      Name

      Land

      Beschreibung

      Das Land, in dem sich der Sitz der Institution befindet.

      Abdeckung

      Vorhanden bei ca. 21.000 Einträgen, fehlt bei ca. 880.

      Verwendungsbeispiele
      URI

      http://schema.org/addressCountry

    4. "addressLocality"
      Name

      Ortsname

      Beschreibung

      Der Name des Ortes, in dem die Institution ihren Sitz hat.

      Abdeckung

      Vorhanden bei ca. 21.000 Einträgen, fehlt bei ca. 880 Einträgen.

      Verwendungsbeispiele
      URI

      http://schema.org/addressLocality

    5. "streetAddress"
      Name

      Straße und Hausnummer

      Abdeckung

      Vorhanden bei ca. 21.000 Einträgen, fehlt bei ca. 1000.

      URI

      http://schema.org/streetAddress

    6. "postalCode"
      Name

      Postleitzahl

      Abdeckung

      Vorhanden bei ca. 21.000 Einträgen, fehlt bei ca. 900.

      URI

      http://schema.org/postalCode

    7. "address"
      Name

      Adresse

      Beschreibung

      Die Adresse der Einrichtung

      URI

      http://schema.org/address

    8. "location"
      Name

      Ort

      Beschreibung

      Im "location"-Objekt befinden sich Angaben zum Sitz der Institution: Anschrift, Öffnungszeiten und Geokoordinaten.

      Abdeckung

      Vorhanden bei knapp 21.000 Einträgen, fehlt bei ca. 1000 Einträgen.

      URL

      http://schema.org/location

    9. "containedIn"
      Name

      Geonames-Link (containedIn)

      Beschreibung

      Der Geonames-Identifier des Ortes, in dem sich die Einrichtung befindet.

      Abdeckung

      Vorhanden bei ca. 7700 Einträgen, fehlt bei ca. 14.200 Einträgen.

      Verwendungsbeispiele
      • Über Geonames lassen sich etwa die Bevölkerungszahlen der verlinkten Orte beziehen, wodurch Fragen beantwortet werden können, die sich mit den lobid-organisations-Daten alleine nicht beantworten lassen. Beispiel: Welche Museen gibt es in Orten mit weniger als 10.000 Einwohnern?
      URI

      http://schema.org/containedIn

    10. "name"
      Name

      Name der Einrichtung

      Beschreibung

      Der Name der Einrichtung.

      Abdeckung

      100%. Jeder Eintrag hat einen Namen.

      Verwendungsbeispiele
      URI

      http://schema.org/name

    11. "provides"
      Name

      Online-Service

      Beschreibung

      Link zu einem Online-Angebot der Institution.

      Abdeckung

      Vorhanden bei ca. 2000 Einträgen, fehlt bei ca. 20.000.

      Verwendungsbeispiele

      Zusammen mit dem Regional- oder Gemeindeschlüssel nach Online-Angeboten von nahe gelegenen Institutionen suchen und Kontakt zum Zweck des Informationsaustausches aufnehmen. Z.B. für Organisationen in Bonn.

      URI

      Inverse Property zu http://schema.org/provider.

    12. "id"
      Name

      Uniform Resource Identifier (URI)

      Beschreibung

      Der lobid-URI der Einrichtung. Entspricht der Beschreibungs-URL plus Hashbang ("#!").

      Abdeckung

      Jede verzeichnete Institution hat einen Identifier.

      Verwendungsbeispiele

      Dieser URI kann in anderen Kontexten zur Identifizierung der Einrichtung verwendet werden. Bei einer Konvertierung des JSON-LD nach RDF befindet er sich in Subjekt-Position.

      URI

      "id" ist auf das JSON-LD-Keyword "@id" gemappt, mit dem die URI der beschriebenen Resource angegeben wird. (Das, was im RDF in Subjektposition steht.)

    13. "url"
      Name

      URL

      Beschreibung

      Der Link zur Webseite der Einrichtung bzw. zur übergeordneten Einrichtung.

      Abdeckung

      Vorhanden bei ca. 6000 Einträgen, fehlt bei knapp 16.000 Einträgen.

      Verwendungsbeispiele
      URI

      http://schema.org/url

    14. "@context"
      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
    15. "alternateName"
      Name

      Sonstiger Name

      Beschreibung

      Sonstiger Name zur Bezeichnung der Institution.

      Abdeckung

      Vorkommen bei ca. 7000 Einträgen, fehlt bei etwa 15.000 Einträgen.

      Verwendungsbeispiele

      Sollte bei einer Namenssuche zusammen mit dem "name"-Feld abgefragt werden, z.B. http://lobid.org/organisations/search?q=name:theater+OR+alternateName:theater.

      URI

      http://schema.org/alternateName

    16. "rs"
      Name

      Regionalschlüssel

      Beschreibung

      Der Regionalschlüssel des Ortes, in dem sich die Organisation befindet. Siehe auch Wikipedia.

      Abdeckung

      Gilt nur für Organisationen in Deutschland. Fehlt derzeit bei gut 2000 Einträgen von Institutionen in Deutschland.

      Verwendungsbeispiele
      URI

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

    17. "linkedTo"
      Name

      Bibliotheksverbund

      Beschreibung

      Link zur Verbundzentrale eines deutschen Bibliotheksverbundes, an dem die Organisation teilnimmt.

      Abdeckung

      Diese Angabe ist nur relevant für Bibliotheken in Deutschland. Fehlt derzeit bei ca. 8500 Einträgen von Bibliotheken in Deutschland, vorhanden bei etwa 5000 Einträgen.

      Verwendungsbeispiele

      Liste von Bibliotheken im Gemeinsamen Bibliotheksverbund (GBV) (tbd).

      URI

      http://www.w3.org/ns/org#linkedTo

      Provenienz

      Information kommt aus Pica+-Feld 035I $c der Sigeldaten (siehe Adressenformat-Dokumentation und Morph-Datei).

    18. "telephone"
      Name

      Telefonnummer

      Beschreibung

      Eine Telefonnumer der Organisation.

      Abdeckung

      Dieses Feld kommt in ca. 6500 Einträgen vor und fehlt bei ca. 15.000 Einträgen.

      URI

      http://schema.org/telephone

      Provenienz

      Information stammt aus Pica+-Feld 035B $d-f der ISIL-Daten siehe ISIL-Format-Dokumentation.

    1. "telephone"
      Name

      Telephone number

      Description

      A telephone number of the organization.

      Coverage

      This field is used in approximately 6500 entries and is missing in 15000 entries.

      URI

      http://schema.org/telephone

      Provenance

      Pica+ field 035B $d-f of ISIL data, see ISIL format documentation.

    1. "componentList"
      Name

      Schlagwortfolge

      Beschreibung

      Beinhaltet eine Schlagwortfolge nach RSWK als geordneten Array.

      URI

      http://www.loc.gov/mads/rdf/v1#componentList

    2. "dateOfDeath"
      Name

      Sterbedatum

      Beschreibung

      Das Sterbedatum einer Person, die Thema der bibliographischen Ressource ist.

    3. "dateOfBirth"
      Name

      Geburtsdatum

      Beschreibung

      Das Geburtsdatum einer Person, die Thema der bibliographischen Ressource ist.

    4. "id"
      Name

      URI des übergeordneten Werks

      Beispiel

      Dieser Artikel ist in der Konferenzschrift "Kontinuität und Diskontinuität" enthalten.

    5. "containedIn"
      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. 600.000 Aufsätze haben einen Link zur übergeordneten Ressource.

      URI

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

    6. "role"
      Name

      Rolle

      Beschreibung

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

      Verwendungsbeispiele
      URI

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

    7. "@context"
      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
  2. Feb 2017
    1. 3. Suzanne Briet, Qu est-ce que la documentation? (Paris: Éditions documentaires industrielles et techniques, 1951), 7. English translation by R.E. Day, L. Martinet and H. G.B. Anghelescu, What is Documentation? (Lanham, MD: Scarecrow Press, 2006).

      Must read Briet

    1. language
      Name

      Sprache

      Beschreibung

      Enthält die URI beim Normvokabular der LoC sowie die deutschsprachige Benennung der Sprache, in der eine Ressource verfasst ist.

      Abdeckung

      Enthalten bei über 11 Millionen Einträgen, fehlt bei ca. 8,5 Millionen.

      Beispiel

      Alle 2016 in polnischer Sprache erschienen Werke.

      MAB-Felder

      Stammt aus dem MAB2-Feld 037.

    2. describedby
      Name

      Beschrieben durch

      Beschreibung

      Die Ressource wird durch einen Datensatz beschrieben, der ein Erstellungsdatum, Bearbeitungsdatum, eine URI und Benennung besitzt.

    3. @context
      Name

      JSON-LD-Kontext (@context)

      Beschreibung

      Das JSON-LD-Kontext-Dokument zu den lobid-resources-Daten. 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
  3. Dec 2016
    1. telephone
      Name

      Telefonnummer

      Beschreibung

      Eine Telefonnumer der Organisation.

      Abdeckung

      Dieses Feld kommt in ca. 6500 Einträgen vor fehlt bei ca. 15.400 Einträgen.

    2. ags
      Name

      Allgemeiner Gemeindeschlüssel

      Beschreibung

      Der Allgemeine Gemeindeschlüssel des Ortes, in dem sich die Organisation befindet.

      Abdeckung

      Gilt nur für Organisationen in Deutschland. Fehlt derzeit bei gut 3500 Einträgen von Insittutionen in Deutschland.

      Verwendungsbeispiele

      tbd

    3. subject
      Name

      Schlagwörter der Sammelschwerpunkte

      Beschreibung

      Beschreibung der Sammelschwerpunkte einer Einrichtung anhand nicht-kontrollierter Schlagwörter (Tags)

      Abdeckung

      Diese Feld kommt nur in ca. 2000 Einträgen vor und fehlt bei fast 20.000 Einträgen.

  4. Nov 2016
    1. Literature

      On what is this literature list based ? I would find a short explanation useful, that makes it transparent (Maybe as an "i" icon behind it). For example, if it's based on a PubMed search with keywords x,y,z I can be sure that I don't have to complement my literature search from here with a search on PubMed.

  5. Oct 2016
    1. stocksize
      Name

      Bestandsgröße

      Beschreibung

      Die ungefähre Größe des Bestands einer Bibliothek.

      Abdeckung

      Findet sich nur bei Bibliotheken. Unter diesen ist die Abdeckung sehr groß (> 98 %), lediglich bei ca. 250 Einträgen fehlt die Angabe.

      Verwendungsbeispiele

      tbd

  6. Sep 2016
    1. sameAs
      Name

      Same-As-Links

      Beschreibung

      Unter sameAs werden URIs der Einrichtung beim ISIL-Verzeichnis sowie bei DBPedia – wenn vorhanden – angegeben.

      Abdeckung

      tbd

      Verwendungsbeispiele
      • Über DBPedia kann man zusätzliche Informationen und Fotos zu einer Einrichtung bekommen.
    2. name_en
      Name

      Englische Bezeichnung

      Beschreibung

      Der Name der Einrichtung in Englisch.

      Abdeckung

      tbd

    3. dbsID
      Name

      DBS-ID

      Beschreibung

      Die ID der Einrichtung innerhalb der Deuschen Bibliotheksstatistik (DBS). (Die DBS stellt – neben dem ISIL-Verzeichnis – die Quelldaten für lobid-organisations bereit.)

      Abdeckung

      tbd

      Verwendungsbeispiele

      Start der variablen Auswetung der Bibliothek mit der URL https://www.bibliotheksstatistik.de/vaJahr?dbsid=$dbsID, hier: https://www.bibliotheksstatistik.de/vaJahr?dbsid=BJ038

    4. email
      Name

      E-Mail-Adresse

      Beschreibung

      Eine E-Mail-Adresse der Einrichtung im mailto:-Format.

      Abdeckung

      tbd

    5. fundertype
      Name

      Unterhaltsträger

      Beschreibung

      Der Unterhaltsträger der Einrichtung.

      Abdeckung

      Vorhanden bei ca. 14.000 Einträgen, fehlt bei ca. 7.700

      Verwendungsbeispiele
    6. isil
      Name

      ISIL

      Beschreibung

      Der ISIL (International Standard Identifier for Libraries and Related Organizations) der Einrichtung. Das deutschsprachige ISIL-Verzeichnis ist – neben der Deutschen Bibliotheksstatistik (DBS) – die Datenquelle von lobid-organisations.

      Abdeckung

      Alle Einträge aus dem ISIL-Verzeichnis haben einen ISIL.

      Verwendungsbeispiele

      In der bibliothekarischen Arbeit begegnet man desöfteren ISILs. Mit einem lobid-organisations-Lookup kann einfach und zügig die dadurch identifizierte Institution gefunden werden.

    7. id
      Name

      Uniform Resource Identifier (URI)

      Beschreibung

      Der lobid-URI der Einrichtung. Entspricht der Beschreibungs-URL plus Hashbang ("#!").

      Abdeckung

      Jede verzeichnete Institution hat einen Identifier.

      Verwendungsbeispiele

      Dieser URI kann in anderen Kontexten zur Identifizierung der Einrichtung verwendet werden. Bei einer Konvertierung des JSON-LD nach RDF befindet er sich in Subjekt-Position.

    8. wikipedia
      Name

      Wikipedia-Link

      Beschreibung

      Link zum Wikipedia-Eintrag der Einrichtung

      Abdeckung

      tbd

      Verwendungsbeispiele

      tbd

    9. isPrimaryTopicOf
      Name

      ISIL-Verzeichnis-Link

      Beschreibung

      Link zum Eintrag im deutschsprachigen ISIL-Verzeichnis, das – neben der Deutschen Bibliotheksstatistik (DBS) – die Datenquelle von lobid-organisations darstellt.

      Abdeckung

      tbd

      Verwendungsbeispiele

      Dient in erster Linie Debugging-Zwecken.

    10. lon
      Name

      Geographische Länge

    11. lat
      Name

      Geographische Breite

    12. geo
      Name

      Geokoordinaten

      Beschreibung

      Dieses JSON-Objekt beinhaltet die Angaben zur Geoposition der Einrichtung nach WGS 84.

      Abdeckung

      tbd

      Verwendungsbeispiele
      • Abfrage von Einrichtungen in einem bestimmten Polygon.
    13. comment
      Name

      Anmerkung zu den Öffnungszeiten

      Beschreibung

      In diesem Feld finden sich ergänzende oder präzisierende Angaben zu den Öffnungszeiten.

      Abdeckung

      tbd

    14. description
      Name

      Öffnungszeiten

      Beschreibung

      Angaben zu den Öffnungszeiten der Einrichtung

      Abdeckung

      tbd

      Verwendungsbeispiele

      Da das Feld nicht standardisiert ausgefüllt ist, eignet es sich eher für die menschenlesbare Anzeige innerhalb eines Web-Angebots als für die maschinelle Auswertung. Es kann also leider nicht dafür genutzt weden um eine Suche einzugrenzen auf Institutionen die zu einem bestimmten Zeitpunkt geöffnet haben.

    15. openingHoursSpecification
      Name

      Öffnungszeiten

      Beschreibung

      Das Öffnungszeiten-Objekt enthält unstrukturierte Angaben zu den Öffnungszeiten der Einrichtungen bzw. ihrer verschiedenen Angebote.

      Abdeckung

      tbd

    16. addressCountry
      Name

      Land

      Beschreibung

      Das Land, in dem sich der Sitz der Institution befindet.

      Abdeckung

      tbd

      Verwendungsbeispiele
    17. addressLocality
      Name

      Ortsname

      Beschreibung

      Der Name des Ortes, in dem die Institution ihren Sitz hat.

      Abdeckung

      tbd

      Verwendungsbeispiele
    18. streetAddress
      Name

      Straße und Hausnummer

      Abdeckung

      tbd

    19. postalCode
      Name

      Postleitzahl

      Abdeckung

      tbd

    20. address
      Name

      Adresse

      Beschreibung

      Die Adresse der Einrichtung

    21. location
      Name

      Ort

      Beschreibung

      Im "location"-Objekt befinden sich Angaben zum Sitz der Institution: Anschrift, Öffnungszeiten und Geokoordinaten.

      Abdeckung

      Vorhanden bei knapp 21.000 Einträgen, fehlt bei ca. 1000 Einträgen.

    22. containedIn
      Name

      Geonames-Link

      Beschreibung

      Der Geonames-Identifier des Ortes, in dem sich die Einrichtung befindet.

      Abdeckung

      tbd

      Verwendungsbeispiele
      • Über Geonames lassen sich etwa die Bevölkerungszahlen der verlinkten Orte beziehen, wodurch Fragen beantwortet werden können, die sich mit den lobid-organisations-Daten alleine nicht beantworten lassen. Beispiel: Welche Museen gibt es in Orten mit weniger als 10.000 Einwohnern?
    23. name
      Name

      Name der Einrichtung

      Beschreibung

      Der Name der Einrichtung.

      Abdeckung

      100%. Jeder Eintrag hat einen Namen.

      Verwendungsbeispiele
    24. provides
      Name

      Online-Service

      Beschreibung

      Link zu einem Online-Angebot der Institution.

      Abdeckung

      Vorhanden bei ca 2000 Einträgen, fehlt bei ca. 20.000.

      Verwendungsbeispiele

      tbd

    25. url
      Name

      URL

      Beschreibung

      Der Link zur Webseite der Einrichtung bzw. zur übergeordneten Einrichtung.

      Abdeckung

      Vorhanden bei ca. 6000 Einträgen, fehlt bei knapp 16.000 Einträgen.

      Verwendungsbeispiele
    26. @context
      Name

      JSON-LD-Kontext (@context)

      Beschreibung

      Das JSON-LD-Kontext-Dokument zu den lobid-organisations-Daten. 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
    27. classification
      Name

      Detaillierter Einrichtungstyp

      Beschreibung

      Diese Klassifikation liefert eine granulare Unterscheidung verschiedener Einrichtungstypen.

      Abdeckung

      Zu jeder Institution wird der detaillierte Typ angegeben.

      Verwendungsbeispiele

      ...

    28. type
      Name

      Grober Organisationstyp

      Beschreibung

      Art der Einrichtung. Vergebene Typen sind: Bibliothek (Library), Archiv (Archive), Museum (Museum), Verlag (Publisher), sonstige Organisationen (Organization).

      Abdeckung

      Jeder Eintrag ist einem Einrichtungstyp zugeordnet.

      Verwendungsbeispiele
      Provenienz

      Für Einträge aus der DBS wird automatisch der Typ "Library" vergeben. bei den Einträgen aus dem Sigelverzeichnis wird der Typ auf Basis der detaillierten Organisationsklassifikation verwendet, siehe das Mapping der Notationen auf einen Typ.

    29. alternateName
      Name

      Sonstiger Name

      Beschreibung

      Sonstiger Name zur Bezeichnung der Institution.

      Abdeckung

      Vorkommen bei ca. 700 Einträgen, fehlt bei etwa 15.000 Einträgen.

      Verwendungsbeispiele

      Sollte bei einer Namenssuche zusammen mit dem "name"-Feld abgefragt werden, z.B. http://lobid.org/organisations/search?q=name:theater+OR+alternateName:theater.

    30. rs
      Name

      Regionalschlüssel

      Beschreibung

      Der Regionalschlüssel des Ortes, in dem sich die Organisation befindet. Siehe auch Wikipedia.

      Abdeckung

      Gilt nur für Organisationen in Deutschland. Fehlt derzeit bei gut 2000 Einträgen von Insittutionen in Deutschland.

      Verwendungsbeispiele
  7. Mar 2016
    1. QUESTIONS TO BE ANSWERED!

      Answering yet more questions on this page will turn it into a knowledge base which suffers from scrolling. It may be worth considering work on a nicely formatted user manual. Great examples here are Ceph and typesets with the Digital Publishing Toolkit.

  8. Jan 2016
    1. ipfs cat /ipfs/QmW2WQi7j6c7UgJTarActp7tDNikE4B2qXtFCfLPdsgaTQ/cat.jpg >cat.jpg

      Same with this one. Dropping the /ipfs/ fixed it.

    2. hash=`echo "I <3 IPFS -$(whoami)" | ipfs add -q`

      Also, this gives me an error from ipfs add:

      $ hash=`echo "I <3 IPFS -$(whoami)" | ipfs add -q`
      Error: Argument 'path' is required
      
      Use 'ipfs add --help' for information about this command
      
  9. Dec 2015
  10. Sep 2015
    1. The full range of possibilities here is still in need of documentation and we would appreciate any help to improve that.

      This could be done with a JSDoc interface description or my preferred way is to write a TypeScript definition file.

  11. Jun 2015
    1. With the exception of app, the properties for the options object are the names of Annotator plugins and their values are the options passed to the individual plugin constructors.

      We should list many of them here and show some examples. Some of the web developers integrating Hypothesis will be very lost unless they have copy/paste examples that they can refer to.

    2. By default, Hypothesis instantiates the Annotator.Host class defined in the injected code loaded by embed.js. It is possible to change this by assigning an alternate constructor to window.hypothesisRole.

      It would be great to see a more flushed out example of how this can be used to annotate iframes... there are a number of projects trying to do such things, and in general it would be great to see expanded examples of what can be done with customized embedding.

  12. Jan 2014
    1. I regret that the documentation does not focus on what is most relevant; by focusing on a largely irrelevant implementation detail, we enlarge the importance of that implementation detail and obscure the importance of what makes a value type semantically useful. I dearly wish that all those articles explaining what “the stack” is would instead spend time explaining what exactly “copied by value” means and how misunderstanding or misusing “copy by value” can cause bugs.

      Documentation should focus on semantically useful descriptions; another accompanying document (or annotation) can provide relevant implementation details upon request, but that deeper level of detail should be left out by default to avoid enlarging the importance of less relevant things.

  13. Sep 2013