Update Bug Management related documentation on wiki pages; potentially add "might be outdated" banner
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	Aklapper
	May 23 2014, 8:09 AM

Description

Please feel free to edit this initial description by adding more links.

New documentation on Phabricator itself

Main page for the tool itself: https://www.mediawiki.org/wiki/Phabricator/Help . At some point we'll need to split into subpages for application specific-information (like Differential, Diffusion) but not yet (not covered here).

Stuff that might be worth to cover:

NOTHERE: Document the difference between projects and tracking/dependency tasks. This differentiation was never clearly made in Bugzilla, mixing up tracking bugs (tracking tracking bug 2007 plus duplication via "tracking" keyword) and keywords: Projects should be "items that can never be considered fixed", e.g. Bugzilla bug 1 "Improve our documentation". Bug reports that can be declared fixed at some point with dependent (sub-)tasks should become tasks instead. -- that's something not to do as part of this task, but in https://www.mediawiki.org/wiki/Phabricator/Project_management instead
DONE: Recommend to paste full URLs from the address bar of your web browser, instead of wiki markup like "[[:mw:Talk:Flow]]" which is not supported (cf. T53) -- https://www.mediawiki.org/wiki/Phabricator/Help#Writing_comments_and_descriptions
Provide some ''common'' queries, such as how to view list of latest filed tickets
DONE: do not get mail notifications about my own actions: settings/panel/emailpreferences/ → Self Actions (cf. T76) -- https://www.mediawiki.org/wiki/Phabricator/Help#Receiving_updates_and_notifications
DONE: For devs/maintainers who'd like to provide direct links (e.g. on a wikipage) to create a new Maniphest task about their project, see https://secure.phabricator.com/T3320 for available parameters to pass in an URL: projects, title, description, assign --- https://www.mediawiki.org/wiki/Phabricator/Help#Passing_certain_values_in_the_task_creation_URL
DONE: T22 / T68/T106: Setting up notification rules (e.g. "get all notifications for tasks filed under project XY", "following activity of a person") in Herald --- https://www.mediawiki.org/wiki/Phabricator/Help#Creating_Herald_rules_for_notifications
DONE: T91 comment 18: Querying relative timespans (e.g. "tasks created in last 24 hours") --- https://www.mediawiki.org/wiki/Phabricator/Help#Searching_for_items
DONE: adding other approved auth providers: http://fab.wmflabs.org/settings/panel/external/ (cf. T201) --- https://www.mediawiki.org/wiki/Phabricator/FAQ#Why_can.27t_I_login_using_my_GitHub_or_Google_account.3F
DONE: how to find tasks that I filed: T255#4 --- https://www.mediawiki.org/wiki/Phabricator/Help#Searching_for_items
DONE: Document that (search query) URLs can be shared: T236 --- https://www.mediawiki.org/wiki/Phabricator/Help#Selecting_projects
DONE: Project creation: Document that people (well, admins) creating projects in Phabricator should set Project visibility to Public by default. Only if there are very good reasons (Security project, cf. T50) restrict access. Nemo_bis found this problem in T235. --- https://www.mediawiki.org/wiki/Phabricator/Requesting_a_new_project
DONE: Project creation: The naming scheme must be clearly documented (cf. T43) otherwise we end up in a complete mess as we try to turn lots of different things into projects. Chase might be also interested in it. --- https://www.mediawiki.org/wiki/Phabricator/Requesting_a_new_project
DONE: If drag and drop for upload does not work, use /file/upload/ and refer to the file by using F123 markup (cf. T165). Users can also copy and paste images via the clipboard functionality. Advanced users could also use "arc upload" which provides an F number that can be used via {Fxx} syntax to embed in a comment. --- https://www.mediawiki.org/wiki/Phabricator/Help#Uploading_file_attachments and https://www.mediawiki.org/wiki/Phabricator/Help#Writing_comments_and_descriptions
DONE: File permissions: Note that you cannot upload a file and then decrease the access level to the file (e.g linking it to a security ticket). You would have to delete the file and reupload it with stricter access permissions. It is recommended to upload files which should have restricting access together with the creation of a restricted (security) ticket. --- https://www.mediawiki.org/wiki/Phabricator/Help#Uploading_file_attachments
DONE: As long as T27 isn't fixed: To get an overview list of projects, go to http://fab.wmflabs.org/project/query/all/ --- https://www.mediawiki.org/wiki/Phabricator/Help#Selecting_projects
DONE: Cover how you are supposed to "claim" your account in Phabricator, to e.g. be able to query for tickets that you had filed in Bugzilla --- https://www.mediawiki.org/wiki/Phabricator/Help#Claiming_your_previous_Bugzilla_and_RT_accounts
DONE: Using email to create Maniphest tasks: https://www.mediawiki.org/w/index.php?title=Phabricator%2FHelp&diff=1245704&oldid=1242979 -- T865
DONE: Appending URL parameters to Maniphest task creation URLs: https://www.mediawiki.org/w/index.php?title=Phabricator%2FHelp&diff=1246023&oldid=1245812 - T971
...

