User:DBrant (WMF)/Goodies

Uncle Dmitry's bag of goodies. You're welcome.

Apps team pages

 * Mobile team portal
 * Apps team page
 * Release process
 * Why apps?
 * Release history (update with every release)
 * Roles, responsibilities
 * Development cycle
 * Coding conventions
 * All subpages under mobile apps
 * Design guidelines
 * App readme and FAQ and Play Store description
 * Apps/Desktop feature matrix

Plans and goals

 * Offline Library
 * Community wishlist item.
 * Synchronized reading lists
 * Short descriptions (original RfC on Wikidata)
 * New editor experiences.
 * Running on Chromebooks
 * Feeds and Navigation.
 * The iOS team's work on Notifications and enhanced Nearby
 * Planning for: 2016-Q1 | 2015-Q4
 * Goals for: 2016-Q1 | 2015-Q4

Phabricator boards

 * Android app
 * iOS app development and backlog.
 * Content service
 * Kanban thereof
 * Roadmap board
 * Reading admin board
 * Project creators
 * Guidelines for new projects
 * Calendar board (for marking vacation)

Deprecated

 * Mobile app goals
 * General/unknown app
 * Older mobile apps board

Android
$ brew install jd-gui $ brew install dex2jar $ d2j-dex2jar  -o  $ adb tcpip 5555 $ adb connect :5555 $ adb -s :5555 usb $ adb shell $ netcfg $ adb shell $ am broadcast -a android.intent.action.BOOT_COMPLETED The above may actually cause your device to reboot, in which case you'll get the event when the device finished booting! ;) $ adb shell $ am broadcast -a com.android.vending.INSTALL_REFERRER -n org.wikipedia/org.wikipedia.analytics.InstallReceiver --es "referrer" "referrer_url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FWombat&campaign_id=foo&install_id=bar" In the above, make sure you set the package name ("org.wikipedia") to the correct flavor that you're testing, and optionally change the "referrer_url" to something else. $ keytool.exe -list -printcert -jarfile [filename].apk
 * Material Design icons
 * Animated vector drawable designer
 * Screen sharing: Android Screen Monitor (ASM)
 * Screen recording for Mac
 * Memory profiling: Eclipse MAT
 * Inspect the view hierarchy of any running app: uiautomatorviewer (ANDROID_SDK/tools/bin/uiautomatorviewer)
 * Decompile: APKtool, dex2jar
 * Convert SVG to vector drawables
 * Activity lifecycle
 * Porter/Duff modes
 * ImageView scaleTypes
 * Annotations
 * Device metrics
 * Install Google apps in Genymotion.
 * To do ADB over the network:
 * To switch back to ADB over USB:
 * To get the IP address of the device:
 * To simulate a BOOT_COMPLETED event:
 * To simulate an INSTALL_REFERRER event:
 * To examine the fingerprints of the signing key that was used to sign an APK (the keytool executable is found in the JDK folder):

