Publish the package and its documentation, and move to the papers organization
Add the Zensical documentation of the Python package (docs/package, built by the docs workflow), merge the standard publish workflow with the setuptools-scm tag check, add the SPDX header rule to ruff, restructure the README, and point every repository and registry address at the Gitea organization papers. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01B8cL4zN4XpaQF5cBtASzfq
This commit is contained in:
37 files changed
+1005
-83
No files matched your search
@@ -0,0 +1,22 @@
|
||||
# paperspec
|
||||
|
||||
paperspec is the reference implementation of the scienting formats, the files in which a team stores its scientific papers once, corrects them once and addresses them down to the sentence.
|
||||
This site documents the Python package `paperspec` and its command.
|
||||
The formats themselves, with the specification, schemas, test vectors and fixtures, are published at <https://paperspec.scient.ing>.
|
||||
|
||||
The package is an oracle: a plain program whose answers count as the expected ones.
|
||||
Every hash, identifier, canonical JSON string, package check and database form in the repository is computed by this code, and no expected value in a test vector is typed by hand.
|
||||
It favors clarity over speed, and it is not a production reader or writer.
|
||||
|
||||
## Who it is for
|
||||
|
||||
- **A developer writing a reader, writer, converter or store** installs the package to validate their output against every rule, and to compute the values their own code must match.
|
||||
- **A researcher or editor with a package** uses the `paperspec` command to validate it, to try a proposed correction without writing it, and to load it into SQLite and query it.
|
||||
- **A maintainer of the formats** uses the command to rebuild the vectors and fixtures, and to check the whole repository.
|
||||
|
||||
## Where to go next
|
||||
|
||||
- [Get started](start/index.md): install the package and run a first command.
|
||||
- [Guides](guides/index.md): validate a package, load it into SQLite, use the library from Python, and check and rebuild the repository.
|
||||
- [Reference](reference/index.md): every command and option, and the library's modules.
|
||||
- [About](about/index.md): status, design commitments and known limits.
|
||||
Reference in new issue
Block a user