Page MenuHomePhabricator

Update phabricator docs regarding project creation
Closed, ResolvedPublic

Description

Matt pointed out that the https://www.mediawiki.org/wiki/Phabricator/Project_management#Organizing_your_projects section of the docs was written before sub-project support was added. It needs to be updated to reflect the new reality.

Event Timeline

I went through the section, including the Kanban and Sprint sub-sections, and hopefully brought everything up to date. It no longer talks about Sprint Extension stuff as if it was active, and mentions sub-projects where relevant.

There is clearly room for improvement, but I think it's "good enough" for now.

ksmith triaged this task as Medium priority.Mar 31 2016, 8:57 PM
ksmith moved this task from To Do to Needs Review on the Team-Practices (This-Week) board.

@ksmith I reviewed Organizing your projects, Kanban, and Sprint sections.

  1. In Organizing your project section: "Consider the pros and cons of using sub-projects and milestones" <--should there be a description of what the pros and cons are?
  1. In Organizing your project, I changed link to Analytics Engineering from: https://phabricator.wikimedia.org/project/view/840/ to : https://phabricator.wikimedia.org/project/view/11/
  1. In the Kanban section: "You can limit tasks in each column in workboard view > Edit column > Point Limit" with the recent changes what you can limit is the points, no longer the number of tasks in the column
  1. In Kanban section, I changed link to Analytics backlog to https://phabricator.wikimedia.org/project/view/11/ from: https://phabricator.wikimedia.org/tag/analytics-backlog/

Thanks @ggellerman. Good feedback. I added a link to address your point #1, and reworded the Kanban limits text for #3. I also found and removed a dangling reference to the sprint extension there.