DocsGetting started
docs / getting started

Getting started

From a manuscript on your machine to a published, citable work on the Hub. During the alpha all of it happens in the browser; there is nothing to install.

01Sign in

Reading published works needs no account. Submitting does. Hub is in early access, switched on account by account: log in, then open Submit. If Hub isn’t on your account yet, Submit links to the waitlist.

02Upload your manuscript

On the submit page, drop a file or click to choose one: a PDF, a single .tex file, or a zip or tar archive of a LaTeX project. One file is one upload, and an upload from the browser is currently limited to 10 MB. The other two ways in that the page shows, submitting from a terminal and linking a Google Doc, are not available yet.

The Hub then parses the file: it scans it for unsafe content, validates the format, and transcribes the text into a structured representation of headings, references, equations and figures. The FAQ says exactly what that does and does not check.

03Answer four questions while it parses

Four steps of the submission form need nothing from the parser, so you can fill them in while it runs:

  • License: CC BY 4.0 or CC BY-SA 4.0.
  • Published elsewhere: point to the work’s journal, conference or preprint record, if it has one.
  • Subject & keywords: the work’s primary subject field and the keywords you choose for it.
  • AI contributors: list the models and systems that contributed, or affirm that none did. See Machine contribution.

04Review what the parse extracted

When the parse lands, the remaining four steps unlock: Title & abstract, Authors, Version notes, and Review & submit. Correct the extracted title, abstract and author list here, give an email address for every co-author, and mark which listed author is you. The author list is only applied on a work’s first submission, so check it now; Author guidelines covers what listing a co-author does and does not do.

Finalizing the last step turns the submission into a draft: an unpublished version of a work. A draft is readable by you and by any co-author whose authorship has been confirmed, which at alpha means only you.

05Preview, then publish

The work’s Manage page is where a draft lives. Its Preview tab is the only place an unpublished version can be read, and it is where you edit the parsed body before anyone else sees it. When the draft is right, publish it. Publishing needs three things: you are the submitter, there is a draft, and it has a license.

Publishing is a one-way door. It assigns the version number, makes the version publicly readable and, the first time, mints the work’s permanent identifier. After that only Valency can remove it, on your request, and nothing unpublishes what readers have already seen.

06After publishing

The work has a Valency identifier, written vlnc:W_…, and a permalink at /works/W_…; the Cite controls on its page copy a formatted citation and a BibTeX entry. To revise it, use Upload new version on the Manage page: the upload goes through the same steps and publishes as v2, with v1 kept on the record. The FAQ covers versions, identifiers and citing in detail.