Oddbean

Title field is mandatory. Author is optional, even though it'll probably be added for books. Not really clear from the interface. Maybe add a red star next to "Title", or something, or demote author into the Asciidoc header.

The UX rule of thumb I've heard is "Don't punish the user before they've performed an action." So best practice is to make optional fields optionally visible, and not to show the red stars and such oj mandatory fields unless the user tries to submit the form without filling out all the necessary fields.

So, move author into ascii? Most 30040s won't be cohesive documents, like an original book, but rather someone's personal compilation of documents or snippets. A sort of remix. They won't have an author, but the 30041s might and they'd probably have author in the ascii or the form would get really messy. Right now, these are the mandatory tags (we need "d" and we need "title" to make "d"): [ "d", "<identifier>" ], [ "title", "<full_index_title>" ] And these are the optional ones: [ "author", "<author_name>" ], [ "i", "isbn:9780765382030" ], [ "t", "<topics about which the event might be of relevance>"], [ "published_on", "<date in the format YYYY-MM-DD>" ], [ "published_by", "<publisher of the source material>"], [ "image", "<URL pointing to an image to be shown with the title>" ], [ "summary", "<human readable description of the work>" ], [ "version", "<the volume, edition, or translation included>" ]

Yeah, I saw the title and author lines in the asciidoc header and got confused because there's also a field. Maybe generally have a metadata section at the top of the preview, with the asciidoc header info pulled, for them to edit. And then we have it prepared for generating ePUB format. We just have to map to the require ePUB fields. https://docs.asciidoctor.org/epub3-converter/latest/

I didn't even think of the fact that Asciidoc can already have a bunch of the metadata we can process defined as header fields. 🤔 We should probably map-n-pull that into our json tags. https://docs.asciidoctor.org/asciidoc/latest/document/header-ref/