Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/getmanfred/mac

Manfred Awesomic CV
https://github.com/getmanfred/mac

cv json

Last synced: about 2 months ago
JSON representation

Manfred Awesomic CV

Host: GitHub
URL: https://github.com/getmanfred/mac
Owner: getmanfred
License: cc-by-sa-4.0
Created: 2018-11-23T15:40:36.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2023-11-13T08:25:54.000Z (about 1 year ago)
Last Synced: 2024-08-01T12:33:11.588Z (5 months ago)
Topics: cv, json
Language: TypeScript
Homepage:
Size: 9.13 MB
Stars: 577
Watchers: 19
Forks: 36
Open Issues: 6
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: code_of_conduct.md

Awesome Lists containing this project

README

# Manfred Awesomic CV

The MAC (or Manfred Awesomic CV) is a(nother) naive attempt to create **a standard open source format to define and share CVs**. The format is defined as a JSON Schema to validate CVs stored as JSON files.

[Why use it](#-why-use-it) •
[How to use it](#-how-to-use-it) •
[Who uses it](#-who-uses-it) •
[Who we are](#-who-we-are) •
[How to contribute](#%EF%B8%8F-how-to-contribute) •
[License](#%EF%B8%8F-license) •
[Spread the word!](#-spread-the-word)

!["JSON Schema"](https://github.com/getmanfred/mac/blob/master/assets/readme/schema_screen_capture.png?raw=true "JSON Schema")

!["MAC Sample"](https://github.com/getmanfred/mac/blob/master/assets/readme/MAC_sample.gif?raw=true "MAC Sample")

## 🥘 Why use it

There are A LOT of CV formats, and some of them are a nice try to define a universal CV format, but we think that **a CV should include not only what candidates are or know but also what they are interested in and what they want to become**.

Like most open-source projects, the first use case was found in the company where the first contributors worked. Manfred is committed to the idea that **every person should keep control over their personal and professional data**. This means that they should be able to export their data from any platform in a machine-readable format with **a Model Definition to process that data efficiently**. This is how the MAC was born.

## 🪛 How to use it

You just need to copy, download or reference [the schema](https://github.com/getmanfred/mac/blob/master/schema/schema.json) to validate a new CV, built as a JSON file from scratch, or a JSON generated previously (for example, [this sample](https://github.com/getmanfred/mac/blob/master/samples/default_sample_ES.json)).

To get started, you can copy both schema and sample in an **online validator** like [jsonschemavalidator.net](https://www.jsonschemavalidator.net/) or [liquid-technologies.com/online-json-schema-validator](https://www.liquid-technologies.com/online-json-schema-validator).

!["JSON Schema"](https://github.com/getmanfred/mac/blob/master/assets/readme/MAC_online_validator_example.png?raw=true "JSON Schema")

You also have implementations to validate a JSON file programmatically in almost every coding language:

* [AVJ (JavaScript)](https://ajv.js.org/)
* [Snow (Java)](https://github.com/ssilverman/snowy-json)
* [jschon (Python)](https://jschon.readthedocs.io/en/latest/)
* ... and [much more](https://json-schema.org/implementations.html)

> :warning: **The current MAC Schema has been designed using the 2019-09 Specification Draft**: When choosing a validator, please, check if it's compliant with the 2019-09 Draft. You can get much more information about the JSON Schema Specification in [json-schema.org](https://json-schema.org/).

You can check **examples of how to use code to create and validate MAC files** in the [MAC/scripts](https://github.com/getmanfred/mac/tree/master/scripts) directory.

---

The Schema is documented by itself, but it's much easier to get "the big picture" with [a graphical representation](https://github.com/getmanfred/mac/blob/master/assets/readme/MAC_diagram.png).

## 🎨 Who uses it

A bunch of Tech Startups, IT Consulting Companies and Recruiting Platforms already use the MAC as an interchangeable format **to unlock the data of their users, candidates and employees and give them back the power to use it wherever they want**.

## 🤓 Who we are

The MAC was made with ❤️ and sentidiño in Galicia, Spain.

As common in new projects, the individual or group who started the project also administers the project, establishes its vision, and controls permissions to merge code into it. **We have appointed a starting Council to manage the MAC**, formed by 2 people from Manfred and 2 independent members, but the plan is to hold formal elections, where contributors will vote for candidates for the Council as soon as the project gets a minimum maturity and adoption.

Right now the Council is formed by:

_{David Bonilla}

_{Blanca Lanaspa}

_{Alberto Molpeceres}

_{Jerónimo López}

## ⚙️ How to contribute

The MAC is an open-source project. We are committed to a fully transparent development process and appreciate highly any contributions. Whether you are helping us fix bugs, proposing new features, improving our documentation or spreading the word - we would love to have you as part of the MAC community.

Please refer to our [Contribution Guidelines](https://github.com/getmanfred/mac/blob/master/CONTRIBUTING.md) and [Code of Conduct](https://github.com/getmanfred/mac/blob/master/code_of_conduct.md).

## ⚖️ License

The MAC is free and open-source software licensed and distributed under the Creative Commons Attribution Share Alike 4.0 International (CC BY-SA 4.0 International).

## 🌟 Spread the word!

If you want to say thank you and/or support active development of the MAC:

- Add a GitHub Star to the project!
- Tweet about the project on your Twitter!
- Tag [@getmanfred](https://twitter.com/getmanfred) and/or `#AwesomicCV`

Thanks so much for your interest in growing the reach of the MAC!