How To Help With Show Notes
TWiT viewers and listeners are encouraged to help with show notes. It's much appreciated because staff and hosts don't always have time to do so for each show.
Particularly of need is links to articles or websites mentioned in each episode. Some the hosts outline in advance, but some are spoken about spontaneously and viewers may wish to find them later.
NOTE: Due to spam issues, new users are not permitted to add new pages. Go to http://twit.tv/wikiform and fill out the form.
Learning About Wiki Editing
Also, bullet points are made with an asterisk *. Subheads are made with two asterisks **.
When To Edit Show Notes?
There's basically three times to edit show notes: Before live taping, during live taping, and after live taping.
Before Live Taping
Many shows have an outline ready beforehand. Sometimes, as in the case of Windows Weekly, a designated community member like Sharp65 will be sent those notes by the host, and post them even before the show begins recording.
During Live Taping
The most helpful system by far is to have one or two regular TWiT Live viewers assign themselves (unofficial) ownership of a particular show and update the links while the show is in progress. This way the links can be included in the feed and on the web page when the final edited version of the show goes live. It's also helpful if these self-assigned show note takers coordinate with each other so as to not duplicate efforts.
Even if the outline is already posted before the show, it's helpful to have someone take notes during the show to record any spontaneous links or topics that are mentioned.
After Live Taping
While most podcasts are recorded live on http://live.twit.tv, they're finalized only when they come out in an edited podcast form. At this point, the show notes might already be completed (or they might not). Even if there have been a number of notes, those listening to the podcast are always welcome and encouraged to refine the wiki show notes for accuracy. If you're coordinating efforts with another show note taker, you might wish to have one of you listen to the show after it's released as a podcast just to add any other relevant links or tidy up spelling.
Anonymous Or By Name?
If you're a regular show note taker and/or contributor to the wiki or community in general, it's probably helpful for you to make edits while logged in, so your entries have greater credibility for those looking at a particular page's history.
However, anyone, whether logged in or not, can modify anyone else's work, as long as they strive for accuracy and follow the wiki's rules.
Editing With Someone Else At The Same Time
If you're editing a wiki page at the same time as another community member, it can create version control problems that are a pain for you and the other person. It's best to just have one person edit at a time. If you see that changes have been made since the last time you saved, then someone else is also editing the page. There's a few of ways to solve this:
- Make edits and save really quickly, and/or
- Make your edits to a separate text file and update later, and/or
- Stop editing, and/or
- Communicate with the other editor via his or her "Talk" page and coordinate your efforts for that day or longer term.
Starting A Show Note Page
You might be the first person to create a page. This can be done before or after the show has begun taping. Here are the steps:
- Find the show note page for the previous episode.
- To find the show note page of the previous page, go to the wiki home page , then Show Name->Show Notes (at bottom of infobox on right side of page). You'll then come to a page of show notes. Click on the most recent episode listed. This is possibly the most recent episode, and will have a URL that looks like one of these, only with a different number at the end.
Shownotes Naming Convention
- Is the episode at the top of the page the actual most recent episode? Maybe, maybe not. To find out for sure, keep adding one to the episode number (193 becomes 194, and so on) until you come to a blank page that might look like this dummy page. If the last page you looked at was within the last week, you've likely found the latest episode.
- Click on "edit this page."
- You'll see some links under Show Notes to "New_Showname." Click on the showname that applies.
- If you'll scroll down the page, you'll see the guts of a dummy page, with many fields pre-filled.
- After you've made an entry in the first field, click save. You've now created a new episode page you can work on. If you made a mistake in opening a page, but haven't yet saved, the new page will not be created. And if you do make the wrong page, they can be deleted, so don't fret yourself (but don't go making pages willy-nilly, either).
Editing A Show Note Page That's Already Been Created
- Click on the "edit" tab at the top. You're now ready to begin editing.
Edit The Episode Number
- The number of an old episode is in some of the templates. That needs to be updated each time.
- If you just have a couple of notes to add, and can't do the show, that's fine. And even if you're formatting isn't quite perfect, that's fine, too, although you should do your best by checking the formatting guidelines at the top of this page. But there as number of people who use the wiki and they can help.
Links To Stories
- The most important thing Leo wants on show note pages is links to stories and websites. Editorial comments, or topics that don't have links, are also good, but are of secondary importance.
- Some shows have specific places where some links are listed. TWiT uses http://delicious.com/twit/### where ### is the number of the episode. So here would be the stories for episode 195. MacBreak Weekly goes to http://mbwideas.com, This Week in Law goes to http://delicious.com/twil. Some fan sites are great resources as well. http://insidedgw.vox.com/ and http://www.gizwizsearch.com/ are amazing resources of already-taped episodes of the Daily Giz Wiz, as is http://mbwpicks.com for MacBreak Weekly. Host blogs can also a good resource, such as http://www.winsupersite.com for Paul Thurrott of Windows Weekly or http://gizwiz.biz for Dick DeBartolo/The Daily Giz Wiz. But it depends.
- If the links are not listed on one of these pages, then go to http://news.google.com and search for the relevant topic. Use the most reliable, relevant and timely source, using your best judgment.
How To Link To Stories
- Organize links by using asterisks as bullet points. A double asterisk makes a subhead.
- For current news stories, copy the full text of the headline and link to that.
- For websites, link the URL to the name of the website (spelling it like the website spells it).
- If you're linking to an old news article, just linking to relevant few words instead of the article's title (example: When Neil Armstrong landed on the moon)
Link To People
- The first link to anyone's name gets double brackets, [[Firstname Lastname]], which links them to their page on this wiki, if they have one, like this: Leo Laporte
- It's also customary to link to a panelist or guest blog.
- It's optional to link to a panelist or guest Twitter account. The appropriate syntax is to link to their Twitter username like this: [http://twitter.com/leolaporte @leolaporte], which looks like this: @leolaporte.
- Update the day the show is recorded live (Pacific Time) under "Recorded Date"
- Update the day it is published under "Published Date." This is the date announceD at the opening of final podcast version of the show. If there is no date, it's the date listed on that episode's page on TWiT.tv
Correct Other People's Links
- If you see a link or text that is wrong in the wiki, please fix it.
- If it helps to see who edited the show before you, check the "history" tab at the top of the page. If you need to communicate with one of the editors, click on the "Talk" link after their username/handle, and write on that page. When you do write on their page, please log in and type in ~~~~ after your entry so your name will automatically be entered.
- Update or modify almost anything that needs it, other than "Production Notes," which is just for TWiT staff to edit.
Creating a Show Notes Template
On the create page, you'll notice a number of links to create pages for specific shows. However, some newer shows do not yet have templates. If you've noticed that a new show does not have a template, here's a guide to creating them.