[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)
🥘 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 to validate a new CV, built as a JSON file from scratch, or a JSON generated previously (for example, this sample).
To get started, you can copy both schema and sample in an online validator like jsonschemavalidator.net or liquid-technologies.com/online-json-schema-validator.
You also have implementations to validate a JSON file programmatically in almost every coding language:
: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.
You can check examples of how to use code to create and validate MAC files in the MAC/scripts directory.
The Schema is documented by itself, but it's much easier to get "the big picture" with a graphical representation.
🎨 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 and Code of Conduct.
⚖️ 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 and/or
#AwesomicCV
- Tag @getmanfred and/or
Thanks so much for your interest in growing the reach of the MAC!