Presterity Bookmark Style Guide

Please follow these guidelines carefully when creating bookmarks. These instructions assume you have already created a Raindrop account.

Please read all of this — it all matters! And it helps us approve your work quickly.

Submit events, not opinions, overviews, or long pieces

For the time being, we're focused on using bookmarks to capture news of noteworthy events in the Trump administration. We want to be sure we're capturing a comprehensive, chronological timeline of all events of interest. Events are organized by topic on the Presterity site, and each page shows a Timeline section listing the events related to that topic.

The Presterity site includes additional material, but we're not yet set up to receive public submissions of other types yet.

(Note: During the initial creation of the Presterity site, some opinion pieces and other types of articles were added as timeline events. We are reviewing that existing material to bring all of it into compliance with these guidelines. For now, please do as we say, not as we do.)

Use reliable sources

Since most events will be covered online in a variety of sources, try to find the most reputable source possible.

  • Please turn to high-quality, top-tier publications with solid reputations, such as the New York Times, the Washington Post, the Guardian, and the Atlantic. Certain other publications like Teen Vogue have also established themselves as providing solid journalism with a skeptical eye towards the Trump administration.
  • If the event has not been widely reported, an article from other publications is acceptable.
  • When possible, avoid publications with a deliberate political slant, such as the Huffington Post, MSNBC or Fox News. Those organizations may publish accurate news stories, but they are polarizing entities. We'd prefer to find more neutral publications when possible.
  • If one publication's article is primarily drawing attention to an original article posted on a different site, submit the original article.

Filling out bookmark details in Raindrop

Using the process described in the Submissions instructions, you start the bookmark process on a news site. Rather than filling out the bookmark details at that point, it's best to save new bookmarks to your Unsorted folder, then work on the bookmarks in Raindrop.

Open the Raindrop web app at https://raindrop.io, select a bookmark you've created, then open it for editing:

During the editing process, please fill out the Tags, Title, and Description fields as described below.

Adding bookmark tags to match Presterity page titles

Each bookmark is tagged with one or more page titles. This is how the bookmark becomes part of the Presterity page. You need to use the page title exactly as it appears on Presterity:

  • Match singular/plural words. A bookmark tagged "Conflict of Interest" (singular "conflict") won't match the title of the "Conflicts of Interest" (plural) page.
  • Match letter case. A bookmark tagged "Conflict of interest" (lowercase "i") won't match the "Conflicts of Interest" (capital "I") page.
  • Do not start tags with a "#" sign. Raindrop will show a "#" in front of your tags in certain windows, but don't type the "#" yourself. Type "Ivanka Trump", not "#Ivanka Trump".
  • In the example above, the page titles "Russian Involvement in the 2016 Election" and "Russia" have been entered as tags, so this will appear in both of those pages. Bookmark tags can include spaces: it's "Conflicts of Interest", not conflictsofinterest. As noted above, the page titles have to be entered exactly as they appear on the Presterity site.
  • Just pick a few good tags.
  • If you're adding a tag for a specific page that's nested beneath a more general page in our Table of Contents, you don't need to also tag the more general page. Example: The "Russia" page tagged above is inside the more general "Foreign Policy" page, so "Foreign Policy" doesn't need to also be tagged on this bookmark.

To add a bookmark with Raindrop

These instructions assume you have one of the Raindrop extensions installed in your browser. You can also add bookmarks using the Raindrop web site at http://raindrop.io.

  1. In your browser, find a news article or post worth adding to an existing topic page in Presterity.
  2. Click the Raindrop button in your browser toolbar. (It looks like a gray cloud.)
  3. A small window will open in the corner of the browser window to let you fill out the bookmark details:
  4. Select "Presterity" from the list of folders.
  5. Enter a Title for the bookmark. This is how the link will appear on the topic pages.
    1. Do start the bookmark Title with a date. (e.g. 2017.01.18)
    2. Do use the rest of the Title to provide a great lede. See below.
    3. Delete the description that appears below.
  6. Once you're done filling out the bookmark details, you can either click the Raindrop toolbar button (the little cloud icon) again, or click somewhere on the page outside the window. The bookmark will be saved.
  7. The bookmarked link will now appear on the pages you tagged. To check this, open one of the pages on the public https://presterity.org site. (The link won't appear when you view the page on the wiki.) The bookmark you added should appear on the page almost immediately after you create it. If you don't see it, holler on the Slack channel.
  8. If you need to edit the bookmark details, add/change tags, etc., you can do so through the Raindrop app at http://raindrop.io.

Start your bookmark title with a date