MySQL

 * Linux/Windows/Mac: MySQL Workbench
 * (Windows only) Establish an ssh tunnel to stat1006:  (note the port number "222", so that it doesn't conflict with any local SSH server that might be running)
 * SSH Hostname: localhost, SSH Username: dbrant, MySQL Hostname:, Username: research
 * Get the password for the "research" user from.
 * Note, when installing on Windows, and you find that Workbench fails to connect to Wikimedia's stat1006 over the Bastion tunnel, try using this fork of paramiko.
 * Also, to make text fields appear properly, go to Edit -> Preferences, SQL Editor -> SQL Execution, and check the box "Treat BINARY/VARBINARY as nonbinary character string."
 * Mac only: Sequel Pro
 * MySQL Host:, Username: research, SSH Host:
 * Get the password for the "research" user from.

Gerrit / Github repos

 * Make sure to upload your public key to Gerrit.
 * Make sure to install git review.
 * all open patches in Android app
 * all open patches in Content service
 * all open patches in MobileApp extension
 * all open patches in java-mwapi
 * all patches by me
 * Gerrit reviewer bot
 * Gerrit watched projects
 * Wikimedia-page-library

Git Review workflow
When modifying/amending an existing patch:

...make changes...

Git
$ git remote add upstream https://github.com/foo/bar.git $ git fetch upstream $ git checkout master $ git merge upstream/master
 * Bash git prompt
 * Git completion
 * To sync a fork with the upstream repo:

API

 * Documentation
 * Api Sandbox (enwiki)
 * Api Sandbox (wikidata)
 * Parsoid DOM spec
 * CirrusSearch

Services
https://en.wikipedia.org/api/rest_v1/page/title/Cat https://en.wikipedia.org/api/rest_v1/page/summary/Cat https://en.wikipedia.org/api/rest_v1/page/html/Cat https://en.wikipedia.org/api/rest_v1/page/random/title https://en.wikipedia.org/api/rest_v1/page/random/summary https://en.wikipedia.org/api/rest_v1/page/mobile-html/Cat Feed: https://en.wikipedia.org/api/rest_v1/feed/featured/2017/04/01 https://en.wikipedia.org/api/rest_v1/feed/announcements https://en.wikipedia.org/api/rest_v1/feed/trending/edits https://en.wikipedia.org/api/rest_v1/feed/onthisday/all/08/07 https://en.wikipedia.org/api/rest_v1/feed/onthisday/births/08/07 Deprecated: https://en.wikipedia.org/api/rest_v1/page/mobile-sections/Cat https://en.wikipedia.org/api/rest_v1/page/mobile-sections-lead/Cat https://en.wikipedia.org/api/rest_v1/page/mobile-sections-remaining/Cat Testing: http://apps.wmflabs.org/en.wikipedia.org/v1/page/summary/Cat http://apps.wmflabs.org/en.wikipedia.org/v1/page/mobile-html/Cat
 * RESTBase for apps
 * Documentation
 * Content service in gerrit
 * Reading List service test instance.
 * URL shortener
 * Examples:

Running locally
http://192.168.1.218:6927/en.wikipedia.org/v1/page/summary/Cat

http://localhost:8889/en.wikipedia.org/v1/feed/announcements

CI / Jenkins / Zuul

 * integration/config repository (on GitHub).
 * Master Zuul configuration. Controls reviewer (+1 / +2) access to projects, etc.
 * Jenkins configuration for mobile projects. Sets up CI jobs/sequences for our projects.


 * Main Jenkins dashboard.
 * Search of the dashboard for everything about "apps"
 * Add a comment of "recheck" to force Jenkins to reevaluate a patch.

Remember to always !log in #wikimedia-qa when performing manual commands via Jenkins control panel.
 * Zuul status.
 * Known issues
 * Gearman deadlock

Wikitech / OpenStack / Cloud services

 * After creating an account, make sure to upload your public key.
 * Deployment-prep project, where new tools and experimental features are hosted before going to production. (Hosts testing eventlogging server, among other things.)
 * Mobile project. (Hosts android-builder, among other things)
 * List of all projects.
 * Nova Resource category.

MEP (Modern event platform)
Debugging URLs:

https://stream-beta.wmflabs.org/v2/ui/#/?streams=android.user_contribution_screen

https://stream-beta.wmflabs.org/v2/ui/#/?streams=eventgate-analytics-external.error.validation

Legacy
$ ssh deployment-eventlog05.eqiad.wmflabs $ tail -f /srv/log/eventlogging/all-events.log | grep "MobileWikiApp"
 * Wiki page
 * Administration
 * Data access guidelines
 * Event logging:  (formerly stat1003), Hadoop/Hive:   (formerly stat1005, formerly stat1002)
 * For access to stat1006, you need to be part of the "researchers" group, and for stat1007, you need to be in the "analytics-privatedata-users" group.
 * Event logging schema list
 * Event logging help for production and beta.
 * Event logging testing on labs:
 * When creating a new schema, make sure to populate the Talk page with the SchemaDoc template (copy from an existing schema).
 * For whitelisting specific fields within the schema, make a Gerrit patch to the puppet repository, in this file. We generally want to whitelist all fields apart from the standard eventlogging capsule.
 * relevant wiki page
 * Hive help
 * Hive FAQ and samples
 * Hue
 * Refinery source code for daily/monthly uniques

Analytics

 * SWAP: Python notebooks integrated into eventlogging.

releases1002 (releases) (formerly releases1001, formerly Bromine, formerly Caesium)
To copy stuff over: $ scp [file] releases1002.eqiad.wmnet:~/[file] $ scp app.apk releases1002.eqiad.wmnet:/srv/org/wikimedia/releases/mobile/android/wikipedia/alphas/app.apk
 * https://releases.wikimedia.org/mobile/android/wikipedia/

Android builds
$ ssh android-builder.mobile.eqiad.wmflabs $ sudo -s $ sudo -u android-build /bin/bash $ cd /srv/builds
 * New: android-builder.mobile.eqiad.wmflabs
 * Gerrit repository that contains the web page that serves the Alpha download link, and the shell script that copies the latest Alpha from the CI server to the web server. After committing a change to this repo, log on to the android-builder server, and do a git pull on /srv/builds.


 * Web server URL: http://android-builds.wmflabs.org/
 * Served via the "mobile" project in Wikitech (see section on Wikitech).

$ ssh dbrant@tools-login.wmflabs.org $ OR: ssh dbrant@tools-dev.wmflabs.org $ become wikipedia-android-builds $ webservice [start|stop]
 * Old: http://tools.wmflabs.org/wikipedia-android-builds/, http://tools.wmflabs.org/?tool=wikipedia-android-builds

Vagrant
Once installed and launched, here are some useful links:
 * http://en.wiki.local.wmftest.net:8080/wiki/Main_Page
 * http://en.wiki.local.wmftest.net:8080/wiki/Special:ApiSandbox
 * http://fr.wiki.local.wmftest.net:8080/wiki/Accueil
 * http://wikidata.wiki.local.wmftest.net:8080/wiki/Special:SpecialPages
 * http://wikidata.wiki.local.wmftest.net:8080/wiki/Q1
 * http://wikidata.wiki.local.wmftest.net:8080/wiki/Property:P1

Partners

 * List of partners and apk builds.
 * List of Global South/North countries
 * Zero portal
 * Testing

people.wikimedia.org

 * This is hosted on
 * https://people.wikimedia.org/~dbrant/
 * Help on Wikitech

TranslateWiki

 * Translation for app strings
 * Direct link to a specific string in a specific language: https://translatewiki.net/wiki/Wikimedia:Wikipedia-android-strings-notification_syncing_title/nb

Wikidata

 * autodesc
 * WDQ
 * Documentation
 * WikiShootMe - find nearby articles that need a picture

Bintray / Maven / Jcenter

 * My maven entry for Zimdroid.
 * My maven entry for wikimedia-android-data-client.

Wmflabs Android maven repo
$ ssh dbrant@tools-login.wmflabs.org $ cd /data/project/android-maven-repo/public_html
 * https://tools.wmflabs.org/android-maven-repo

.ssh config
Host bastlabs HostName primary.bastion.wmflabs.org User dbrant IdentityFile ~/.ssh/id_rsa Host *.eqiad.wmflabs !primary.bastion.wmflabs.org User dbrant IdentityFile ~/.ssh/id_rsa ProxyCommand ssh -a -W %h:%p bastlabs Host bastprod HostName bast1002.wikimedia.org User dbrant IdentityFile ~/.ssh/id_rsa_prod Host *.eqiad.wmnet *.wikimedia.org !bast1002.wikimedia.org User dbrant IdentityFile ~/.ssh/id_rsa_prod ProxyCommand ssh -a -W %h:%p bastprod
 * 1) Use primary.bastion.wmflabs.org as proxy to labs
 * 1) Production bastion host

