Wikimedia Apps/Team/iOS/Wikipedia App/Regression Tests/New Test FAQ
This page is obsolete. It is being retained for archival purposes. It may document extensions or features that are obsolete and/or no longer supported. Do not rely on the information here being up-to-date. |
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?
editTest pages should be created in the Wikimedia_Apps/Team/iOS/Wikipedia_App/Regression_Tests/ folder.
How many things should each regression test file verify?
editRegression 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?
editRegression 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
editImages 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
editScreenshots 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 |