Merge pull request #2 from fluentdesk/rel-v0.2.0

Rel v0.2.0

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,50 +29,66 @@ 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
 [cli]: https://www.npmjs.com/package/fluentcv
 [fluentcv]: http://fluentdesk.com/fluentcv
 [jrs]: http://jsonresume.org
 [exemplar]: exemplar
+[soc]: http://careers.stackoverflow.com/
+[npm]: https://www.npmjs.com/package/fluentcv

bower.json

@@ -1,6 +1,6 @@
 {
   "name": "fresca",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "homepage": "https://github.com/fluentdesk/FRESCA",
   "authors": [
     "devlinjd <[email protected]>"

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

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"

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