search

jsonresume / resume-schema

JSON-Schema is used here to define and validate our proposed resume json
http://jsonresume.org
MIT License
2.14k stars 278 forks source link

Certifications and Exams #177

Closed RobertMortimer closed 3 years ago

RobertMortimer commented 9 years ago

Is there any way a structure similar to the following cold be inserted for professional qualifications. The structure I am thinking of is as follows

Note:- Courses may be provided by a third party that is not the same as the Certification/Examination provider but is often aimed toward a specific accrediting body's exam

Or as json

  "certifications": [{
    "certAuthority": "Oracle Inc",
    "certs" : [{
        "name": "Oracle Database 11g Administrator Certified Associate",
        "ref": "",
        "url": "",
        "validationUrl": "", 
        "awardSerial": "",
        "startDate": "2013-01-01",
        "endDate": "",
        "expires": "false"
    },{
        "name": "Oracle Certified Associate, Oracle WebLogic Server 11g System Administrator",
        "ref": "",
        "url": "",
        "validationUrl": "",
        "awardSerial":  "",
        "startDate": "2013-01-01",
        "endDate":  "",
        "expires": "false"
    }]
    "exams": [{
        "name": "Oracle Database 11g: Administration I",
        "ref": "1Z0-052",
        "url": "http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?page_id=5001&get_params=p_exam_id:1Z0-052",
        "validationUrl":  "",
        "awardSerial":  "",
        "startDate": "2013-01-01",
        "endDate":  "",
        "expires": "false"
    },{
        "name": "Oracle Database 11g: SQL Fundamentals I",
        "ref": "1Z0-051",
        "url": "http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?page_id=5001&get_params=p_exam_id:1Z0-051",
        "validationUrl":  "",
        "awardSerial":  "",
        "startDate": "2013-01-01",
        "endDate":  "",
        "expires": "false"
    },{
        "name": "Oracle Weblogic Server 11g: System Administration I",
        "ref": "1Z0-102",
        "url": "http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?page_id=5001&get_params=p_exam_id:1Z0-102",
        "validationUrl":  "",
        "awardSerial": "",
        "startDate": "2013-05-02",
        "endDate": "",
        "expires": "false"
    }]
    "courses": [{
        "name": "Introduction to Oracle Database 11g: Administration",
        "ref": "A-COURSE",
        "url": "http://ThirdParty.com/Introduction_to_Oracle_Database_11g/",
        "trainingProvidor": "ThirdParty Training",
        "startDate": "2013-01-01",
        "endDate":  "",
        "expires": "false"
    }]
  }]

This is the sort of data that is used as selection criteria and also often extracted by recruiters for anonymous candidate profiles.

RobertMortimer commented 9 years ago

Added an additional section for vendor courses.

RobertMortimer commented 9 years ago

Here is a proposed schema for the addition

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Resume Schema",
  "type": "object",
  "additionalProperties": false,
  "properties": {

    "vocational": {
      "type": "array",
      "additionalItems": false,
      "items": {
        "type": "object",
        "additionalProperties": true,
      "properties": {
            "issuingAuthority": {
              "type": "string",
              "description": "e.g. Oracle Inc., Institute of Mechanical Engineering, CIPD "
            },
          "website": {
            "type": "string",
            "description": "Issuing authority's home page",
            "format": "uri"
          },
            "accreditations": {
            "type": "array",
            "additionalItems": false,
            "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
                "title": {
                  "type": "string",
                  "description": "e.g. Oracle Database 12c Administrator Certified Associate"
                },
                "website": {
                  "type": "string",
                  "description": "Link to issuing authority's description of accreditation",
                  "format": "uri"
                },
                "verification": {
                  "type": "string",
                  "description": "External candidate verification URL",
                  "format": "uri"
                },
                  "achievedDate": {
                  "type": "string",
                  "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
                  "format": "date"
                },
                "expireDate": {
                  "type": "string",
                  "description": "e.g. 2012-06-29",
                  "format": "date"
                },
                "doesNotExpire": {
                  "type": "boolean",
                  "format": "checkbox"
                }
              }
            }
          },
            "exams": {
            "type": "array",
            "additionalItems": false,
            "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
                "code": {
                  "type": "string",
                  "description": "e.g. 1Z0-062"
                },
                "title": {
                  "type": "string",
                  "description": "e.g. Oracle Database 12c: SQL Fundamentals"
                },
                "website": {
                  "type": "string",
                  "description": "Link to issuing authority's description of exam",
                  "format": "uri"
                },
                "verification": {
                  "type": "string",
                  "description": "External candidate verification URL",
                  "format": "uri"
                },
                  "achievedDate": {
                  "type": "string",
                  "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
                  "format": "date"
                },
                "expireDate": {
                  "type": "string",
                  "description": "e.g. 2012-06-29",
                  "format": "date"
                },
                "doesNotExpire": {
                  "type": "boolean",
                  "format": "checkbox"
                }
              }
            }
          },
            "courses": {
            "type": "array",
            "additionalItems": false,
            "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
                "title": {
                  "type": "string",
                  "description": "e.g. Oracle Database 12c: Install and Upgrade Workshop"
                },
                "trainingProvidor": {
                  "type": "string",
                  "description": "Training may be via a third party - Provider's name goes here"
                },
                "providorWebsite": {
                  "type": "string",
                  "description": "Training provider's home page",
                  "format": "uri"
                },
                  "startDate": {
                  "type": "string",
                  "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
                  "format": "date"
                },
                "endDate": {
                  "type": "string",
                  "description": "e.g. 2012-06-29",
                  "format": "date"
                }
              }
            }
          }
        }
      }
    }
  }
}
telekid commented 9 years ago

