diff --git a/README.md b/README.md index 16313aa..a3e0480 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,26 @@ FRESCA ====== -*The FRESH Resume & Employment Schema* +*The FRESH Résumé & Employment Schema* -The [FRESH][fresh] resume schema, aka FRESCA, is an open source, standards-friendly, -JSON/YAML-driven standard for resumes / CVs and other employment artifacts. -It establishes an optimized, human-readable, computer-friendly representation -for resume and career data based on JSON or equivalent YAML. +The [FRESH][fresh] résumé schema is an open source, standards-friendly, +JSON/YAML-driven format for résumé / CVs and other employment artifacts. It's +similar to (and compatible with) nascent industry standards like [JSON +Resume][jrs] or [StackOverflow Careers][soc], but optimized for technical +candidates or anyone who likes to geek out over resume and career management +(RACM). + +- [**View the official FRESH reference schema document.**][schema] +- [**View a sample FRESH resume.**][exemplar] + +FRESH is supported as a native format by both [FluentCV Desktop][fluentcv] and +[Command Line][npm]. Additionally, FRESH resumes can be trivially converted to +JRS format, allowing use of the full lineup of JRS tools. + +## What It Does + +FRESCA establishes an optimized, human-readable, computer-friendly +representation for your résumé and career data based on JSON or equivalent +YAML... ```js // Pared-down FRESH/FRESCA resume representation (JSON) @@ -14,46 +29,60 @@ for resume and career data based on JSON or equivalent YAML. "info": { /* Basic info */ }, "contact": { /* Contact information */ }, "location": { /* Location / address */ }, + "meta": { /* Resume metadata */ }, "employment": { /* Employment history */ }, "skills": [ /* Skills and technologies */ ], "education": { /* Schools, training, certifications */ }, "service": { /* Volunteer, military, civilian service */ }, - "writing": { /* Writing, blogging, and publications */ }, - "recognition": { /* Awards and commendations */ }, + "writing": [ /* Writing, blogging, and publications */ ], + "reading": [ /* Books and publication a la StackOverflow Careers */ ], + "speaking": [ /* Writing, blogging, and publications */ ], + "governance": [ /* Board memberships, committees, standards groups */ ], + "recognition": [ /* Awards and commendations */ ], "samples": [ /* Work samples and portfolio pieces */ ], "social": [ /* Social networking & engagement */ ], "references": [ /* Candidate references */ ], "testimonials": [ /* Public candidate testimonials */ ], - "interests": [ /* Interests & hobbies */ ], - "meta": { /* Resume metadata */ } + "extracurricular": [ /* Interests & hobbies */ ], + "interests": [ /* Interests & hobbies */ ] } ``` -FRESCA is compatible with but does not require [FRESH][fresh]. It is an -abstract, standalone representational schema for employment artifacts. FRESCA is -used by [FluentCV][fluentcv], [FCV:CLI][cli], and can be converted to and from -[JSON Resume][jrs] format without losing data. +..which you can use to generate resumes and other career artifacts in specific +concrete formats... -## Contents +- HTML +- Markdown +- LaTeX +- MS Word +- PDF +- YAML +- JSON +- XML +- plain text -The official FRESH reference schema document for standard resumes: +...as well as enable 21st-century analysis of your resume and career data... -- [**/schema/fresh-resume-schema.json**][schema] +![](http://fluentdesk.com/img/fluentcv_desktop.png) -Sample exemplar resumes based on the above schema, in JSON and YAML formats: +...in a way that's not possible with traditional, 20th-century resume formats. -- [**/exemplar/**][exemplar] +## Anatomy of a FRESH Resume -Other files: +FRESCA resumes are: -- `README.md`: This file. -- `package.json`: For installing the FRESH schema as an NPM dependency. -- `bower.json`: For installing FRESH schema as a Bower dependency. -- `LICENSE.md`: MIT license. +- Text-based. +- Versionable. +- Standards-compliant. +- Human-readable/editable. +- Computer-friendly / easily parsable by tools. +- Built from JSON or equivalent YAML. +- Used to generate specific formats like HTML, PDF, or LaTeX. +- Free from proprietary structures or site- and/or tool-specific lock-in. ## License -The FRESH resume schema is licensed under MIT. +The FRESH resume schema is licensed under MIT. Go crazy. [fresh]: https://github.com/fluentdesk/FRESH [schema]: schema/fresh-resume-schema.json @@ -61,3 +90,5 @@ The FRESH resume schema is licensed under MIT. [fluentcv]: http://fluentdesk.com/fluentcv [jrs]: http://jsonresume.org [exemplar]: exemplar +[soc]: http://careers.stackoverflow.com/ +[npm]: https://www.npmjs.com/package/fluentcv diff --git a/bower.json b/bower.json index d58b78b..9358203 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "fresca", - "version": "0.1.1", + "version": "0.2.0", "homepage": "https://github.com/fluentdesk/FRESCA", "authors": [ "devlinjd " diff --git a/exemplar/jane-doe.json b/exemplar/jane-doe.json index 002e9cc..df42a5b 100644 --- a/exemplar/jane-doe.json +++ b/exemplar/jane-doe.json @@ -11,7 +11,8 @@ "label": "Senior Developer / Code Ninja", "characterClass": "Programmer", "brief": "**Full-stack software developer with 6+ years industry experience** specializing in scalable cloud architectures for this, that, and the other. A native of southern CA, Jane enjoys hiking, mystery novels, and the company of Rufus, her two-year-old beagle.", - "image": "jane_doe.png" + "image": "jane_doe.png", + "quote": "Be the change you want to see in the world." }, "contact": { @@ -302,6 +303,19 @@ } ], + "speaking": [ + { + "title": "Data Warehousing Evolved: DARMA 2.0", + "role": "Speaker", + "event": "OPENSTART 2013 Developer's Conference", + "location": "Portland, OR", + "date": "2012", + "highlights": [ + "Won 'Best Presentation on an Emerging Technical Field' prize." + ] + } + ], + "recognition": [ { "flavor": "award", @@ -370,6 +384,49 @@ } ], + "extracurricular": [ + { + "title": "Bay Area Crew Club", + "activity": "", + "location": "San Francisco, CA", + "start": "2014-05" + }, + { + "title": "Organizer / Manager", + "activity": "JavaScript Game Development Meetup", + "location": "Austin, TX", + "start": "2011-03", + "end": "2014-01", + "highlights": [ + "Monthly speaker on creative JavaScript development.", + "Founded group and oversaw growth to 500+ members." + ] + + } + ], + + "governance": [ + { + "flavor": "board", + "role": "Member", + "organization": "The Mommies Network", + "url": "http://themommiesnetwork.org", + "start": "2008-02", + "end": "2010-01", + "summary": "Since 2008 I've been a full-time member of the board of directors for TMN." + }, + { + "flavor": "committee", + "role": "Academic Contributor", + "organization": "Khronos Group", + "url": "https://www.khronos.org", + "start": "2015-01", + "highlights": [ + "Participated in GORFF standardization process (Draft 2)." + ] + } + ], + "interests": [ { "name": "reading", diff --git a/exemplar/jane-doe.yml b/exemplar/jane-doe.yml index 2d933ca..4c7fde6 100644 --- a/exemplar/jane-doe.yml +++ b/exemplar/jane-doe.yml @@ -8,6 +8,7 @@ characterClass: "Programmer" brief: "**Full-stack software developer with 6+ years industry experience** specializing in scalable cloud architectures for this, that, and the other. A native of southern CA, Jane enjoys hiking, mystery novels, and the company of Rufus, her two-year-old beagle." image: "jane_doe.png" + quote: "Be the change you want to see in the world." contact: website: "http://jane-doe.me" phone: "1-650-999-7777" @@ -259,6 +260,15 @@ flavor: "blog" url: "http://www.codinghorror.com" author: "Jeff Atwood" + speaking: + - + title: "Data Warehousing Evolved: DARMA 2.0" + role: "Speaker" + event: "OPENSTART 2013 Developer's Conference" + location: "Portland, OR" + date: "2012" + highlights: + - "Won 'Best Presentation on an Emerging Technical Field' prize." recognition: - flavor: "award" @@ -308,6 +318,38 @@ language: "Spanish" level: "Moderate" years: 10 + extracurricular: + - + title: "Bay Area Crew Club" + activity: "" + location: "San Francisco, CA" + start: "2014-05" + - + title: "Organizer / Manager" + activity: "JavaScript Game Development Meetup" + location: "Austin, TX" + start: "2011-03" + end: "2014-01" + highlights: + - "Monthly speaker on creative JavaScript development." + - "Founded group and oversaw growth to 500+ members." + governance: + - + flavor: "board" + role: "Member" + organization: "The Mommies Network" + url: "http://themommiesnetwork.org" + start: "2008-02" + end: "2010-01" + summary: "Since 2008 I've been a full-time member of the board of directors for TMN." + - + flavor: "committee" + role: "Academic Contributor" + organization: "Khronos Group" + url: "https://www.khronos.org" + start: "2015-01" + highlights: + - "Participated in GORFF standardization process (Draft 2)." interests: - name: "reading" diff --git a/package.json b/package.json index 5aeaa66..2e5a6b4 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "fresca", - "version": "0.1.1", + "version": "0.2.0", "description": "The FRESH schema for resumes and CVs.", "repository": { "type": "git", diff --git a/schema/fresh-resume-schema.json b/schema/fresh-resume-schema.json index 584c4ad..b97d99c 100644 --- a/schema/fresh-resume-schema.json +++ b/schema/fresh-resume-schema.json @@ -49,6 +49,10 @@ "brief": { "type": "string", "description": "A short description or summary of yourself as a candidate." + }, + "quote": { + "type": "string", + "description": "Candidate quote or byline." } } }, @@ -254,6 +258,11 @@ "items": { "type": "string", "description": "For ex, 'Led 5-person development team, increasing profits by 50% year-over-year'." + }, + + "location": { + "type": "string", + "description": "Freeform location of the job or position, e.g., 'San Francisco, CA' or 'Tokyo'." } }, @@ -416,6 +425,11 @@ "type": "string", "description": "For ex, 'Served on board of directors of national non-profit organization with 20,000 members.'." } + }, + + "location": { + "type": "string", + "description": "Freeform location of the position, e.g., 'San Francisco, CA' or 'Tokyo'." } } } @@ -506,6 +520,11 @@ "summary": { "type": "string", "description": "A short summary of this education experience." + }, + + "location": { + "type": "string", + "description": "Freeform location of the education, e.g., 'San Francisco, CA' or 'Tokyo'." } } } @@ -630,7 +649,7 @@ "type": "string", "description": "Publisher of the article, essay, or book." }, - + "url": { "type": "string", "description": "Publisher website or URL." @@ -695,6 +714,100 @@ } }, + "speaking": { + "type": "array", + "additionalItems": false, + "items": { + "type": "object", + "additionalProperties": true, + "properties": { + "title": { + "type": "string", + "description": "Speaking engagement title.", + "required": true + }, + "event": { + "type": "string", + "description": "Event at which you presented." + }, + "location": { + "type": "string", + "description": "Freeform location of the event, e.g., 'San Francisco, CA' or 'Tokyo'." + }, + "date": { + "type": "string", + "description": "Presentation date.", + "format": "date", + "required": true + }, + "highlights": { + "type": "array", + "description": "Noteworthy achievements and/or highlights.", + "additionalItems": false, + "items": { + "type": "string", + "description": "For ex, 'Won 'Best Speaker' award at 2012 E3 expo'." + } + } + } + } + }, + + "governance": { + "type": "array", + "additionalItems": false, + "items": { + "type": "object", + "additionalProperties": true, + "properties": { + + "summary": { + "type": "string", + "description": "Summary of your governance at this organization." + }, + + "flavor": { + "type": "string", + "description": "Type of governance: committee, board, standards group, etc." + }, + + "role": { + "type": "string", + "description": "Governance role: board member, contributor, director, etc." + }, + + "organization": { + "type": "string", + "description": "The organization." + }, + + "start": { + "type": "string", + "description": "Start date.", + "format": "date", + "required": true + }, + + "end": { + "type": "string", + "description": "End date.", + "format": "date" + }, + + "highlights": { + "type": "array", + "description": "Noteworthy achievements and/or highlights.", + "additionalItems": false, + "items": { + "type": "string", + "description": "For ex, 'Led 5-person development team, increasing profits by 50% year-over-year'." + } + } + + } + } + }, + "languages": { "type": "array", "description": "Languages spoken by the candidate.", @@ -867,6 +980,41 @@ } } } + }, + + "extracurricular": { + "type": "array", + "additionalItems": false, + "items": { + "type": "object", + "additionalProperties": true, + "properties": { + "title": { + "type": "string", + "description": "Title of the extracurricular activity." + }, + "activity": { + "type": "string", + "description": "The extracurricular activity." + }, + "location": { + "type": "string", + "description": "City, state, or other freeform location." + }, + "start": { + "type": "string", + "description": "Start date.", + "format": "date", + "required": true + }, + "end": { + "type": "string", + "description": "End date.", + "format": "date" + } + } + } } + } }