Notice that the above file uses a different key file for production than wmflabs, for security reasons.

On macOS 10.12 and above, you may need to add the following (since it no longer adds the keys to ssh-agent by default):

Host * UseKeychain yes AddKeysToAgent yes

Onboarding/Fundamentals

 * Gerrit
 * MediaWiki-Vagrant
 * Dotfiles
 * Mobile Web dev sessions
 * Research FAQ

Administrative

 * Production shell access
 * NOC
 * Labs mobile instances
 * Help
 * Deployments
 * Test Wiki
 * Block, Unblock
 * Mobile report card (limn)
 * Search metrics
 * Wikipedia manual of style
 * Wikimedia blog
 * JetBrains licenses

Design

 * Wikimedia design style guide.
 * Brand materials.
 * Wikipedia and Wikimedia visual identity guidelines, and list of trademarks.

Miscellaneous
mogrify -format jpg -quality 90 *.png mogrify -format jpg -quality 90 -thumbnail 512 *.png exiftool -AllDates-= -AllDates="2008:01:01 12:00:00" -overwrite_original -r. exiftool -gps:all= -xmp:geotag= image.jpg -overwrite_original * exiftool *.jpg -Copyright="Copyright (c) Dmitry Brant." ffmpeg -r 60 -f image2 -s 600x360 -start_number 0 -i frame%d.png -vcodec libx264 -crf 18 -pix_fmt yuv420p test.mp4 (-r = frame rate, -crf = quality (lower is better))
 * My gists
 * Typographical symbols
 * Emoji cheat sheet
 * Manage a website using git.
 * FIT file tools
 * Convert a batch of PNG images to JPG:
 * Convert a batch of PNG images to JPG, and resize to thumbnail:
 * Encode an Exif date tag into photos (recursively, in a whole directory):
 * Remove the GPS Exif tag from photos:
 * Add Copyright tag to all JPG images in directory:
 * Create video (x264) from a series of still frames (png):

