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 with subpages for application specific-information, like https://www.mediawiki.org/wiki/Phabricator/Help/Legalpad
Stuff that might be worth to cover:
* do not get mail notifications about my own actions: settings/panel/emailpreferences/ → Self Actions (cf. T76)
* 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.
* Make clear that adding a token does not subscribe you to a task, but that you should add yourself to the CC list instead (cf. T88)
* 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)
* Provide some ''common'' queries, such as how to view list of latest filed tickets
* 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
* 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. =
=== Checked/Done on-wiki already: ===
* https://www.mediawiki.org/wiki/Bug_management/Workflow - marked as outdated already
* https://www.mediawiki.org/wiki/Bug_management/Meeting_preparations/Email_template - nothing to fix
* https://www.mediawiki.org/wiki/Bug_management/Office_hours_how-to - nothing to fix
=== Done locally: ===
* https://www.mediawiki.org/wiki/Bug_management
=== TODO: ===
* Generally: "[[Category:Bugzilla]]" at bottom of each page - replace by [[Category:Phabricator]] !
* https://www.mediawiki.org/wiki/How_to_report_a_bug --- cover: To get an overview list of projects, go to http://phabricator.wikimedia.org/project/query/all/ as decribed on https://www.mediawiki.org/wiki/Phabricator/Help#Selecting_projects. Also if we don't implement T260 for Day 1 (I doubt), document to leave the project field empty when filing a new task and not being sure
* https://www.mediawiki.org/wiki/Bug_management/Project_Maintainers - mark page as outdated; link to https://www.mediawiki.org/wiki/Phabricator/Project_management for Good practices for Phabricator project management and https://www.mediawiki.org/wiki/Phabricator/Help#Creating_a_project
* https://en.wikipedia.org/wiki/Wikipedia:Bug_reports_and_feature_requests
* https://www.mediawiki.org/wiki/Annoying_little_bugs
* https://www.mediawiki.org/wiki/Bug_management/Triage
* https://www.mediawiki.org/wiki/Bug_management/Feedback_sources - replace Bugzilla by Phabricator, GS scripts, Template!
* https://www.mediawiki.org/wiki/Bugzilla --- linked from many many pages, sigh. Redirect to https://www.mediawiki.org/wiki/Phabricator ?
* https://www.mediawiki.org/wiki/Bug_management/Triage_tasks
* https://www.mediawiki.org/wiki/Bug_management/How_to_triage
* https://www.mediawiki.org/wiki/Gerrit/Advanced_usage#Submitting_a_change_to_a_branch_for_review_.28.22backporting.22.29 mentions Bugzilla flags
* https://www.mediawiki.org/wiki/Backporting_fixes
* Update https://www.mediawiki.org/wiki/Phabricator after BZ migration to not say "Phab will replace BZ anymore"
* https://www.mediawiki.org/wiki/Bug_management/Triage - "Severity" and "Priority" fields, is versioned correctly, Bugzilla
* https://www.mediawiki.org/wiki/Gerrit/Tutorial mentions Bugzilla three times
* https://www.mediawiki.org/wiki/Gerrit/Commit_message_guidelines mentions Bugzilla seven times
* https://www.mediawiki.org/wiki/Development_statistics mentions Bugzilla under "Live statistics", move under "Old" and change link to old-bugzilla.wm.o; add link to https://phabricator.wikimedia.org/maniphest/report/burn/
* https://www.mediawiki.org/wiki/Bug_management/Upstream_bugtrackers - only need to replace upstream keyword by project!
* https://www.mediawiki.org/wiki/Bug_management/Meeting_preparations - only section to fix is: "default CC list of the Bugzilla component"
* ...
=== TODO: Add "Obsolete" banner to page?: ===
* https://www.mediawiki.org/wiki/Bugzilla/Fields -- add banner that outdated?
* https://www.mediawiki.org/wiki/Bug_management/Bug_report_life_cycle -- add banner that outdated?
* https://www.mediawiki.org/wiki/Bug_management/Bugzilla_Labs_instance -- add banner that outdated?
* https://wikimediafoundation.org/wiki/Bugzilla_administrator_rights_policy -- add banner that outdated?
* https://wikitech.wikimedia.org/wiki/Bingle -- add banner that might be outdated as Phab has replaced BZ?
* https://www.mediawiki.org/wiki/Entomology -- add banner that might be outdated as Phab has replaced BZ?
* https://www.mediawiki.org/wiki/Project:WikiProject_Bug_Squad has links to Bugzilla queries etc, banner to says that it's dormant/inactive?
* https://www.mediawiki.org/wiki/Project:WikiProject_Bug_Squad/Activities which is covered by https://www.mediawiki.org/wiki/Bug_management/Triage_tasks IMO
* https://www.mediawiki.org/wiki/Requests_for_comment/Bugzilla_taxonomy - obsolete now that Phab has replaced BZ?
* https://www.mediawiki.org/wiki/Requests_for_comment/Overthrow_Bugzilla - obsolete now that Phab has replaced BZ?
* https://www.mediawiki.org/wiki/Similarities_and_differences_between_the_Bugzilla_way_and_the_wiki_way -- add banner that might be outdated as Phab has replaced BZ?
* https://www.mediawiki.org/wiki/Bug_management/Task_list -- add banner that potentially outdated; Andre to clean up in the long run
* ...
=== Related questions: ===
* Do we want something like https://wikitech.wikimedia.org/view/Bugzilla.wikimedia.org for our Phab instance?
* Do we want something like https://wikimediafoundation.org/wiki/Bugzilla_administrator_rights_policy for our Phab instance? Rules who can be an admin and why: Phab admins can disable users, delete users, change usernames. Phab admins cannot undelete comments (via UI) removed by their authors.
* "Andre Klapper keeps an eye on upstream Bugzilla security updates, Daniel Zahn helps deploying them." on https://www.mediawiki.org/wiki/Bug_management - how will that be with Phab?