Issues manually importing annotations #26

(This is a niche issue; please do prioritise other work where you see fit!)

I'm looking to import highlights I've been storing on my own site to Seams' lexicon (as a starter for building other importers).

Context: I manually created an annotation in PDSls (from annotations from my site), but it hasn't shown up in the stream on https://seams.so, or in my annotations sidebar on the relevant page.

• I couldn't find the lexicon schema (community.lexicon.annotation.annotation#textQuoteSelector and community.lexicon.annotation.annotation#textPositionSelector would have been particularly useful!)
  • I checked the PRs but couldn't seem these there either
• I didn't know how to count characters/bytes for the start/end of textPositionSelector, so omitted that chunk
  • This may be why my annotation hasn't shown up
• I guessed at what textQuoteSelector needed (the 32 bytes before and after the exact string?)
  • I presume it's UTF-8 byte count?
  • I don't know how HTML is converted to text for the purposes of counting bytes (same as above), eg. are bullet points counted as \n- "three", or just \n "one"?
• I used the timestamp of my original annotation (just over a year ago)
  • This is almost certainly why my annotation isn't showing up — if you're not indexing "unreasonably non-realtime" annotations!

I ask about these, as I'd love to make an importer for my own stuff, and possibly for other platforms — so understanding these will be crucial! I'd love to hear about where my assumptions aren't helpful 😊