ffmpeg -r 60 -f image2 -s 1280x720 -start_number 0 -i frame%d.png -vcodec libtheora -qscale:v 7 test.ogv python CrossMap.py bam hg19ToHg38.over.chain WGC074699D_combined.chr17.bam chr17.bam ./otf2bdf -p 10 -r 96 -o font.bdf font.ttf (-p = font size, -r = screen dpi) qemu-img convert -f raw -O qcow2 image.img image.qcow2 qemu-img convert -f vmdk -O raw image.vmdk image.img
 * Convert (cross map) a genomic file (BAM) from one reference genome to another:
 * Create a bitmap font for use with Python PIL from a TrueType font:
 * Download the otf2bdf tool: http://sofia.nmsu.edu/~mleisher/Software/otf2bdf/
 * Use the pilfont utility, or do it directly in Python.
 * Convert an emulator disk image from one format to another (using QEMU)
 * File format archive
 * Online graphing calculator
 * Online hex editor
 * List of unofficial Wikipedia apps

Teachable moments

 * Community wishlist 2019
 * Community wishlist 2017
 * Community wishlist 2016
 * Community wishlist 2015
 * Gather
 * RfC to disable Gather
 * Our proposal to the RfC (see talk page)
 * Moderation criteria
 * Extension talk page
 * Old RfC for user-specific lists
 * Risker's checklist for new content-creation extensions
 * Antandrus's observations on Wikipedia behavior
 * Sue Gardner's guide to working with online communities
 * Sue Gardner's patterns for change that work
 * JMinor's essays on product management.
 * Refactoring is the enemy of the product owner.
 * Do the least amount of work while still delivering value to the user (or at least strike a balance between user-facing goals and technical debt).
 * Don't let perfect be the enemy of good.