As part of the work to invent processes for the API and Search teams, start to document specific ways to use Phabricator:
- Creating projects (team, sub-projects, sprints, milestones, categories)
- Workboard columns
- Estimation, story points,
As part of the work to invent processes for the API and Search teams, start to document specific ways to use Phabricator:
As I pointed out on IRC, documentation exists on mw:Phabricator/Help, mw:Phabricator/Project management, mw:Phabricator/Creating and renaming projects and should be potentially extended (sections, subpages) to avoid duplication.
@Aklapper: Yes, the end result will be changes to that document. I'm going to start working in a sandbox, and then figure out how to combine the results. Some of this document may include guidance that the Team Practices Group agrees to advocate for, but which might not qualify as universal best practice advice. Any recommendations for how to deal with that kind of material?
Any recommendations for how to deal with that kind of material?
Not really, apart from being bold - if cases to cover get too many or specific, linking to subpages on the wiki might be useful.
I have created an initial sandbox draft here: https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_Tips
@ggellerman @KLans_WMF @Awjrichards : Review would be appreciated.
All thoughts (or edits) would be welcome, but if you can't look at anything else, please focus on the work boards section. I'm especially interested to know how well it aligns with what is actually being used by teams today.
When you're done, please assign to Kristen for her similar review.
Very helpful - I would definitely think everybody should read this before going into Phab.
Putting questions here - they could go to a new Task if answer warrant it:
@JAufrecht Thanks for the great feedback. I have addressed all three of your suggestions in the page.
To answer your last question, that is mostly correct. The status (which is limited to one of the 5 defined values) has no technical relationship to implied states based on what column(s) the task is in in various workboards.
Is there a followup task I can subscribe to that covers "Integrate this sandbox with existing documentation"?
As written before I'm still afraid enough of duplicated documentation (even if just in the long run).
(Plus not sure if "Merged/Duplicate" should be covered as a status. At least in the existing docs I did.)
@Aklapper The follow-up task is T98521. And I agree with you that this does need to get merged in. My current hope is that I might have time to work on that in June. My other hope is that there isn't actually much duplication between the tips page and the other pages, although I realize there is some.
I will contact you separately with questions about Merged/Duplicate.