Webmaker/How To Write Projects: Difference between revisions

(Created page with "== How to write up a Mozilla Webmaker project == ===1) Try to start your project title with a *verb*=== Like "Make, Create, Hack, Play, Remix, Design, etc." This is important for...")
 
Line 3: Line 3:
Like "Make, Create, Hack, Play, Remix, Design, etc." This is important for consistency across projects. And also because it reinforces the central theme: this is a place to make cool stuff with the web.
Like "Make, Create, Hack, Play, Remix, Design, etc." This is important for consistency across projects. And also because it reinforces the central theme: this is a place to make cool stuff with the web.
===2) Try to sum up the entire project in one sentence off the top===
===2) Try to sum up the entire project in one sentence off the top===
The first sentence. Then boldface it, as a nutshell right at the top.  
The first sentence. Then boldface it, as a nutshell right at the top.<br>
The project *title*'s main job is to make you want to click. It should be clear, but a little poetry or mystery is ok too. The first sentence's job is different -- it should clearly spell out *exactly* what the heck this is, as plainly and clearly as possible.
The project *title*'s main job is to make you want to click. It should be clear, but a little poetry or mystery is ok too. The first sentence's job is different -- it should clearly spell out *exactly* what the heck this is, as plainly and clearly as possible.<br>
What do you do, make or learn in this project? What does the actual experience consist of? Give it straight, with no poetry or fancy dressing. If it's a project about fixing broken HTML tags, you don't have to say it in the title -- but you should say it in the first sentence.
What do you do, make or learn in this project? What does the actual experience consist of? Give it straight, with no poetry or fancy dressing. If it's a project about fixing broken HTML tags, you don't have to say it in the title -- but you should say it in the first sentence.<br>
 
===3) Don't make it look or sound like it's "for kids."===
===3) Don't make it look or sound like it's "for kids."===
If you do, you may end up turning off the very kids you're trying to attract -- *and* turn off adult novices who may have otherwise been interested as well.  
If you do, you may end up turning off the very kids you're trying to attract -- *and* turn off adult novices who may have otherwise been interested as well.  
Confirmed users
9,624

edits