498 Matching Annotations
  1. Last 7 days
    1. Navigate to Settings, then click Security. Click SMS Configuration. Enter the client ID, client secret and base URL and click Save. Learn more. Click Check SMS Connection to verify the connection.
    2. verify you were directed to the Oracle Cloud Classic console
    3. https://www.oracle.com/cloud/sign-in.html.
    4. CXMARKETINGAUTO_<AccountName>
    5. You must retrieve the following Oracle Identity parameters from Oracle Identity Cloud Service (IDCS):  Client ID Client secret Base URL This must be completed by your Oracle Cloud Account administrator or service administrator.
    6. Before you can use the SMS channel and begin sending SMS messages, you must configure the OAuth connection.
    1. Unlike other default asset permissions, SMS code permissions can only be setup for security groups, not individual users. SMS codes are not created by users and aren't an asset type you can manage with Asset Creation controls for the security group. You can only setup default SMS code permissions for the security group at a time. You cannot grant individual users default SMS code permissions. The permissions are for the security group.
    1. In Oracle Eloqua, contacts are created by email address and email addresses are expected to be unique. Therefore, a single phone number may be associated to multiple contacts if someone is in Oracle Eloqua under two separate emails but has only given one phone number. In this case, if that phone number is opted in, then phone opt in appears against both contacts.
    2. By default, all your contacts become subscribed to SMS when the SMS feature is turned on for your instance.

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

    1. The SMS Message Designer provides an easy-to-use interface to build your message content and easily add features like field merges, hyperlinks, and keywords. An SMS keyword is a word or phrase that your subscribers can text to an SMS code to interact with your SMS campaign. A code and keyword combination cannot be activated simultaneously on multiple campaigns.
    1. Oracle Eloqua can only send SMS messages to valid contact Business Phone or Mobile Phone numbers. You are responsible for maintaining valid phone numbers in your contact database. Phone numbers must be in International or e.164 format. You can enable phone number validation to prevent invalid numbers from being saved in your database.
    1. This can't be changed later, so validate your choice carefully. Ensure that the delegated branded Short URL domain is unique. It can't be shared across more than one brand in the same instance or across more than one Oracle Eloqua instances.
    2. This branding is different from any branding you have otherwise set up in Eloqua.
    1. Invalid keyword responses do count towards sent message volume.
    2. For SMS messages, an invalid keyword response message can be sent to originating mobile numbers if the incoming message contains an invalid keyword or a keyword that is inactive or is not defined for the code.
    3. Each code can only have one invalid keyword response message.
    4. Setting up invalid keyword responses is not mandatory, but it's considered good practice.
    1. Some keywords are mandatory in some countries
    2. Custom and Help types do not perform any system action and can be used for pure marketing orchestration setup. Custom keyword allows you to interact with your customer base via SMS content, while the Help keyword offers an intuitive way for the customer to receive assistance or clarification.
    3. Oracle Eloqua supports the following types of keywords: Opt-Out: Automatically opts out a mobile number. Opt-In: Automatically opts in a mobile number. Help: Does not automatically perform any action. Custom: Does not automatically perform any action.
  2. May 2024
    1. "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

    2. "describedBy"
      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 in 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

    3. "numbering"
      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

    4. "supplement"
      Name

      Beilagen

      Beschreibung

      Enthält URIs von Beilagen zur Ressource.

      MAB-Felder

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

      URI

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

    5. "frequency"
      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

    6. "endDate"
      Name

      Erscheinungsende

      Beschreibung

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

      Vorkommen

      Über 1.400.000 Einträge besitzen ein Datum zum Erscheinungsende.

      MARC-Felder

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

      URI

      http://schema.org/endDate

    7. zdbId
      Name

      ZDB-ID

      Beschreibung

      Enthält die ZDB-ID.

      Abdeckung

      Enthalten bei ca. 2,2 Mio. Einträgen. Bei ca. 2,1Mio., enthalten, fehlt bei ca. 548.000 (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

    8. "issn"
      Name

      ISSN

      Beschreibung

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

      Abdeckung

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

      Beispiel

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

      MAB-Felder

      Stammt aus dem MARC-Feld 022.

      URI

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

    9. "bibliographicCitation"
      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

    10. "responsibilityStatement"
      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.

      Provenienz

      MARC-Feld 245 $c

      URI

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

    11. "type"
      Name

      Klasse

      Beschreibung

      Enthält den Publikationstyp. Darüber hinaus hat jede lobid-Ressource den Typ BibliographicResource (=bibliographische Ressource).

      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.

    12. "medium"
      Name

      Medientyp

      Beschreibung

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

      Verwendungsbeispiel

      Audio-Werke in französischer Sprache.

      Provenienz

      MARC Felder Leader+008, 006, 007, 245 $h, 300 $a, 337 $a, 338 $b, 340, 546, 655 $a

      URI

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

    13. "subject"
      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.

    14. "natureOfContent"
      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

    15. "extent"
      Name

      Umfang

      Beschreibung

      Gelieferte Umfangsangabe.

      Abdeckung

      -- nicht indexiert --

      Provenienz

      Kombiniert aus den Unterfeldern von MARC-Feld 300

      URI

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

    16. "language"
      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.

      Provenienz

      Stammt aus dem MARC 008 Pos 35-37 und 041 $a $d $j

      URI

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

    17. "description"
      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 --

      Provenienz

      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

    18. "tableOfContents"
      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

    19. "sameAs"
      Name

      Identisch mit

      Beschreibung

      Enthält URIs von anderen Ressourcne, 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

    20. "sourceOrganization"
      Name

      Urheber des Datensatzes

      Beschreibung

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

      Provenienz

      MARC-Feld 040 $a

      URI

      http://schema.org/sourceOrganization

    21. "modifiedBy"
      Name

      Modifizierende Institution

      Beschreibung

      Enthält die URI der Institution, die als letztes eine Modifikation des Eintrags vorgenommen hat.

      Provenienz

      MARC-Feld 040 $d

      URI

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

    22. "publishedBy"
      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..

      Provenienz

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

      URI

      http://schema.org/publishedBy

    23. "location"
      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,7 Mio..

      Provenienz

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

      URI

      http://schema.org/location

    24. "startDate"
      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

    25. "otherTitleInformation"
      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

    26. "title"
      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

    27. "hbzId"
      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.

      Provenienz

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

      URI

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

    28. "almaMmsId"
      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%

      Provenienz

      MARC Feld 001

      URI

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

    29. "isbn"
      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.

      Provenienz

      MARC Feld 020 $a

      URI

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

    30. dateModified
      Name

      Bearbeitungsdatum

      Beschreibung

      Enthält das Datum, an dem das Katalogisat zum letzten Mal bearbeitet wurde im Format jjjjmmtt (entspricht dem ALMA-MARC spezifisches Feld MNG $d).

    31. dateCreated
      Name

      Erstellungsdatum

      Beschreibung

      Enthält das Datum an dem die Ressource erfasst wurde oder durch Fremddatenübernahme in den Katalog kam im Format jjjj-mm-tt (entspricht dem ALMA-MARC spezifisches Feld MNG $b).

    32. "hasItem"
      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.

      Provenienz

      hbz ALMA spezifische MARC Felder: ITM, HOL, H52, POR

      URI

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

    33. "edition"
      Name

      Auflage

      Beschreibung

      Unstrukturierte Angaben über die Auflage des Werks.

      Abdeckung

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

      Provenienz

      Stammt aus den MARC-Feld 240 $a.

      URI

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

    34. "dateCreated"
      Name

      Erstellungsdatum

      Beschreibung

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

      Verwendungsbeispiele
      Abdeckung

      Alle Resourcen haben ein Erstellungsdatum.

      Provenienz

      ALMA-MARC spezifisches Feld MNG $b

      URI

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

    35. "dateModified"
      Name

      Bearbeitungsdatum

      Beschreibung

      Enthält das Datum, an dem das Katalogisat zum letzten Mal 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
      Provenienz

      ALMA-MARC spezifisches Feld MGN $d

      URI

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

    36. "altLabel"
      Name

      Alternativer Name / Bezeichnung

      Beschreibung

      Enthält Namensvarianten der Person oder Institution. 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

      URI

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

    37. contribution
      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

      Provenienz

      MARC-Felder 100,110,111, 700, 710, 711.

      URI

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

    38. "contribution"
      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

      Provenienz

      MARC-Felder 100,110,111, 700, 710, 711.

      URI

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

  3. Apr 2024
  4. Feb 2024
    1. even though Hash.ruby2_keywords_hash?(args.last) returns true. 🤯 And this statement (from #366): # If the last argument is Hash, Ruby will treat only symbol keys as keyword arguments # the rest will be grouped in another Hash and passed as positional argument. doesn't seem to be correct, at least in Ruby 3.0.
  5. Jan 2024
    1. Document what to build and how designs should behave in a central, searchable, collaborative place for the entire product team.
  6. Dec 2023
  7. Nov 2023
  8. Oct 2023
  9. Sep 2023
    1. 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!

  10. Aug 2023
    1. If there’s only an asterisk: Click the style name, then move the pointer over the style name in the Paragraph Styles pop-up menu. Click the arrow that appears, then choose Redefine from Selection.

      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.

  11. Jul 2023
    1. Tell future-you why you did that thing; they can read but don't know what you intended. Oral tradition is like never writing state to disk; flush those buffers.
  12. Jun 2023
    1. A documentation-first culture does not mean everyone is busy writing documents all day. It means that everyone appreciates the value of documenting and sharing their experiences.

      Documentation-first culture

    2. I’m a big fan of documentation. I think it’s my favorite boring thing to do after coding. It brings the business so much long-term value that every hour invested into documentation by anyone saves literally x100 productivity hours across the company.

      High five :)!

  13. May 2023
    1. Available as a monolithic file, by chapters, and in PDF — git repository.

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

      Very reminiscent of the old CoffeeScript docs, to me.

  14. Apr 2023
    1. Raindrop also has an excellent browser extension that allows you to save a webpage to any of your link collections, tag it, mark it as a favorite, access highlights, set reminders, and even save multiple tabs simultaneously.

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

  15. Mar 2023
  16. Jan 2023
  17. Nov 2022
    1. It would probably be worth mentioning this explicitly in the README: "Configuration of the language server happens over the LSP protocol by passing a configuration object; your LSP client should have a way of setting the configuration object for a server. Here is a link to the spec for the configuration that is supported [...]"
    1. 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!

    1. It is handy to manually generate the diagram from times to times using the previously created command: npm run db:diagram:generate. Though, getting the diagram to update itself on its own automatically without a developer interaction would ensure that it the diagram is never obsolete. There are several ways of doing this.You could use a pre-commit git hook or even better simply configure your CI/CD pipeline(s) to run the npm script whenever something gets merged into the main branch 🙂
    2. When it comes to showing up somewhere in your documentation a diagram describing your SQL database, you often end up with a recurring problem : after a few days / weeks / months, the diagram you made became obsolete.
    1. 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?

    2. 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.

    1. the functional core, imperative shell pattern

      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

    2. For new code, it’s usually a good idea to design the code so that it’s easy to test with “real” objects, rather than stubs or mocks.
    3. We keep our functional tests separate from our unit tests, in the tests/functional directory. Because these are slow to run, we will usually write one or two functional tests to check a new feature works in the common case, and unit tests for all the other cases.

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

    4. To run the backend test suite only call tox directly

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

  18. Oct 2022
    1. Impact Object – The Impact Object collision data will be sent to. If empty, it will attempt to find an Impact Object on the collider that was hit or one of its parents.

      ? 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?

    2. Impact Triggers are components that tell Impact Objects when to play interactions and with what data. They are the origin that provides the data which is sent to the object’s Impact Material to ultimately play the interactions defined on the material.

      -~

    1. Impact Object Rigidbody uses FixedUpdate to ensure accurate interactions, especially when sliding and rolling. However, this can cause overhead if there are a lot of objects.

      ^ It seems that FixedUpdate is prone to causing overhead

    2. Any Impact Triggers must be on the root of the object (the same object as the Rigidbody), and should have their Impact Object field empty. Impact Triggers must be on the same component as the Rigidbody,

      ? 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

    3. Impact Object Single Material is the simplest type of Impact Object, with a single material used for the object. It is most suited for static objects and level geometry. You can add this script to your objects by going to

      ? what are static objects and level geometry?

    4. Priority can be used to ensure that certain objects will always play their interactions, even if it requires "stealing" resources that are already in use.

      ~?

    5. Impact Objects are components that you attach to the objects in your game’s world to specify their material, so that other objects (and other parts of your game) know how to interact with them. Impact Objects can also provide physics data such as rigidbody velocity.

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

    1. The Audio Source Template prefab must have an Impact Audio Source component attached to it.

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

    2. Pool Size – The size of the object pool created for this audio source.

      ? What is an object pool?

    1. Impact Materials define what interactions will occur when an object interacts with the tags defined in the Impact Tag Library

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

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

    1. The size of this buffer limits the number of interaction results that can be returned by a single interaction, so make sure this is set appropriately for how many interaction results your materials can return.

      ~? 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?

    2. This is a hard limit that will be checked as soon as a collision message is recieved. If the limit has been reached for that fixed update frame, processing will be aborted immediately. Typically you would want to set this to be about the same size as your object pools. Triggers can be set as High Priority to ignore this limit.

      ? 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?

    3. Material Mapping works best for static, single material objects. Without an Impact Object component attached, no material composition or velocity data can be obtained

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

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

    4. Material Mapping allows you to map Unity's Physics Materials to Impact Materials. This is useful so that you don't necessarily have to add an Impact Object component to all of the objects in your scene.

      -~ 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

    5. For example, if you have a terrain you will probably want to set this to the number of textures your terrain uses.

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

    1. The first field is an Impact Tag Library which is used to display a user-friendly dropdown for the tag or tag mask. The second field represents the actual value of the tag or tag Mask

    2. Just remember that under the hood tags are represented only by integers, so using multiple tag libraries with different tag names does not mean you can have more than 32 tags.

      Tags

  19. Sep 2022
    1. That’s why it was such a life-changing event for me when I found Dash in 2012.

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

    1. To be fair, for a $30 asset I don't really expect that much support, but the problem here is that because of the lack of docs and hard to parse and modify codebase, folks are way more dependent on the developer than for other assets with proper docs, field tooltips, and maintainable code.
  20. Aug 2022
    1. Diagramming and documentation costs precious developer time and gets outdated quickly. But not having diagrams or docs ruins productivity and hurts organizational learning. Mermaid addresses this problem by enabling users to create easily modifiable diagrams, it can also be made part of production scripts (and other pieces of code).
    1. Thus my docs recommendation of public function beforeFilter(Event $event) // do not render out the now inconsistent one for is(json) if (!$this->request->is('jsonapi')) { throw new NotFoundException('Invalid access, use application/vnd.api+json for Content-Type and Accept.'); } } to specifically only whitelist the desired jsonapi for the general use case.
  21. Jul 2022
    1. // 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.

      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.)

  22. Jun 2022
    1. No additional considerations for iOS, macOS, or tvOS.

      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!

    1. Good documentation includes background and decision information that cannot be derived from the code.
  23. Apr 2022
  24. Mar 2022
    1. I wish education was based around this principle.

      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.

  25. Feb 2022
    1. Don’t be the project people leave. Be the project people turn to.

      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.

  26. Jan 2022
  27. Dec 2021
  28. Nov 2021
    1. In addition to the daily limits, there are follow ratios that go into effect once you’re following a certain number of accounts:Every Twitter account can follow up to 5,000 accounts. Once you reach that number, you may need to wait until your account has more followers before you can follow additional accounts. This number is different for each account and is automatically calculated based on your unique ratio of followers to following.

      Hello. I am a paying subscriber, now, after all these years… I may or may not have become a paying subscriber just to justify this particular feedback after all this time.

      Ultimately, though, I’m giving you a real substantial bullet point to put on that very wispy-looking full features list of Twitter Blue!

  29. Sep 2021
    1. Around 1:48:00

      What if every library that you use had, like, some interactive documentation or interactive representation? [...] The author could maybe add annotations.

  30. Aug 2021
  31. Jul 2021
    1. I have made some discoveries in London about my uncle Herncastle and his Diamond, which have rather an ugly look to my eyes; and I want you to confirm them.

      Evidence of what Mr Franklin about information about the story.

    2. This prefatory narrative I have already got by me in the form of an old family paper, which relates the necessary particulars on the authority of an eye-witness

      State the evidentiary insistence.

  32. Jun 2021
    1. Most of the matchers provided by this gem are useful in a Rails context, and as such, can be used for different parts of a Rails app: database models backed by ActiveRecord non-database models, form objects, etc. backed by ActiveModel controllers routes (RSpec only) Rails-specific features like delegate
    1. So that was our rainbow child, Eli, and that's when I started going downhill, because my stuff got denied. I didn't have the privileges that every normal US citizen gets to have. So I had two kids, no way to provide for them.

      Time in US - employment - documentation

    2. No, they haven't reached an agreement, but it's this new dream. If you had known that all you had to do was keep going to school and you could get a social security card and you could have a path to citizenship, would that have made a difference, do you think?

      DACA - Eligibility

    3. We didn't have papers. On top of that, we're not from there. So we don't have papers. Not papers, but you know how you have to get the medical shots. We had to redo all of that stuff. So my mom got the shots, did all the immunization records and all that stuff.

      Time in US - immigration status - being secretive - in the shadows - healthcare

    4. I noticed all my friends getting jobs and having new shoes and this and that. And I would ask him like, "What are you doing?" And he was like, "I just got a job. I got a car. I got this."Mike: I could see them--that they were advancing in life, and I was still in the same spot. So I asked my mom if I could get a job, and that's when she broke it down to me that I wasn't even from here. And that was right there like a slap in the face.

      Time in the US, Jobs/ Employment/ Work, Documents

    1. Luisa: I was set to go into a good future. That's what it was, but when it came down to it, my mom was like, "No. You know what? You can't. You don't have papers. You can't continue your education here. We cannot afford to pay your entire tuition. We cannot afford to pay for your housing or your books. Each book, that's like $5000 for books. We can't do that. I'm sorry."

      Time in the US, Higher Education, Paying For

    2. The first time was when I wanted to apply to Whitney Young—when I wanted to go to a different high school. I had the grades for it [Chuckles]. I've always had the grades for it, but they were asking … I don't remember what kind of document they were asking for that scared me into not applying, and I was like, "You know what? Let’s not. I don't want to. It's not worth it if I get deported. I don't need to be—it's not necessary." So I went to my local high school, which … not the best high school, Washington High School, but they had the IB program.

      Time in the US, School, High School

    3. Yes. There came a point. We were in the [Pause] process of getting our permanent residency card in order to be able to go to school, and the lawyer let my mother know that me and my sister—my other sister—were not going to make it because once you hit eighteen, you're no longer under the case that you originally filed, so the best option for us would be adoption. We would be adopted by an American citizen in order to get our American status fixed, and that was something my mom and I contemplated for a long, long time, and she was going to go through with it, but my dad put a huge stop to that and was like, "That's not happening. You're stupid. That's not a thing. These are my kids. You're not letting that happen."

      Eligibility - permanent residency - adoption

    1. A cookie is associated with a domain. If this domain is the same as the domain of the page you are on, the cookie is called a first-party cookie. If the domain is different, it is a third-party cookie. While the server hosting a web page sets first-party cookies, the page may contain images or other components stored on servers in other domains (for example, ad banners), which may set third-party cookies. These are mainly used for advertising and tracking across the web.
  33. Apr 2021
    1. I'm maintaining one that can be run and asserted on: https://github.com/cirosantilli/rails-cheat/blob/master/app/test/integration/capybara_test.rb
  34. Mar 2021
    1. The urgent argument for turning any company into a software company is the growing availability of data, both inside and outside the enterprise. Specifically, the implications of so-called “big data”—the aggregation and analysis of massive data sets, especially mobile

      Every company is described by a set of data, financial and other operational metrics, next to message exchange and paper documents. What else we find that contributes to the simulacrum of an economic narrative will undeniably be constrained by the constitutive forces of its source data.

    1. Third configurable block to run.

      I like how they identify in the description which order things run in: 1st, 2nd, 3rd, and last.

      Though, it would be more readable to have a list of them, in chronological order, rather than having them listed in alphabetical order.

    1. demonstrate

      I’ve continued to discover new features in Tweetbot for the first time, believe it or not. See this Tweet.

    2. Page Note Test Not quite sure why I haven't tried Page Notes yet but...

    1. Advanced features like tracing, input/output filters or type checking leverage the framework argument flow_options
  35. Feb 2021
    1. 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

    2. We try to keep the “information architecture” - a word I wouldn’t have learned without the inspiring Alex Coles - as simple as possible: so far, we got a handful of pages accessible through the top navigation, and then the documentation behind the DOCS link. Here, the right sidebar helps you to navigate within the chapter.
    1. Use the desc option to provide human-readable descriptions of filters. You should prefer these to comments because they can be used to generate documentation.
    1. NIX_PATHA colon-separated list of directories used to look up Nix expressions enclosed in angle brackets (i.e., <path>). For instance, the value

      It would be helpful to

      1. formally describe the formats for NIXPATH, and
      2. note the allowed angle bracket syntax accordingly

      <path> will work with the prefixless format, but not with the prefixed one, and it may be helpful to spell this out explicitly.

      0 [14:16:19] nix repl
      Welcome to Nix version 2.3.10. Type :? for help.
      
      nix-repl> :l <nixpkgs/doc>  
      Added 40 variables.
      
      nix-repl> :l <doc>
      error: file 'doc' was not found in the Nix search path (add it using $NIX_PATH or -I)
      

      I always saw a NIXPATH used with the prefix syntax so far:

      $ echo $NIX_PATH
      nixpkgs=/nix/var/nix/profiles/per-user/root/channels/nixos:nixos-config=/etc/nixos/configuration.nix:/nix/var/nix/profiles/per-user/root
      

      but NIX_PATH documentation shows that the prefixless format is also valid.

      $ export NIX_PATH=/home/toraritte:/nix/var/nix/profiles/per-user/root/channels/nixos
      
      $ printenv NIX_PATH
      /home/toraritte:/nix/var/nix/profiles/per-user/root/channels/nixos
      
      $ nix repl
      Welcome to Nix version 2.3.10. Type :? for help.
      
      nix-repl> :l <nixpkgs>
      Added 12439 variables.