Skip to content

Latest commit

 

History

History
69 lines (45 loc) · 6.45 KB

index.md

File metadata and controls

69 lines (45 loc) · 6.45 KB
Raw

arXivLabs: An invitation to collaborate

arXiv Labs icon{.mkd-img-thumb align=right alt='a bubbling beaker with a smiling face and crossedbones behind it' role=presentation}

arXivLabs allows the community to contribute to arXiv by integrating code into the arXiv platform to provide features such as bibliographic tools and demos. These integrations are available to readers through a series of tabs at the bottom of the abstract page.

arXiv Labs features

We welcome proposals from the community for arXivLabs integrations. Proposed features must add value to arXiv content, benefit the scientific community, and be based on underlying services that are free of charge or operate on a freemium model. Please note that Labs projects may be removed at any time at the sole discretion of arXiv. As a courtesy, arXiv will notify the creator when possible that their integration has been removed.

If you wish to submit a proposal for an arXivLabs project, please review our proposal criteria below before doing so. After you have reviewed our criteria, follow the steps provided at the end of this page for submitting a proposal. As part of your proposal, you will need to submit a Pull Request (PR). The final decision for approving an arXivLabs project is made by the arXiv management and teams.

arXivLabs is not:

  • A source of research funding.
  • The venue for proposing formal collaboration with arXiv.
  • A laboratory space for scientific research.
  • A place to tell us about your latest scientific breakthrough.
  • Part of the standard arXiv workflow, including submitting a paper and getting endorsed.

If you have questions about collaborating with arXiv on something that is not aligned with arXivLabs, contact us through our user support portal. If you need information on how to submit a paper to arXiv, please visit our help pages.

arXivLabs Proposal Criteria

All arXiv-affiliated projects are expected to abide by the arXiv Community Code of Conduct. The project must align with the overall arXiv mission and values of openness, community, excellence, and user data privacy. Commercial projects may be considered as long as they provide useful services in a permanently free tier. Except when specifically authorized in writing, the use of the name “arXiv” or “arXiv.org” is prohibited in non-arXiv organization names or projects, advertising and other promotional vehicles.

Responsibilities

If you propose an arXivLabs project, you must submit the project via pull request (PR) and are responsible for developing and maintaining the Labs component that you have created.

Documentation

The project must provide and maintain clear and complete documentation that is available in the same public repository as the project source code. Some examples of what the documentation should include are:

  • The technical dependencies of the project.
  • A description of any external APIs or data sources the project uses.

Ownership Rights and Responsibilities

We encourage all contributors to Labs to continue to update and maintain their code. However, all source code used to integrate a Labs project with arXiv systems will be considered property of arXiv.

UI/UX

  • Projects with user-facing components must adopt WCAG 2.0 Level A (Web Content Accessibility Guidelines). Higher levels of accessibility (i.e. AA, AAA) are encouraged and welcome.
  • Any user-facing or promotional content must clearly indicate that the project is an arXivLabs project.
  • As an arXiv-affiliated project, naming, content, and graphical elements must be consistent with the norms of professional conduct, including the arXiv Code of Conduct and Brand and Style Guide.
    • Except when specifically authorized in writing, the use of the name “arXiv” or “arXiv.org” is prohibited in non-arXiv organization names or projects, advertising and other promotional vehicles.
  • When practical, a quick-to-use Likert-style or cardinal feedback mechanism should be made available.

Security & Privacy

  • Projects with UI components are reviewed for vulnerabilities that might put users or the arXiv platform itself at risk or leak user information. In cases where vulnerabilities are discovered, Labs partners will be responsible for correcting the issue or risk having their project rejected or terminated.
  • The PR must contain all the code that is to be run on the abs page for the project integration. It must not load code from any other source, or for any other purpose.
  • Projects must not circumvent or undermine existing security or quality of service measures on the arXiv platform.
  • A feedback collection mechanism of some kind must be made available to end users. For example, a JIRA feedback collector may be used to collect qualitative feedback.

Submit Your Proposal

The following steps will guide you in submitting an arXivLabs proposal:

  • Submit an arXivLabs proposal in the Labs support portal.
  • Next, submit your Pull Request (PR) to the arXiv-browse repository using GitHub.
    • Request a review of your PR by selecting arXiv/labs-moderators as your reviewer.
    • Create a fork to your organization, create a branch on the fork, and then create a PR against arXiv’s repository. This is a standard practice for creating a PR to suggest a change to other organizations. Please consult this documentation if you’d like more detailed information.
  • Your PR should only make changes in the labs area. Any changes in other parts of the abstract page will likely result in rejection of the PR.
  • If possible, please run the tests in the upstream repository as well as yours. Including test results in the PR is very helpful to understand the nature of change and PR.
  • Please see this well-defined project example to use as a guide to your PR.
  • Keep in mind, simpler PRs can be reviewed much more quickly than complex PRs.
  • PRs are reviewed as resources become available.