Exams should probably support scores and an optional score out-of value.

telekid commented 9 years ago

Also, just noticed a typo: providorWebsite should be providerWebsite.

RobertMortimer commented 9 years ago

My bad on the typo and I agree with the score however for a number of the IT qualifications that will be Pass/Fail but scores and and % could also be input

RobertMortimer commented 9 years ago

Spelling corrected and Score added for exams

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Resume Schema",
  "type": "object",
  "additionalProperties": false,
  "properties": {

    "vocational": {
      "type": "array",
      "additionalItems": false,
      "items": {
        "type": "object",
        "additionalProperties": true,
      "properties": {
            "issuingAuthority": {
              "type": "string",
              "description": "e.g. Oracle Inc., Institute of Mechanical Engineering, CIPD "
            },
          "website": {
            "type": "string",
            "description": "Issuing authority's home page",
            "format": "uri"
          },
            "accreditations": {
            "type": "array",
            "additionalItems": false,
            "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
                "title": {
                  "type": "string",
                  "description": "e.g. Oracle Database 12c Administrator Certified Associate"
                },
                "website": {
                  "type": "string",
                  "description": "Link to issuing authority's description of accreditation",
                  "format": "uri"
                },
                "verification": {
                  "type": "string",
                  "description": "External candidate verification URL",
                  "format": "uri"
                },
                  "achievedDate": {
                  "type": "string",
                  "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
                  "format": "date"
                },
                "expireDate": {
                  "type": "string",
                  "description": "e.g. 2012-06-29",
                  "format": "date"
                },
                "doesNotExpire": {
                  "type": "boolean",
                  "format": "checkbox"
                }
              }
            }
          },
            "exams": {
            "type": "array",
            "additionalItems": false,
            "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
                "code": {
                  "type": "string",
                  "description": "e.g. 1Z0-062"
                },
                "title": {
                  "type": "string",
                  "description": "e.g. Oracle Database 12c: SQL Fundamentals"
                },
                "website": {
                  "type": "string",
                  "description": "Link to issuing authority's description of exam",
                  "format": "uri"
                },
                "verification": {
                  "type": "string",
                  "description": "External candidate verification URL",
                  "format": "uri"
                },
                  "achievedDate": {
                  "type": "string",
                  "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
                  "format": "date"
                },
                  "score": {
                  "type": "string",
                  "description": "Exam result (PASS/FAIL, 100%, 100)",
                  "format": "date"
                },                "expireDate": {
                  "type": "string",
                  "description": "e.g. 2012-06-29",
                  "format": "date"
                },
                "doesNotExpire": {
                  "type": "boolean",
                  "format": "checkbox"
                }
              }
            }
          },
            "courses": {
            "type": "array",
            "additionalItems": false,
            "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
                "title": {
                  "type": "string",
                  "description": "e.g. Oracle Database 12c: Install and Upgrade Workshop"
                },
                "trainingProvidor": {
                  "type": "string",
                  "description": "Training may be via a third party - Provider's name goes here"
                },
                "providerWebsite": {
                  "type": "string",
                  "description": "Training provider's home page",
                  "format": "uri"
                },
                  "startDate": {
                  "type": "string",
                  "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
                  "format": "date"
                },
                "endDate": {
                  "type": "string",
                  "description": "e.g. 2012-06-29",
                  "format": "date"
                }
              }
            }
          }
        }
      }
    }
  }
}
HazemKhaled commented 9 years ago

+1 here