Existing bug management and popular Bugzilla docs to update etc.

So far (November 23, 22:30UTC), more than 40 wiki pages with documentation referring to Bugzilla (and often also related steps) were updated, and banners were added to a dozen of pages which are now outdated:

CONTENT UPDATED:

CONTENT MARKED WITH AN OBSOLETE BANNER (for good):

{{notice|Due to Wikimedia's move from [[Bugzilla]] to [[Phabricator]] '''this page is outdated and only kept for historical reasons.'''}}

Updated content, banners etc after finishing migration from BZ to Phab:

CONTENT CHECKED AND NOTHING TO UPDATE:

Details

Reference: fl350

Related Objects
Search...

Status	Assigned	Task
Resolved	Qgil	T553 Engineering Community team goals for October 2014
Resolved	Qgil	T174 Launch Wikimedia Phabricator Day 1
Resolved	• chasemp	T263 Find place in Phab where to display links to custom items (Privacy Policy; Help)
Resolved	Aklapper	T206 Update Bug Management related documentation on wiki pages; potentially add "might be outdated" banner
Resolved	Aklapper	T462 List of features missing & added in Phabricator vs Bugzilla
Resolved	• chasemp	T699 Date of creation of Bugzilla report is missing

Event Timeline

qgil wrote on 2014-06-13 14:33:17 (UTC)

https://www.mediawiki.org/wiki/Phabricator will be the common landing place for all this documentation, right?

aklapper wrote on 2014-06-13 14:51:41 (UTC)

Likely. The current split between https://www.mediawiki.org/wiki/Bugzilla and https://www.mediawiki.org/wiki/Bug_management is suboptimal; we might end up with redirects.

Aklapper moved this task from Backlog to Waiting For Migration Start on the Bugzilla-Migration board.Sep 18 2014, 3:33 PM

Aklapper updated the task description. (Show Details)Sep 18 2014, 3:55 PM

Aklapper set Security to None.

Qgil removed a project: Phabricator.Sep 19 2014, 10:50 AM

• flimport assigned this task to Aklapper.Oct 1 2014, 11:01 PM

• flimport added a subscriber: Aklapper.

• flimport added a subscriber: Qgil.Oct 2 2014, 9:48 PM

• flimport added a subscriber: greg.Oct 2 2014, 9:58 PM

Liuxinyu970226 added a subscriber: Liuxinyu970226.Oct 5 2014, 11:11 AM

• flimport added a subscriber: scfc.Oct 7 2014, 3:00 AM

Aklapper raised the priority of this task from Medium to High.Oct 27 2014, 12:26 PM

Aklapper updated the task description. (Show Details)Oct 29 2014, 6:32 PM

Aklapper updated the task description. (Show Details)Oct 29 2014, 6:43 PM

Aklapper updated the task description. (Show Details)Oct 29 2014, 7:22 PM

Aklapper updated the task description. (Show Details)Oct 29 2014, 10:00 PM

Qgil lowered the priority of this task from High to Medium.Oct 31 2014, 9:34 PM

Qgil moved this task from Waiting For Migration Start to Doing on the Bugzilla-Migration board.

Aklapper added a project: ECT-November-2014.Nov 3 2014, 1:57 PM

Aklapper raised the priority of this task from Medium to High.Nov 4 2014, 2:12 PM

Aklapper closed subtask T462: List of features missing & added in Phabricator vs Bugzilla as Resolved.Nov 4 2014, 2:28 PM

Aklapper moved this task from Backlog to Doing on the ECT-November-2014 board.Nov 4 2014, 3:42 PM

Aklapper updated the task description. (Show Details)Nov 4 2014, 4:32 PM

Aklapper updated the task description. (Show Details)Nov 5 2014, 8:48 PM

Quiddity added a subscriber: Quiddity.Nov 7 2014, 1:42 AM

Aklapper mentioned this in T1199: Update links everywhere from Bugzilla to Phabricator.Nov 10 2014, 4:56 PM

Qgil mentioned this in T389: Add "might be outdated" banner on Bugzilla/Bug management related pages on mw.org.Nov 11 2014, 1:07 PM

Aklapper renamed this task from Update Bug Management related documentation on wiki pages to Update Bug Management related documentation on wiki pages; potentially add "might be outdated" banner.Nov 11 2014, 5:09 PM

Aklapper merged a task: T389: Add "might be outdated" banner on Bugzilla/Bug management related pages on mw.org.

Aklapper updated the task description. (Show Details)Nov 23 2014, 10:40 PM

Aklapper updated the task description. (Show Details)Nov 24 2014, 9:38 PM

Qgil awarded a token.Nov 24 2014, 9:58 PM

This is the last task of Bugzilla-Migration. What is missing?