",
@@ -986,6 +708,7 @@
"id": "bd7158d9c436eddfadb5bd3b",
"name": "What is the Free Code Camp Front End Development Certificate?",
"dashedName": "what-is-the-free-code-camp-front-end-development-certificate",
+ "category": "orientation",
"description": [
"
",
"
We're creating a free Front End Development Certificate.
",
diff --git a/seed/field-guides/outreach.json b/seed/field-guides/outreach.json
new file mode 100644
index 0000000000..154c93d44c
--- /dev/null
+++ b/seed/field-guides/outreach.json
@@ -0,0 +1,143 @@
+[
+ {
+ "id": "bd7158d9c436eddfaeb5bd3b",
+ "name": "How can I stream my live coding sessions on Free Code Camp's Twitch.tv channel?",
+ "dashedName": "how-can-i-stream-my-live-coding-sessions-on-free-code-camps-twitch-tv-channel",
+ "category": "outreach",
+ "description": [
+ "
",
+ "
If you're interested in coding JavaScript live in front of dozens of people on our popular twitch.tv channel, we'd love to have you.
",
+ "
Please follow these steps to get started:
",
+ "
",
+ "
",
+ " - Follow this tutorial to set up your computer for streaming.
",
+ " - Contact Jason Ruekert - he's @jsonify in Gitter. He's in charge of our Twitch.tv channel. Tell him what you'd like to stream, and when you're available to stream.
",
+ " - Jason will pair with you using Screenhero to verify your computer is configured properly to stream.
",
+ "
",
+ " ",
+ "
Be respectful of your audience. Everything you stream should be related to coding JavaScript, and should be acceptable for children. (Yes, children do sometimes watch our Twitch stream to learn to code).
",
+ "
While you're streaming, keep the chat room open so you can respond to questions from your viewers. If someone follows Free Code Camp on Twitch, try to thank them.
",
+ "
If you do a good job, we'll invite you back to stream some more. Who knows, you might become one of our regular streamers!
",
+ "
"
+ ]
+ },
+ {
+ "id": "bd7158d9c446eddfaeb5bdef",
+ "name": "How do Free Code Camp's Nonprofit Projects work?",
+ "dashedName": "how-do-free-code-camps-nonprofit-projects-work",
+ "category": "outreach",
+ "description": [
+ "
",
+ "
Building nonprofit projects is the main way that our campers learn full stack JavaScript and agile software development. Once you complete the Free Code Camp Waypoints, Bonfires, Ziplines and Basejumps, you'll begin this process.
",
+ "
Starting with the end in mind
",
+ "
Our goal at Free Code Camp is to help you land a job as a junior software developer (or, if you prefer, a 'pivot job' that leads your current career in a more technical direction).
",
+ "
You'll continue to work on nonprofit projects until you've built a sufficiently impressive portfolio and references to start your job search. Your portfolio will ultimately have three to five nonprofit projects. We estimate that the 900 hours of nonprofit projects you're going to complete, in addition to the 100 hours of challenges you've already completed, will be enough to qualify you for your first coding job. This will produce a much broader portfolio than a traditional coding bootcamp, which generally only has one or two capstone projects.
",
+ "
Choosing your first Nonprofit Project
",
+ "
We've categorized all the nonprofit projects by estimated time investment per camper: 100 hours, 200 hours, and 300 hours. These are only rough estimates.
",
+ "
Example: if you and the camper you're paired up with (your pair) each stated you could work 20 hours per week. If the project is a 100 hour per camper project, you should be able to complete it in about 5 weeks.
",
+ "
Our Nonprofit Project team will match you and your pair based on:
",
+ "
",
+ "
",
+ " - Your estimated time commitment (10, 20 or 40 hours per week)
",
+ " - Your time zone
",
+ " - The nonprofit projects you've chosen
",
+ " - Prior coding experience (we'd like both campers to be able to contribute equally)
",
+ "
",
+ " ",
+ "
We won't take age or gender into account. This will provide you with valuable experience in meshing with diverse teams, which is a reality of the contemporary workplace.
",
+ "
You'll only work on one project at a time. Once you start a nonprofit project, we'll remove you from all other nonprofit project you've expressed interest in. There's a good chance those projects will no longer be available when you finish your current project, anyway. Don't worry, though - we get new nonprofit project requests every day, so there will be plenty more projects for you to consider after you finish your current one.
",
+ "
Finalizing the Project
",
+ "
Before you can start working on the project, our team of Nonprofit Project Coordinators will go through the following process:
",
+ "
",
+ "
",
+ " - We'll wait until there are two campers who have chosen the same project and look like they're a good match for one another based on the factors mentioned above.
",
+ " - We'll call the stakeholder to confirm once again that he or she agrees with our terms and has signed our Nonprofit Project Stakeholder Pledge.
",
+ " - We'll set an initial meeting with representatives from Free Code Camp, the two campers, and the stakeholder.
",
+ " - If the stakeholder and both campers shows up promptly, and seem enthusiastic and professional, we'll start the project.
",
+ "
",
+ " ",
+ "
This lengthy process serves an important purpose: it reduces the likelihood that any of our campers or stakeholders will waste their precious time.
",
+ "
Nonprofit Stakeholders
",
+ "
Each nonprofit project was submitted by a nonprofit. A representative from this nonprofit has agreed to serve as a \"stakeholder\" - an authorative person who understands the organization and its needs for this particular project.
",
+ "
Stakeholders have a deep understanding of their organizations' needs. Campers will work with them to figure out the best solutions to these needs.
",
+ "
When you and your pair first speak with your nonprofit stakeholder, you'll:
",
+ "
",
+ "
",
+ " - talk at length to better understand their needs.
",
+ " - create a new Trello board and use it to prioritize what needs to be built.
",
+ " - and establish deadlines based on your weekly time commitment, and how long you think each task will take.
",
+ "
",
+ " ",
+ "
It's notoriously difficult to estimate how long building software projects will take, so feel free to ask our volunteer team for help.
",
+ "
You'll continue to meet with your stakeholder at least twice a month in your project's Gitter or Slack channel.
",
+ "
You should also ask questions in your project's Gitter or Slack channel as they come up throughout the week, and your stakeholder can answer them asynchronously.
",
+ "
Getting \"blocked\" on a task can take away your sense of forward momentum, so be sure to proactively seek answers to any ambiguities you encounter.
",
+ "
Ultimately, the project will be considered complete once both the stakeholder's needs have been met, and you and your pair are happy with the project. Then you can add it to your portfolio!
",
+ "
Working with your Pair
",
+ "
You and your pair will pair program (code together on the same computer virtually) about half of the time, and work independently the other half of the time.
",
+ "
Here are our recommended ways of collaborating:
",
+ "
",
+ "
",
+ " - • Gitter has robust private messaging functionality. It's the main way our team communicates, and we recommend it over email.
",
+ " - • Trello is great for managing projects. Work with your stakeholder to create Trello cards, and update these cards regularly as you make progress on them.
",
+ " - • Screenhero or Team Viewer - These are the ideal way to pair program. Tools like TMUX are good, but difficult to use. We discourage you from using screen sharing tools where only one person has control of the keyboard and mouse - that isn't real pair programming.
",
+ " - • Write clear and readable code, commit messages, branch names, and pull request messages.
",
+ "
",
+ " ",
+ "
Hosting Apps
",
+ "
Unless your stakeholder has an existing modern host (AWS, Digital Ocean), you'll need to transition them over to a new platform. We believe Heroku is the best choice for a vast majority of web projects. It's free, easy to use, and has both browser and command line interfaces. It's owned by Salesforce and used by a ton of companies, so it's accountable and unlikely to go away.
",
+ "
If you need help convincing your stakeholder that Heroku is the ideal platform, we'll be happy to talk with them.
",
+ "
Maintaining Apps
",
+ "
Once you complete a nonprofit project, your obligation to its stakeholder is finished. Your goal is to leave behind a well documented solution that can be easily maintained by a contract JavaScript developer (or even a less-technical \"super user\").
",
+ "
While you will no longer need to help with feature development, we encourage you to consider helping your stakeholder with occasional patches down the road. After all, this project will be an important piece of your portfolio, and you'll want it to remain in good shape for curious future employers.
",
+ "
Pledging to finish the project
",
+ "
Your nonprofit stakeholder, your pair, and our volunteer team are all counting on you to finish your nonprofit project. If you walk away from an unfinished nonprofit project, you'll become ineligible to ever be assigned another one.
",
+ "
To confirm that you understand the seriousness of this commitment, we require that all campers sign this pledge before starting on their nonprofit projects.
",
+ "
There will likely be times of confusion or frustration. This is normal in software development. The most important thing is that you do not give up and instead persevere through these setbacks. As Steve Jobs famously said, \"Real artists ship.\" And you are going to ship one successful nonprofit project after another until you feel ready to take the next step in your promising career.
",
+ "
"
+ ]
+ },
+ {
+ "id": "bd7158d9c436eddfadb5bd3e",
+ "name": "How can I contribute to this guide?",
+ "dashedName": "how-can-i-contribute-to-this-guide",
+ "category": "outreach",
+ "description": [
+ "
",
+ "
Contributing to our field guide is a great way to establish your history on GitHub, add to your portfolio, and help other campers. If you have a question about JavaScript or programming in general that you'd like us to add to the field guide, here are two ways to get it into the guide:
",
+ "
",
+ "
",
+ " - You can message @danraley on Gitter with your question.
",
+ " - You can also contribute to this field guide directly via GitHub pull request, by cloning Free Code Camp's main repository and modifying field-guides.json.
",
+ "
",
+ " ",
+ "
"
+ ]
+ },
+ {
+ "id": "bd7158d9c436eddfadb5bd32",
+ "name": "How can I help the Free Code Camp translation effort?",
+ "dashedName": "how-can-i-help-the-free-code-camp-translation-effort",
+ "category": "outreach",
+ "description": [
+ "
",
+ "
Our translation effort is driven by bilingual campers like you.",
+ "
If you're able to help us, you can join our Trello board by sending @quincylarson your email address on Gitter.
",
+ "
"
+ ]
+ },
+ {
+ "id": "bd7158d9c436eddfadb5bd31",
+ "name": "What if I speak a language that Free Code Camp does not yet support?",
+ "dashedName": "what-if-i-speak-a-language-that-free-code-camp-does-not-yet-support",
+ "category": "outreach",
+ "description": [
+ "
",
+ "
Translation is an all-or-nothing proposal.",
+ "
We won't be able to add new languages to Free Code Camp until all of our challenges are translated into that language.
",
+ "
In addition to translating these initially, we'll also need to maintain the translation as the challenges are gradually updated.
",
+ "
If you're able to help us, you can join our Trello board by sending @quincylarson your email address on Gitter.
",
+ "
"
+ ]
+ }
+]
diff --git a/seed/index.js b/seed/index.js
index a4c5dcb2ec..7ca17f5174 100644
--- a/seed/index.js
+++ b/seed/index.js
@@ -4,16 +4,20 @@ require('dotenv').load();
var fs = require('fs'),
path = require('path'),
app = require('../server/server'),
- fieldGuides = require('./field-guides.json'),
nonprofits = require('./nonprofits.json'),
jobs = require('./jobs.json');
+function getFilesFor(dir) {
+ return fs.readdirSync(path.join(__dirname, '/' + dir));
+}
+
var Challenge = app.models.Challenge;
var FieldGuide = app.models.FieldGuide;
var Nonprofit = app.models.Nonprofit;
var Job = app.models.Job;
var counter = 0;
-var challenges = fs.readdirSync(path.join(__dirname, '/challenges'));
+var challenges = getFilesFor('challenges');
+var fieldGuides = getFilesFor('field-guides');
var offerings = 3 + challenges.length;
var CompletionMonitor = function() {
@@ -33,10 +37,10 @@ Challenge.destroyAll(function(err, info) {
} else {
console.log('Deleted ', info);
}
- challenges.forEach(function (file) {
+ challenges.forEach(function(file) {
Challenge.create(
require('./challenges/' + file).challenges,
- function (err) {
+ function(err) {
if (err) {
console.log(err);
} else {
@@ -54,14 +58,16 @@ FieldGuide.destroyAll(function(err, info) {
} else {
console.log('Deleted ', info);
}
- FieldGuide.create(fieldGuides, function(err, data) {
- if (err) {
- console.log(err);
- } else {
- console.log('Saved ', data);
- }
- CompletionMonitor();
- console.log('field guides');
+ fieldGuides.forEach(function(file) {
+ FieldGuide.create(require('./field-guides/' + file), function(err, data) {
+ if (err) {
+ console.log(err);
+ } else {
+ console.log('Saved ', data);
+ }
+ CompletionMonitor();
+ console.log('field guides');
+ });
});
});
diff --git a/server/utils/index.js b/server/utils/index.js
index ec64435a5f..9f2ff3dcc9 100644
--- a/server/utils/index.js
+++ b/server/utils/index.js
@@ -9,8 +9,17 @@ var path = require('path'),
MDNlinks = require('../../seed/bonfireMDNlinks'),
resources = require('./resources.json'),
- nonprofits = require('../../seed/nonprofits.json'),
- fieldGuides = require('../../seed/field-guides.json');
+ nonprofits = require('../../seed/nonprofits.json');
+
+var fieldGuides = fs.readdirSync(
+ path.join(__dirname, '../../seed/field-guides')
+ )
+ .map(function(file) {
+ return require('../../seed/field-guides/' + file);
+ })
+ .reduce(function(allGuides, categoryGuides) {
+ return allGuides.concat(categoryGuides);
+ }, []);
/**
* Cached values
@@ -38,15 +47,15 @@ Array.zip = function(left, right, combinerFunction) {
path.join(__dirname, '../../seed/challenges')
);
var keyCounter = 0;
- files = files.map(function (file) {
+ files = files.map(function(file) {
return require(
path.join(__dirname, '../../seed/challenges/' + file)
);
});
- files = files.sort(function (a, b) {
+ files = files.sort(function(a, b) {
return a.order - b.order;
});
- files.forEach(function (file) {
+ files.forEach(function(file) {
localChallengeMap[keyCounter++] = file;
});
challengeMap = _.cloneDeep(localChallengeMap);
@@ -66,10 +75,10 @@ module.exports = {
return ('' + name).replace(/\-/g, ' ').trim();
},
- getChallengeMapForDisplay: function () {
+ getChallengeMapForDisplay: function() {
if (!challengeMapForDisplay) {
challengeMapForDisplay = {};
- Object.keys(challengeMap).forEach(function (key) {
+ Object.keys(challengeMap).forEach(function(key) {
challengeMapForDisplay[key] = {
name: challengeMap[key].name,
dashedName: challengeMap[key].name.replace(/\s/g, '-'),
@@ -81,11 +90,11 @@ module.exports = {
return challengeMapForDisplay;
},
- getChallengeMapWithIds: function () {
+ getChallengeMapWithIds: function() {
if (!challengeMapWithIds) {
challengeMapWithIds = {};
- Object.keys(challengeMap).forEach(function (key) {
- var onlyIds = challengeMap[key].challenges.map(function (elem) {
+ Object.keys(challengeMap).forEach(function(key) {
+ var onlyIds = challengeMap[key].challenges.map(function(elem) {
return elem.id;
});
challengeMapWithIds[key] = onlyIds;
@@ -94,11 +103,11 @@ module.exports = {
return challengeMapWithIds;
},
- allChallengeIds: function () {
+ allChallengeIds: function() {
if (!allChallengeIds) {
allChallengeIds = [];
- Object.keys(this.getChallengeMapWithIds()).forEach(function (key) {
+ Object.keys(this.getChallengeMapWithIds()).forEach(function(key) {
allChallengeIds.push(challengeMapWithIds[key]);
});
allChallengeIds = R.flatten(allChallengeIds);
@@ -106,12 +115,12 @@ module.exports = {
return allChallengeIds;
},
- getChallengeMapWithNames: function () {
+ getChallengeMapWithNames: function() {
if (!challengeMapWithNames) {
challengeMapWithNames = {};
Object.keys(challengeMap).
- forEach(function (key) {
- var onlyNames = challengeMap[key].challenges.map(function (elem) {
+ forEach(function(key) {
+ var onlyNames = challengeMap[key].challenges.map(function(elem) {
return elem.name;
});
challengeMapWithNames[key] = onlyNames;
@@ -124,8 +133,8 @@ module.exports = {
if (!challengeMapWithDashedNames) {
challengeMapWithDashedNames = {};
Object.keys(challengeMap).
- forEach(function (key) {
- var onlyNames = challengeMap[key].challenges.map(function (elem) {
+ forEach(function(key) {
+ var onlyNames = challengeMap[key].challenges.map(function(elem) {
return elem.dashedName;
});
challengeMapWithDashedNames[key] = onlyNames;
@@ -135,40 +144,40 @@ module.exports = {
},
- randomPhrase: function () {
+ randomPhrase: function() {
return resources.phrases[
Math.floor(Math.random() * resources.phrases.length)
];
},
- randomVerb: function () {
+ randomVerb: function() {
return resources.verbs[
Math.floor(Math.random() * resources.verbs.length)
];
},
- randomCompliment: function () {
+ randomCompliment: function() {
return resources.compliments[
Math.floor(Math.random() * resources.compliments.length)
];
},
- allFieldGuideIds: function () {
+ allFieldGuideIds: function() {
if (allFieldGuideIds) {
return allFieldGuideIds;
} else {
- allFieldGuideIds = fieldGuides.map(function (elem) {
+ allFieldGuideIds = fieldGuides.map(function(elem) {
return elem.id;
});
return allFieldGuideIds;
}
},
- allFieldGuideNamesAndIds: function () {
+ allFieldGuideNamesAndIds: function() {
if (allFieldGuideNames) {
return allFieldGuideNames;
} else {
- allFieldGuideNames = fieldGuides.map(function (elem) {
+ allFieldGuideNames = fieldGuides.map(function(elem) {
return {
name: elem.name,
dashedName: elem.dashedName,
@@ -179,18 +188,18 @@ module.exports = {
}
},
- allNonprofitNames: function () {
+ allNonprofitNames: function() {
if (allNonprofitNames) {
return allNonprofitNames;
} else {
- allNonprofitNames = nonprofits.map(function (elem) {
+ allNonprofitNames = nonprofits.map(function(elem) {
return {name: elem.name};
});
return allNonprofitNames;
}
},
- whichEnvironment: function () {
+ whichEnvironment: function() {
return process.env.NODE_ENV;
},
![](\"https://www.evernote.com/l/AHRIBndcq-5GwZVnSy1_D7lskpH4OcJcUKUB/image.png\")
",
+ "