thomasmktong commented 9 years ago

+1

rsylvian commented 9 years ago

+1

richardkabiling commented 9 years ago

Any update on this?

rsylvian commented 9 years ago

@richardkabiling probably soon : #187

stp-ip commented 9 years ago

I would see courses more under the current education facility. Same as for exams. An exam would more like be a final event after the course is done in my opinion. Therefore an exam could just be an endscore of a course? As discussed in #146 I would say that a string field for the grade/score is too unreadable for machines. I therefore propose the usage of "score": "1.0", "score_best": "1.0", "score_worst": "0.0". In the example of Passed/failed 1 would be 100% and 0 would be 0%. Hope that makes sense. So I think +1 for certification, but -1 for exams and courses except under education.

alexko13 commented 8 years ago

+1

aloisdg commented 8 years ago

I dont really want to see exams. A score is non sense without a context. We could add the mean of the class for example but still.

I am barely ok for the courses too.

olivif commented 8 years ago

maybe I'm misunderstanding here, but is a CV supposed to have this much detail? It seems to me like the exams and scores are a little bit much, it's not a transcript after all.

I am OK with having certifications, I think those are needed. There is also a related PR - #115 :smile:

stp-ip commented 8 years ago

I think we can mostly agree on having certifications as a valuable addition. The how etc. should probably be done. With exams and courses I am not sure yet. I value having the data available, especially when something like #203 is implemented. Than our resume standard could contain the most data possible and one just exports specific "versions" of this data for different purposes.

Considering the case of a student in high school or in university, both have not yet finished their degrees, but were quite successful in a few subjects they wanna now apply for in an internship. Showing their grades within the area of the internship might give them the edge to get it.

Furthermore courses could be a valuable resource to showcase, what you actually did in university as the degree itself can be misleading sometimes.

Hope that makes sense. If we agree on having courses and exams I would see them as a subsection of education. certification should probably have it's own section.

chrisdotcode commented 8 years ago

When does a certification differ from an achievement? Is that for the user to decide?

I feel that winning a nobel prize is an achievement, but also certification-esque. How about certification => awards?

jyounus commented 8 years ago

I'm TCMD certified (Titanium Certified Mobile Developer). It's not an award, it's a certificate for my potential employers to know that I'm certified by Appcelerator and that I can develop mobile apps at a certain standard. I wouldn't consider that as an award.

phumke commented 8 years ago

I think certifications and awards differ and both should be included as separate entities. As per the original schema, a certifying authority or description of the certification should be included as well.

I don't like the idea of including courses and exams, at least for now. For situations where an employer wants that level of detail, include a certified transcript. This could be revisited in the future if there is a need for it.

olivif commented 8 years ago

OK it looks like we agree on parking the course and exams conversation.

Also agree on certifications being included. Now we should probably flesh out the schema. Related PRs are #115 and #139.

aloisdg commented 8 years ago

So we let it go for a next version and focus on v1?

olivif commented 8 years ago

One quick note on this, there is some support for adding specialized vocational/professional/vendor awards as per #178, so let's make sure we cover that in our discussions.

adamczykjac commented 8 years ago

I suggest there should be an option to set expirationDate of a given certificate. Technical certificates like Cisco's, or language IELTS / TOEFL / CAE (for non-native english speakers) indeed have them, after which they have to be renewed.

EDIT: @RobertMortimer just saw you actually included that in your PR. According to http://ux.stackexchange.com/questions/40297/expiry-date-or-expiration-date-label it should be called expiryDate, not expireDate. Why do we need to set up a field doesNotExpire? Wouldn't it be self-explanatory, when the presence of expiryDate field's value indicates that it expires, and the absence that it does not expire?

aloisdg commented 7 years ago

the absence that it does not expire?

Agreed. Absent or set it to null.

thomasdavis commented 7 years ago

Let's bring in certifications for V1. Let's rename some of the fields to suit https://github.com/jsonresume/resume-schema/issues/256.

Maybe not include the granular details though, just name, url, startDate, endDate and maybe summary. Start with a base and we will see how it goes over the next year.

alisterlf commented 7 years ago

+1

lucari93 commented 6 years ago

+1

hypery2k commented 6 years ago

any news on that?

wayneamurphy commented 5 years ago

I can understand somebody out of school wanting to show their exam marks, but after that for other certifications - I would suggest that gets merged and the "awards" section be the "achievements" section (or some other name). Otherwise it might be too specific?

zHaytam commented 4 years ago

Any updates on this?

g13013 commented 4 years ago

Any updates ?

thomasdavis commented 3 years ago

Will be released in v1 soon.