Skip to content

Document file types from user's perspective #42

Description

@joemull

As a part of openlibhums/typesetting#216 and openlibhums/janeway#4327, it became clear that we need to help users understand the file types they are expected to know about in Janeway.

Here is a start, taken from the help texts I encoded into the Document Management page.

Manuscript File

Manuscript files hold the main text content of the article while it is being finalized. They are used across review, copyediting, and typesetting.

Figure/Data File

Figure files hold images that will be included in the article. Data files hold any other other content that is not an image or main text content but that will be included in the published article.

Galley File

Galleys are files that have been typeset or encoded, most often in XML, HTML, or PDF format, so that they are ready for proofing and publication.

Proofing File

Proofing files are copies of galleys that have been marked up to indicate corrections to be made in subsequent rounds of typesetting.

Source File

Source files are files created in typesetting while generating a galley. They are often in specialized file formats used by graphic design and document layout applications.

Supplementary File

Supplementary files are publication-ready pieces of content to be published alongside the article, often with their own DOIs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Priority mediumMedium prioritydocumentationImprovements or additions to documentation

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions