Use a standard head1 DESCRIPTION for tests (#3401)

This is more expected and makes it easier to test for it later.

Author: reosarevok

t/author/eol.t

@@ -9,7 +9,7 @@ plan skip_all => 'Test::EOL required' if $EVAL_ERROR;
 use FindBin '$Bin';
 use File::Find;
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether Perl and TT files have lines that end
 with Windows EOL characters rather than Unix ones.

t/author/notabs.t

@@ -9,7 +9,7 @@ plan skip_all => 'Test::NoTabs required' if $EVAL_ERROR;
 use FindBin '$Bin';
 use File::Find;
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether Perl and TT files use tabs
 when they should use multiple spaces instead.

t/hydration_i18n.t

@@ -9,7 +9,7 @@ use MusicBrainz::Server::Data::Utils qw( contains_string );
 use String::ShellQuote qw( shell_quote );
 use Test::More;
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks that any components using hydration exist under
 root/static/scripts/.  It also checks that any imported files that use

t/lib/t/MusicBrainz/DataStore/Redis.pm

@@ -14,7 +14,7 @@ use DBDefs;
 
 with 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks basic tasks for the Redis store, including adding, deleting
 and expiring keys.

t/lib/t/MusicBrainz/DataStore/RedisMulti.pm

@@ -13,7 +13,7 @@ use MusicBrainz::DataStore::Redis;
 use MusicBrainz::DataStore::RedisMulti;
 use DBDefs;
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks basic tasks for the RedisMulti store (including adding,
 deleting and expiring keys), which distributes queries to multiple underlying

t/lib/t/MusicBrainz/Script/RemoveEmptyURLs.pm

@@ -10,7 +10,7 @@ use MusicBrainz::Script::RemoveEmpty;
 
 with 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the RemoveEmpty script is working as expected
 for URLS, deleting only URLs that are unused, not new,

t/lib/t/MusicBrainz/Script/RemoveUnreferencedRows.pm

@@ -14,7 +14,7 @@ use MusicBrainz::Script::RemoveUnreferencedRows;
 
 with 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the RemoveUnreferencedRows script is working
 as expected for artist credits, deleting only the ones that are unused

t/lib/t/MusicBrainz/Server/Authentication/WS.pm

@@ -12,7 +12,7 @@ use URI::QueryParam;
 
 with 't::Context', 't::Mechanize';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks OAuth authentication in the web service, by attempting
 to request data for a private collection.

t/lib/t/MusicBrainz/Server/Controller/Admin/DeleteEditor.pm

@@ -9,7 +9,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether admins can delete an editor account, and whether
 the editors themselves can do it. It also checks whether users are logged out

t/lib/t/MusicBrainz/Server/Controller/Admin/PrivilegeSearch.pm

@@ -9,7 +9,7 @@ use MusicBrainz::Server::Test qw( test_xpath_html );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the privilege search works as expected, and whether
 it's blocked for non-admins.

t/lib/t/MusicBrainz/Server/Controller/Admin/WikiDoc/Create.pm

@@ -10,7 +10,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks that the WikiDoc Add Page form is blocked for users without
 the appropriate privileges, that it loads for privileged users, and that

t/lib/t/MusicBrainz/Server/Controller/Admin/WikiDoc/Delete.pm

@@ -10,7 +10,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks that the WikiDoc Remove Page form is blocked for users
 without the appropriate privileges, that it loads for privileged users, and

t/lib/t/MusicBrainz/Server/Controller/Admin/WikiDoc/Edit.pm

@@ -10,7 +10,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks that the WikiDoc Edit Page form is blocked for users without
 the appropriate privileges, that it loads for privileged users, and that

t/lib/t/MusicBrainz/Server/Controller/Area/Aliases.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( html_ok page_test_jsonld );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether area aliases are correctly listed on the area
 alias page, both on the site itself and on the JSON-LD data.

t/lib/t/MusicBrainz/Server/Controller/Area/Create.pm

@@ -9,7 +9,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether non-ended areas can be added (which used to ISE, see
 MBS-8661) and, by extension, whether basic area adding works. It also ensures

t/lib/t/MusicBrainz/Server/Controller/Area/Edit.pm

@@ -9,7 +9,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether non-ended areas can be edited (which used to ISE, see
 MBS-8661) and, by extension, whether basic area editing works. It also ensures

t/lib/t/MusicBrainz/Server/Controller/Area/Show.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok page_test_jsonld );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether basic area data is correctly listed in the JSON-LD
 of an area's index (main) page.

t/lib/t/MusicBrainz/Server/Controller/Area/Tags.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether area tagging is working correctly. It checks both
 up- and downvoting, plus withdrawing/removing tags.

t/lib/t/MusicBrainz/Server/Controller/Area/Users.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the Users tab for an area correctly lists editors
 who have their area set to it or to an area contained in it.

t/lib/t/MusicBrainz/Server/Controller/Artist/AddAlias.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether alias adding for artists works, including whether
 the sort name defaults to the name when not explicitly entered.

t/lib/t/MusicBrainz/Server/Controller/Artist/AddAnnotation.pm

