Rename schema version, update code, docs, & types

 - Change `v0.0.16` to be `legacy` instead of `stable`, have `v1` now
 be `stable`, and keep `beta` just in case there are new features in
 the future
 - Update filenames, comments, code, and types to reflect changes
 - Update popup dropdown

Author: joshuatz

browser-ext/popup.html

@@ -29,9 +29,9 @@
         <div class="specSelectWrapper">
             Select JSONResume version:
             <select id="specSelect">
-                <option value="stable">Stable (v0.0.16)</option>
-                <option value="latest" selected>Latest (v1.0.0)</option>
-                <option value="beta">Beta (v0.1.3 + extra)</option>
+                <option value="legacy">Legacy (v0.0.16)</option>
+                <option value="stable" selected>Stable (v1.0.0)</option>
+                <option value="beta">Currently even with stable (v1.0.0)</option>
             </select>
         </div>
     </div>

browser-ext/popup.js

@@ -11,7 +11,7 @@ const STORAGE_KEYS = {
 };
 const SPEC_SELECT = /** @type {HTMLSelectElement} */ (document.getElementById('specSelect'));
 /** @type {SchemaVersion[]} */
-const SPEC_OPTIONS = ['beta', 'stable', 'latest'];
+const SPEC_OPTIONS = ['legacy', 'stable', 'beta'];
 /** @type {HTMLSelectElement} */
 const LANG_SELECT = document.querySelector('.langSelect');
 

global.d.ts

@@ -1,5 +1,5 @@
-import {ResumeSchemaStable as _ResumeSchemaStable} from './jsonresume.schema.stable';
-import {ResumeSchemaLatest as _ResumeSchemaLatest, ResumeSchemaBeyondSpec as _ResumeSchemaBeyondSpec} from './jsonresume.schema.latest';
+import {ResumeSchemaLegacy as _ResumeSchemaLegacy} from './jsonresume.schema.legacy';
+import {ResumeSchemaStable as _ResumeSchemaStable, ResumeSchemaBeyondSpec as _ResumeSchemaBeyondSpec} from './jsonresume.schema.latest';
 
 declare global {
     interface GenObj {
@@ -138,9 +138,9 @@ declare global {
         }
     }
 
-    type SchemaVersion = 'stable' | 'latest' | 'beta';
+    type SchemaVersion = 'legacy' | 'stable' | 'beta';
 
+    type ResumeSchemaLegacy = _ResumeSchemaLegacy;
     type ResumeSchemaStable = _ResumeSchemaStable;
-    type ResumeSchemaLatest = _ResumeSchemaLatest;
     type ResumeSchemaBeyondSpec = _ResumeSchemaBeyondSpec;
 }

jsonresume.schema.latest.ts

@@ -1,12 +1,13 @@
 /**
- * @file Represents the latest version of the schema that I'm willing to support / implement
+ * @file Represents the current version(s) of the schema
  *   - Currently v1.0.0
  * @see https://github.com/jsonresume/resume-schema/blob/v1.0.0/schema.json
  *  - Permalink of above: https://github.com/jsonresume/resume-schema/blob/8a5b3982f8e5b9f8840398e162a6e0c418d023da/schema.json
  */
 
 // All of these imports are because the spec is the same for the sub-section in both stable and latest (this doc)
-import {Iso8601, Award, Location, Profile, Interest, Language, Reference, Skill, ResumeSchemaStable} from './jsonresume.schema.stable';
+import {Iso8601, Award, Location, Profile, Interest, Language, Reference, Skill, ResumeSchemaLegacy} from './jsonresume.schema.legacy';
+
 // Re-export
 export {
     Iso8601,
@@ -155,14 +156,14 @@ export interface Project {
     url?: string;
 }
 
-export type Publication = Omit<ResumeSchemaStable['publications'][0], 'website'> & {
+export type Publication = Omit<ResumeSchemaLegacy['publications'][0], 'website'> & {
     /**
      * e.g. http://www.computer.org.example.com/csdl/mags/co/1996/10/rx069-abs.html
      */
     url?: string;
 }
 
-export type Volunteer = Omit<ResumeSchemaStable['volunteer'][0], 'website'> & {
+export type Volunteer = Omit<ResumeSchemaLegacy['volunteer'][0], 'website'> & {
     /**
      * e.g. https://www.eff.org/
      */
@@ -202,7 +203,7 @@ export interface Work {
     url?: string;
 }
 
-export interface ResumeSchemaLatest {
+export interface ResumeSchemaStable {
     /**
      * link to the version of the schema that can validate the resume
      */
@@ -243,6 +244,7 @@ export interface ResumeSchemaLatest {
     work?:      Work[];
 }
 
-export interface ResumeSchemaBeyondSpec extends ResumeSchemaLatest {
-    certificates: Certificate[];
-}
+/**
+ * Currently even - nothing beyond v1
+ */
+export interface ResumeSchemaBeyondSpec extends ResumeSchemaStable {}

jsonresume.schema.stable.ts jsonresume.schema.legacy.ts

@@ -258,7 +258,7 @@ export interface Work {
     website?: string;
 }
 
-export interface ResumeSchemaStable {
+export interface ResumeSchemaLegacy {
     /**
      * Specify any awards you have received throughout your professional career
      */