{"size": 1438, "ext": "scrbl", "max_stars_repo_path": "splitflap-doc/notes.scrbl", "max_stars_repo_name": "LiberalArtist/splitflap", "max_stars_repo_stars_event_min_datetime": "2021-06-27T06:34:02.000Z", "max_stars_repo_stars_event_max_datetime": "2021-06-28T00:32:10.000Z", "max_issues_repo_path": "splitflap-doc/notes.scrbl", "max_issues_repo_name": "LiberalArtist/splitflap", "max_issues_repo_issues_event_min_datetime": null, "max_issues_repo_issues_event_max_datetime": null, "max_forks_repo_path": "splitflap-doc/notes.scrbl", "max_forks_repo_name": "LiberalArtist/splitflap", "max_forks_repo_forks_event_min_datetime": "2021-06-27T16:50:33.000Z", "max_forks_repo_forks_event_max_datetime": "2021-06-27T16:50:33.000Z"}
{"max_stars_count": 4, "max_issues_count": null, "max_forks_count": 1, "avg_line_length": 44.9375, "max_line_length": 109, "alphanum_fraction": 0.7844228095}
#lang scribble/manual

@(require "misc.rkt" (for-label splitflap xml))

@title{Package Notes}

@section{Known Issues}

See Splitflap’s @hyperlink["https://github.com/otherjoel/splitflap/issues"]{issues tracker on Github} for any
known problems with the library, or to report problems.

@subsection{Non-ASCII email addresses and domains}

The @Atom1.0[] and @RSS2.0[] specs do not contemplate or allow for the use of non-ASCII characters
in email addresses or domain names, which is a defect considering that non-English alphabets are in
widespread use for both of these things.

At this early stage I have chosen to enforce the standards as written, for consistency’s sake. I do
plan to add a parameter which would cause @racket[dns-domain?] and @racket[email-address?] to
validate strings according to some alternative scheme that allows for non-ASCII characters. In order
to do this correctly, though, I need to educate myself about any standards that exist in this area.

@section{Licensing}

Splitflap is provided under the terms of the
@hyperlink["https://github.com/otherjoel/splitflap/blob/main/LICENSE.md"]{Blue Oak 1.0.0 license}.

The split-flap animation in the HTML edition of this documentation comes from the 
@hyperlink["https://github.com/rjkerrison/ticker-board"]{ticker-board} project by
Robin James Kerrison, under the terms of the
@hyperlink["https://github.com/otherjoel/splitflap/blob/main/NOTICE.md"]{MIT license.}
