westurner / opengov Goto Github PK

https://spherestandards.org/handbook/ :

Access the [Sphere] Handbook

• Read online and submit a comment
  Browse

• https://handbook.spherestandards.org/

• Download as a PDF

https://spherestandards.org/wp-content/uploads/Sphere-Handbook-2018-EN.pdf

Check all existing language editions

• Buy a print copy
• Order from one of our distributors
• Access via mobile application

• iOSApp: https://itunes.apple.com/us/app/humanitarian-standards-partnership-app/id1270402872
• Android app: https://play.google.com/store/apps/details?id=com.HSP.HSPApp

• Preserve (apple,) tree varieties & local orchards
• saplings can be mailed in a bag in a box with damp paper around the roots

User Stories

STORY1: Users can search for a document by {title, identifier, file hash, [...]} and find the latest version (1) in a format that works with their device; (2) with metadata that their device recognizes.

Use Cases / Exercises / Opportunities / Competencies

Find the latest version of a document / book

• Example: DSCA Handbook
• Search for "DSCA Handbook"
• Search for file_hash(document_in_my_Download_folder):
• Which is the latest version of this document?
• Can I read this on my phone?
• Can I read this on my tablet?
• Can I read this on my eBook reader?
• What are the differences between this latest version and what I have/had?
  • How do I diff these?
• Is this the authentic copy?
  • Verify the digital signature and/or the file hash

Sync a PDF larger than 25MB to an eBook reader

• Example: https://www.marines.mil/portals/1/Publications/MCRP%208-10B.6.pdf (36 MB (as of Oct 2020))
• Attempt to email (attachment size limit)
• Attempt to transfer using mobile device share featue
• Attempt to download to ~/Downloads and then organize
• Load into an eBook manager (e.g. Calibre)
  • Import file
  • Manually update metatadata; normalize titles and authors
• Synchronize with mobile device (e.g. [Kindle, [...] eBook reader)
  • Is format conversion necessary?
  • PDF does not re-flow for smaller-screen devices (which are far more likely to be available and charged particularly in emergency situations)
• What title and author appear in the device library?

Skip to a heading / timecode

• Examples:
• Open the resource in the viewing / reviewing application
• Find the table of contents (TOC)
• Attempt to click on a TOC entry in order to skip to a heading
• (In a PDF) scroll until you find the correct page number
• Time how long it takes to skip to a heading
• Attempt to share a link to a page number
• Attempt to share a link to a heading

Reference a document without internet access

• Turn on "Airplane Mode" on your device
• Access the document
  • Is it available through a {shared drive, file-type specific, general use} app that syncs so that it's available offline?

Send feedback

• Examples:
• Open a document
• Find the contact information for the authors
• How do you suggest changes?
  • Locate the source document (that the PDF is generated from)
  • Send your copy with modifications
    • Email attachment
    • Real-time collaborative editor
    • (Git) Pull Request
  • Exchange feedback about the feedback
    • Email forwards and replies
    • Comments in a real-time collaborative editor
    • Pull Request Review comments
  • When or if the author accepts the changes,
    do they sign the updated version and publish a new release?
    • How can people subscribe in order to receive notifications about new releases of a {document,}?
      • List of email addresses to CC regarding the new document
      • Selective manual changelog heading
      • Version history in collaborative editor, git
      • Click Watch on the git repo and get notifications for all changes, all issues, or just new releases

Data Model

• PDF metadata
• DOC, DOCX, ODF document metadata
• OAI-PMH metadata
• Schema.org metadata
  • This is what search engines now index

Schema.org data elements

Attributes of these government documents (in terms of schema.org classes and properties)

Classes

https://schema.org/CreativeWork
https://schema.org/Book
https://schema.org/ScholarlyArticle
https://schema.org/CreativeWorkSeries
https://schema.org/BookSeries
https://schema.org/MovieSeries

Properties

https://schema.org/identifier
https://schema.org/name
https://schema.org/description
https://schema.org/abstract
https://schema.org/about
https://schema.org/url
https://schema.org/datePublished

Gaps

• How to link to newer and older versions of a document (with schema.org metadata)?
• How to link to {PDF, ePub, Mobi} versions of a document (with schema.org metadata)?

• pros and cons
  • con: mobile support
• tools
  • PDF.js
  • Adobe vulns
  • tablet
    • also great for eTextbooks

• new URLs
• BUG: westurner/pyglobalgoals#

https://github.com/apache/steve

• https://github.com/jupyter/governance/pull/ 148/files
• Solves for #3