@@ -9,7 +9,7 @@ use Time::HiRes qw( gettimeofday tv_interval );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether adding annotations for artists works, including
 whether four spaces at the start of the annotation are left untrimmed

t/lib/t/MusicBrainz/Server/Controller/Artist/Aliases.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok page_test_jsonld );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether artist aliases are correctly listed on the artist
 alias page, both on the site itself and on the JSON-LD data.

t/lib/t/MusicBrainz/Server/Controller/Artist/AnnotationRevision.pm

@@ -6,7 +6,7 @@ use Test::Routine;
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether artist annotation revision pages load,
 and whether they display the entirety of the annotation.

t/lib/t/MusicBrainz/Server/Controller/Artist/Create.pm

@@ -11,7 +11,7 @@ with 't::Mechanize', 't::Context';
 
 use aliased 'MusicBrainz::Server::Entity::PartialDate';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks that the artist create form works properly with both complete
 and minimal data, plus some edge cases.

t/lib/t/MusicBrainz/Server/Controller/Artist/DeleteAlias.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks that artist alias deletion works, and that it requires
 an edit note.

t/lib/t/MusicBrainz/Server/Controller/Artist/Details.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks that the artist details page contains all the expected data.
 

t/lib/t/MusicBrainz/Server/Controller/Artist/Edit.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether basic artist editing works, including when also
 updating artist credits.

t/lib/t/MusicBrainz/Server/Controller/Artist/EditAlias.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( capture_edits html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether alias editing for artists works, including whether
 the sort name defaults to the name when not explicitly entered (blanked).

t/lib/t/MusicBrainz/Server/Controller/Artist/EditExternalLinks.pm

@@ -10,7 +10,7 @@ use MusicBrainz::Server::Test qw( capture_edits );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether external links are correctly added, removed and
 modified when editing artists, and whether editing other parts of the artist

t/lib/t/MusicBrainz/Server/Controller/Artist/EditRelationships.pm

@@ -18,7 +18,7 @@ use MusicBrainz::Server::Test qw( capture_edits );
 
 with 't::Context', 't::Mechanize';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether non-URL relationships are correctly added, removed
 and modified when editing artists, including several edge cases.

t/lib/t/MusicBrainz/Server/Controller/Artist/Edits.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( accept_edit html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether artist edits are correctly listed under both the
 "all edits" and the "open edits" lists.

t/lib/t/MusicBrainz/Server/Controller/Artist/EligibleForCleanup.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether artists are correctly displayed as eligible for
 cleanup (in risk of being auto-removed).

t/lib/t/MusicBrainz/Server/Controller/Artist/Filtering.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( test_xpath_html );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether filtering works for different entity lists
 in artist pages (events, RGs, recordings, releases, works).

t/lib/t/MusicBrainz/Server/Controller/Artist/Merge.pm

@@ -30,7 +30,7 @@ around run_test => sub {
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks artist merges, and especially the artist credit renaming
 code.

t/lib/t/MusicBrainz/Server/Controller/Artist/Ratings.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( html_ok test_xpath_html );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether artist ratings are properly displayed on the ratings
 page, and that private ratings are hidden.

t/lib/t/MusicBrainz/Server/Controller/Artist/Recordings.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok page_test_jsonld );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the artist recordings page properly displays
 recordings for the artist, both on the site itself and on the JSON-LD data.

t/lib/t/MusicBrainz/Server/Controller/Artist/Relationships.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok page_test_jsonld );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the artist relationships page properly displays
 relationships for the artist, and also the expected JSON-LD data.

t/lib/t/MusicBrainz/Server/Controller/Artist/Releases.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the artist releases page properly displays
 releases for the artist.

t/lib/t/MusicBrainz/Server/Controller/Artist/Show.pm

@@ -9,7 +9,7 @@ use MusicBrainz::Server::Test qw( html_ok page_test_jsonld );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether basic artist data is correctly listed on an artist’s
 index (main) page both on the site itself and on the JSON-LD data.

t/lib/t/MusicBrainz/Server/Controller/Artist/Split.pm

@@ -29,7 +29,7 @@ around run_test => sub {
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks the artist split function, and whether it removes
 collaboration relationships as intended.

t/lib/t/MusicBrainz/Server/Controller/Artist/Tags.pm

@@ -8,7 +8,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether artist tagging is working correctly. It checks both
 up- and downvoting, plus withdrawing/removing tags.

t/lib/t/MusicBrainz/Server/Controller/Artist/Works.pm

@@ -7,7 +7,7 @@ use MusicBrainz::Server::Test qw( html_ok );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the artist releases page properly displays
 works for the artist.

t/lib/t/MusicBrainz/Server/Controller/ArtistCredit/Show.pm

@@ -9,7 +9,7 @@ use MusicBrainz::Server::Test qw( html_ok test_xpath_html );
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether basic artist credit data is correctly listed in an
 artist credit page, and whether trying to load a nonexistent artist credit

t/lib/t/MusicBrainz/Server/Controller/CDStub/Browse.pm

@@ -9,7 +9,7 @@ use Hook::LexWrap;
 
 with 't::Mechanize', 't::Context';
 
-=head2 Test description
+=head1 DESCRIPTION
 
 This test checks whether the Browse CD Stubs page shows data as expected.