Wikimedia Apps/Team/iOS/Wikipedia App/Regression Tests/New Test FAQ

From mediawiki.org

When making new Wikipedia iOS app regression test pages there are a few things to keep in mind.

Where should new Wikipedia iOS app regression test files be created?[edit]

Test pages should be created in the Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/ folder.

How many things should each regression test file verify?[edit]

Regression test pages should be fairly narrowly scoped to test a particular part or feature of the app.

For example, for verifying everything about the app's collection of welcome screens it would be tempting just to create one regression test page, but it's better in the long-run if regression test pages are more narrowly scoped.

Consider the following proposed breakdown for testing the welcome screens:

Pages for verifying the layout of each welcome screen

  • Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/Welcome/Explore-Layout
  • Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/Welcome/Languages-Layout
  • Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/Welcome/Volunteer-Layout

Page for testing navigation between welcome screens

  • Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/Welcome/Navigation-BackForward

Pages for testing changing various welcome screen settings and confirming those changes are reflected elsewhere in the app

  • Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/Welcome/UsageReport-Toggle
  • Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/Welcome/PreferredLanguages-Selection

How do I add screenshot images to regression test files?[edit]

Regression test pages contain many screenshot images.

There are a few important things to keep in mind when uploading screenshots to use with regression test pages.

Screenshot naming[edit]

Images associated with regression test pages should be named according to the following format: wikipedia-ios-app-regression-short_description.png

The "short_description" part of the name should be one or two words max.

Screenshot uploading and Licensing[edit]

Screenshots should be uploaded to mediawiki.org.

If uploaded to commons they may be deleted if any individual part of the screenshot composition isn't separately attributed.

To upload a screenshot use the following steps:

Step 1 Step 2 Step 3
Tap the "Upload file" link Choose the screenshot to

be uploaded

Fill (at least) "author" and

"description" fields and choose

"Mediawiki screenshot" license