From a88e60aff8c39efec639c7ee4f87aafbdb08b113 Mon Sep 17 00:00:00 2001 From: Alex Cabal Date: Tue, 27 Jul 2021 17:52:24 -0500 Subject: [PATCH] Tweak review how-to and rename some how-to URLs --- ...add-a-standard-ebooks-ebook-to-goodreads.php} | 0 ...> how-to-create-figures-for-music-scores.php} | 0 ...php => how-to-produce-a-shakespeare-play.php} | 0 ...view-an-ebook-production-for-publication.php} | 16 ++++++++-------- www/contribute/how-tos/index.php | 8 ++++---- 5 files changed, 12 insertions(+), 12 deletions(-) rename www/contribute/how-tos/{goodreads.php => how-to-add-a-standard-ebooks-ebook-to-goodreads.php} (100%) rename www/contribute/how-tos/{illustrations-music.php => how-to-create-figures-for-music-scores.php} (100%) rename www/contribute/how-tos/{shakespeare.php => how-to-produce-a-shakespeare-play.php} (100%) rename www/contribute/how-tos/{review.php => how-to-review-an-ebook-production-for-publication.php} (96%) diff --git a/www/contribute/how-tos/goodreads.php b/www/contribute/how-tos/how-to-add-a-standard-ebooks-ebook-to-goodreads.php similarity index 100% rename from www/contribute/how-tos/goodreads.php rename to www/contribute/how-tos/how-to-add-a-standard-ebooks-ebook-to-goodreads.php diff --git a/www/contribute/how-tos/illustrations-music.php b/www/contribute/how-tos/how-to-create-figures-for-music-scores.php similarity index 100% rename from www/contribute/how-tos/illustrations-music.php rename to www/contribute/how-tos/how-to-create-figures-for-music-scores.php diff --git a/www/contribute/how-tos/shakespeare.php b/www/contribute/how-tos/how-to-produce-a-shakespeare-play.php similarity index 100% rename from www/contribute/how-tos/shakespeare.php rename to www/contribute/how-tos/how-to-produce-a-shakespeare-play.php diff --git a/www/contribute/how-tos/review.php b/www/contribute/how-tos/how-to-review-an-ebook-production-for-publication.php similarity index 96% rename from www/contribute/how-tos/review.php rename to www/contribute/how-tos/how-to-review-an-ebook-production-for-publication.php index b420e45a..fde11d0b 100644 --- a/www/contribute/how-tos/review.php +++ b/www/contribute/how-tos/how-to-review-an-ebook-production-for-publication.php @@ -1,9 +1,9 @@ 'How to review a production before it is published', 'manual' => true, 'highlight' => 'contribute', 'description' => 'A guide to proofread and review an ebook production before it is published.']) ?> +?> 'How to Review an Ebook Production for Publication', 'manual' => true, 'highlight' => 'contribute', 'description' => 'A guide to proofread and review an ebook production for publication.']) ?>
-

How to review a production before it is published

+

How to Review an Ebook Production for Publication

After an ebook production is completed, it must go through rounds of review before it is published to ensure the appropriate production quality is assured. Reviewers are assigned by the editor-in-chief, and may be a member of the editorial staff, or an experienced Standard Ebooks producer. Below is a helpful step-by-step checklist for reviewers of ebook productions. The checklist is by no means exhaustive, but serves as a good starting point for the proofreading process. Reviewers should keep in mind the standards enumerated in the Manual of Style, and note any discrepancies not listed below. Before any review steps, ensure the most recent version of the SE toolset is installed.

  1. @@ -127,8 +127,8 @@ require_once('Core.php');
  2. -

    Review meta data

    -

    Review all meta data including those in content.opf. See this section of the Manual for reference. Possible things to look out for:

    +

    Review metadata

    +

    Review all metadata including those in content.opf. See this section of the Manual for reference. Possible things to look out for:

    • Is author, translator(s), cover artist, etc. in the correct order and in expected style?

      @@ -147,16 +147,16 @@ require_once('Core.php');
    3. +
  3. +

    Lint

    +

    Run a final se lint . check, and ensure it is silent. If any warnings and errors are produced, they must be noted and addressed.

    +

  4. Test epub build

    Run the following command at the root of the project directory to ensure the epub builds:

    se build --check-only .

    Note all errors if they are produced by the command.

    5. -
  5. -

    Lint

    -

    Run a final se lint . check, and ensure it is silent. If any warnings and errors are produced, they must be noted and addressed.

    -

  6. Submit review comments

    Log all review notes and recommendations on the production's GitHub repository issue tracker, and inform the producer and the rest of the editorial team the review has been completed, with a short summary of the results of the review and changes that may be needed before publishing.

    diff --git a/www/contribute/how-tos/index.php b/www/contribute/how-tos/index.php index 1d6e9934..572fafc1 100644 --- a/www/contribute/how-tos/index.php +++ b/www/contribute/how-tos/index.php @@ -6,16 +6,16 @@ require_once('Core.php');

    How-to Guides