Each bookmark title should include the date of the event. Put this at the start of the title. (There's no separate "Date" field.)

  1. Use the date the event happened. This may be earlier than the date of the article.
  2. Use a year.month.day format. January 11, 2017 is "2017.01.11". The year should be four digits.
  3. Include leading zeros for single digit days or months.
  4. You can type just a year and month ("2017.01") if you don't know the specific day, or even just the year ("2017") if you don't know the month either.

A good bookmark title is the lede, not a headline

Write your bookmark titles to express the most central, core idea captured by your source.

Journalists call this the lede. The best place to quickly find a lede is to look in the article's opening sentence. You can often start your writing with a headline, but be aware that news articles often rely on a subhead or the opening paragraph of an article to provide critical details. You need to pack everything into a single title.

  1. Describe the event and its importance as concisely as possible.
  2. Use the present tense. If the article says, "Trump conceded ...", change that to, "Trump concedes". This helps keep tenses consistent when viewing a long list of links.
  3. Use the active voice. Most news events are the result of a person doing something. Identify that person as the subject of your title.
    1. If the subject of the sentence is Trump, just write "Trump", not "Donald Trump" or "President Trump".
  4. Use sentence capitalization. Most headlines use title capitalization, which you'll need to rewrite as a sentence.
  5. End the sentence with a period or other final punctuation. Headlines never include terminal punctuation, so you'll need to add it.
  6. Include the vital context of the event. News headlines assume the reader has general knowledge of the situation. But a headline like, "Senators Object to Latest Scandal," means very little in retrospect, or to someone who has not been following that story. Your title must stand on its own as a concise summary of a historical event.
  7. No clickbait. Headlines or page titles are often meant to grab attention, then fill in the details later. Again, you'll want your link title to stand on its own.
  8. Don't cite the news source in your title. That will be automatically inferred from the URL. Many bookmarked pages will include the name of the site; remove it.
  9. If the event is that someone said something, make the quotation the bulk of the title. Start the bookmark title with the speaker's name followed by a colon ("Reince Preibus: "), then put the quotation in quotes. If it's Trump speaking, start with "Trump: ".
  10. Keep the title to a single sentence. If you have a more information you'd like to include with the link, put it in the Description field (below).

Writing a good title can take a few minutes, some careful thought, and some work. Your work is in, in fact, what gives Presterity its core value: converting the torrent of news into a coherent, meaningful, historical reference.

Titles for bookmarked tweets have their own special rules; see below.

Only use the Description field for important additional details

Raindrop will often include additional information by default in the Description field.

  1. Remove the Description unless it adds critical information or context to the event that cannot be easily packaged into as a single sentence into the Title.
  2. Your bookmark will be presented in a timeline that must be concise to be easily readable, so little or no Description is better.
  3. The people reading your bookmark on Presterity's can always follow the link to the original article for complete details.

Bookmark screenshots or images are not necessary

Raindrop includes a field for a screenshot or image. Ignore that; we don't use it.

To bookmark a tweet with Raindrop

We have special conventions for adding tweets as bookmarks:

  1. Open the tweet in Twitter's own web site (not embedded in some other site).
  2. Click on the tweet to open it in its own popup window. The URL should include the text "/status/" and end with a big number, like https://twitter.com/realDonaldTrump/status/801805564577808385.
  3. Once you've got the tweet open in a popup, click the Raindrop button.
  4. As with regular links, save the bookmark in the Presterity folder and enter the desired page titles in the Tags field.
  5. Start the Title field with the date as described above.
  6. The Raindrop tool may include the person's Twitter handle in the title by default. If so, remove that.
  7. Next, include the real name of the person tweeting (not their Twitter handle) and a colon: e.g., "Tom Price: ". For Trump's tweets, start with "Trump: ". 
  8. The rest of the Title should be the verbatim tweet. The guidelines above for article link titles don't apply to tweets; don't paraphrase or summarize.
  9. If the tweet makes no sense out of context, use the Description field to concisely define the circumstances in which the tweet was made.

Example: Trump's tweet about the Carrier Corporation Jobs Deal on November 25, 2016, has a title like this:

2016.11.25 Trump: "I am working hard, even on Thanksgiving, trying to get Carrier A.C. Company to stay in the U.S. (Indiana). MAKING PROGRESS - Will know soon!"

Use your personal Raindrop account for unfinished bookmarks

If you find a potentially great article, but don't have time to read it, digest it, or fill out all the link details, use the Raindrop browser extension to add it to your personal "Unsorted" folder. That's like a personal email inbox — no one else can see it.

Later, when you have time, you can return to your Unsorted folder and take the time you need to read the article and, if still looks great, fill out the link details. Once the link looks good, you can drag the link into the Presterity folder to add it to the project.

You can always view all the bookmarks you've created in Raindrop's "All" folder.

Please follow these guidelines

We will proofread your submissions, and may perform minor editing for clarity and consistency, but please don't rely on that. In the interests of time, we may reject submissions that don't comply with these guidelines.