karanguni: (Default)
K ([personal profile] karanguni) wrote in [community profile] yuletide2017-10-09 04:21 pm

Letters App

Hello, Yuletide!

I'm de-anoning as the coder behind the letters app here so that people can easily post corrections and ask for updates in the lull between now and Madness.

Of course, the original Dear Yuletide Writer and spreadsheet post is where you should start if you want to get your letter listed; the app will be updated per that post, including all corrections.

App-specific fixes: please comment on the corrections comment on this post if you see any fixes (tagset, letter links, prompts, bugs) that need to be made.

If reporting that a Letter has migrated into the Characters column for a prompt, please provide me with the fandom name and username!

[edit] Donate: if you want to help out with hosting fees, that's always appreciated! The app costs $25/month in the high season and a lot of love to run :) https://ko-fi.com/karanguni



How To Use The App



The app provides you with the entire Yuletide 2017 tagset.

  • The Characters column contains all nominated characters for that fandom.
  • The Letters column contains letters that were posted to the spreadsheet post. It is not comprehensive.
  • Once Madness opens, the Prompts column will allow you to load all prompts for a given fandom. Prompts are organised alphabetically by username.


User Interface



By default, the app loads 100 rows at a time to prevent your browser from collapsing under the sheer weight of all the expectations of all the fandoms all the time. Scroll down to load more, or check the Load All option. Give your browser time to render if you do that.

Bookmarks are in the upper right.

There is a Jump to Top (^) helper link in the lower right.

  • Filter by Fandom: search by fandom name. Takes into account accents on words, but is case insensitive.
  • Filter by Category: what it says on the tin
  • Only Fandoms with Prompts: filters down to only fandoms with prompts (visible once Madness opens)
  • Only Bookmarked Fandoms: what it says on the tin
  • Only Fandoms with Letters: filters down to only fandoms with letters from the letters post. This does not indicate there are no letters in the actual prompts
  • Hide Characters: hide the characters column
  • Hide Category: hide the category column


Bookmarking



Bookmarking fandoms, letters, or (after Madness opens) prompts will save them to the bookmarks tab in the top right corner of the app. Your bookmarks are saved in your browser history, meaning as long as you don't clear your cache or are in incognito, they should persist even if you refresh the page.

Fandoms can be bookmarked by clicking the Bookmark link. Letters and prompts can be bookmarked using the heart (♥) symbol.

(Post-Madness) Looking Up Prompts By User



Any username in any Prompts table will have a (see all) link next to it. This will open up all of the given user's prompts in a tab on the upper left.





Contributing



Other development: In the hope of making this useful for Madness (and the future?), I've put the code and a roadmap of features that will be added here on Github. Everyone is welcome to comment on what should be added next.

Please sort by Milestone on the Github issues page to see when something is slated to go up.

Current milestones:
  • Pre-Madness: any changes between now and Nov 1
  • Madness: changes for Nov 1, including adding all the requests
  • 2018 Rampup: potential stuff for next year


Suggesting Features: Just leave a comment here and I'll get it added to the issues list.

Helping Out: If you would like to help code, please fork and open up a PR (you might want to wait till I finish pre-madness issues first). :) If you would like to help add letters to the app, feel free to do so at any time: it has never been locked down.

Post a comment in response:

If you don't have an account you can create one now.
HTML doesn't work in the subject.
More info about formatting

If you are unable to use this captcha for any reason, please contact us by email at support@dreamwidth.org