Philosphy

Philosophy

In LibRArs it is possible to author and publish content. Each publication is called an artifact. Artifacts can be of many types such as: books, articles, essays and so on. An artifact is basically a multimedia publication designed to deliver knowledge.

Every artifact can be published to different formats. A format is a multimedia representation of the artifact which allows it to be consumed by the audience it is intended for.

Technology and infrastructure

Every artifact is developed as an R package and has its own repository under the LibRArs Git Organization.

The repository for each artifact includes:

• The content of the artifact.
• All the formats the artifact can be published to.
• All the languages supported by the artifact.
• The documentation.
• The issues the community can engage with.
• The releases of the artifact.

An artifact's repository contains everything necessary for developing, publishing, maintaining, versioning and updating the artifact.

Community driven

Artifacts are developed by the community.

Artifacts requirements

Every artifact needs to satisfy a small set of requirements to be considered such:

• It must use a LibRArs template, which will determine the type of publication. Once set, the type will not be changed throughout the lifespan of the artifact.
• Every artifact must be associated with a subject. The subject will determine the topics the artifacts intends to address. For example, an artifact can be a book about Linear Algebra. The subject defines what kind of knowledge the artifacts is willing to deliver.
• An artifact must also be associated with an audience type, which determines the target audience which will receive the knowledge delivered by the artifact. Examples can be: kids, schoolers, students, university students, adults, etc.

Given the requirements, it is therefore possible to have two different artifacts dealing with the same subject but targeting different audiences.

Authoring process

The life of