Code Monkey home page Code Monkey logo

mac's Introduction

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.

Version Badge

Why use itHow to use itWho uses itWho we areHow to contributeLicenseSpread the word!



"JSON Schema"

"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.

MAC Structure

🪛 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.

"JSON Schema"

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

⚠️ 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.

Manfred SNGULAR MOBIVERY SPARTA TINYBIRD

🤓 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
David Bonilla
Blanca Lanaspa
Blanca Lanaspa
Alberto Molpeceres
Alberto Molpeceres
Jerónimo López
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!

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

mac's People

Contributors

adrianfusco avatar apradillap avatar dav-garcia avatar dbonillaf avatar dependabot[bot] avatar ignapzs avatar javalon avatar magmax avatar manudous avatar mrdgh2821 avatar oscardemadriz avatar rebecamendez avatar sergioregueira avatar ydarias avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

mac's Issues

Problema de ejecución

Cuando en la descripcion de un puesto de trabajo (job) se añade más de un challenge con solo descripción, solo se muestra el primero en la web que se genera.
imagen
imagen
imagen

Add Location on jobs

It would be cool to add an optional location field for studies and jobs in the CV and in the Manfred site.
Maybe the user could type a city and a country from a list and the flag could be represented via its ISO country code using the flagpedia API.

Something like:

location: {
     city: "Paris",
     country: "FR"
}

Keep up this awesome project!

Add TypeScript definitions

I think it would be a good idea to add TypeScript definitions we could just add a subfolder, named TypeScript and developers who are using this technology can get benefit of deinition types.

I have used a tool to extract the typings from the schema definition and generated a codesandbox:

codesandbox example

This example, just use the typescript definition and is tested agains the example cv you provide:

  • model.ts: automated typescript definition.
  • cv-sample: example data (try to remove any of the fields and you will get a red warning)
  • index.ts: just dumps the content of the CV in the console.

If you think this can be interesting, gimme a buzz we can fork the project and:

  • First add the definition to the project (we could offer two flavours model like and defintion type (d.ts)
  • We could create a Github Actions so whenever a merge to master (or other branch) is performed a simple nodejs tool could be launched and the definition types could be automatically updated.

Possible adoption of this schema as standardized schema in Smart Data Models

The Smart Data Models initiative compiles open-licensed reference data models based on real experiences.
We would like to map this schema of a CV. Once adopted we create automatically specifications in 8 languages (EN, FR, DE, SP, IT, JA, ZH, KO), exports in SQL, yaml, etc and also examples in csv, etc.
In order to do that we need an example we will take from the samples section here but also to attribute to all the authors.
Should I take as authors all listed in Contributors ?

Link projects with job positions?

Hello,

Thank you for this awesome schema. I find it very useful but I miss a feature. I would like to show the different projects I did across different companies.

I saw that from manfred site I'm able to create OpenSource or Side projects, but for professional experience I can just put the role and general description.

Maybe I miss something and it's already possible in the schema? Any help is very appreciated.

Salu2

careerPrefrences && manfredSpecificData

I've been playing around the schema and getmanfred.com site.

I've been trying to fulfill my profile usig getmanfred.com and obtain a JSON sample that contains the section _ careerPreferences_ but I haven't found the UI section to provide that info, is being used but getManfred?

On the other hand I have found a section called manfredSpecificData that seems not to be in the JSON Schema definition, is this something that will be kept out of the standard? Do you have plans to refactor this?

Add more cotent to publicArtifactType and projectType to model research/academic careers

Some of us have worked both in academia/research and industry, but the current CV schema lacks some elements to represent it. At least:

  • publicArtifactType should include journal papers and conference proceedings.
  • projectType should include funded research projects (Those could be added as other but I think they are at least as important as side projects, as some can have enormous budgets).

Thanks, keep the good work!

Problem when executing Python Generation Script

After reading the scripts README, and proceed to create the virtual environment with all the required dependencies, I came across the following problem:

When executing
❯ python ./jsonschema_generator.py ../../schema/schema.json -o example1.json

then the following error appears

Traceback (most recent call last):
[....]
File "[......]/mac/scripts/python_validator/./jsonschema_generator.py", line 52, in generate_dict
generator = self.get_generator(v["type"])
KeyError: 'type'

Could this be related to each of the different element definitions like
#/$defs/person or #/$defs/location ?

Open discussions

I would suggest to open discussions in this Github project in order to debate topics about MAC, rank ideas, Q&A and so on.

Problem when executing Python Validation Script

After reading the scripts README, and proceed to create the virtual environment with all the required dependencies, I came across the following problem:

When executing
❯ python ./mac_validate.py ../../samples/default_sample_ES.json

then the following error appears

Validating ../../samples/default_sample_ES.json
WARN: schema not set in the file
Traceback (most recent call last):
[....]
File "[......]/mac/scripts/python_validator/./mac_validate.py", line 34, in get_schema
with open("../schema/schema.json") as fd:
FileNotFoundError: [Errno 2] No such file or directory: '../schema/schema.json'

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.