Page MenuHomePhabricator

Organize the open tasks for Project Math
Closed, ResolvedPublic

Description

Updated description:

While looking at the project math board I realized the there are two types of colums.

  • column 1-4 organize the tasks into their state of completation
  • the columns n>4 are topical categorizations indepenendent of the completation of the project.

However, these two aspects are orthogonal, and thus many tickets fit into two columns, at least. I would not want to delete the information in columns n>4 because the tasks groups help to get an overview of the more than 300 tasks in the project.

Event Timeline

Aklapper added a project: Project-Admins.

That is possible but please make sure to understand the side effects / downsides. Please make sure to read all of the https://www.mediawiki.org/wiki/Phabricator/Project_management#Parent_Projects,_Subprojects_and_Milestones

Thank you. After reading this I am honestly not sure if the subproject approach is the way to go. The project board has now two kinds of columns and is very wide. While it is good to have groups of bugs with a similar topic I think it is better to have the lifetime represented on the board and have bugs mainly travel from left to right.

Maybe an option would be to create Tracking tasks. I tried that with T239367 and it seems there is also a role that is allowed to bulk-edit tasks in one column. Maybe one could batch make the following tasks
https://phabricator.wikimedia.org/maniphest/query/BEC7gr0ARZom/#R
subtasks of T239367 The other alternative would be to create more components such as "New TeX macro proposals"

Please no tracking tasks as they don't really solve any problems but just get outdated - see my comment in T239367#5698582 :)

Physikerwelt renamed this task from Create subprojects for phabricator project math to Organize the open tasks for Project Math.Nov 28 2019, 1:22 PM
Physikerwelt updated the task description. (Show Details)

@Aklapper I updated the task desciption to better explain the problem I am facing.

I realized that the situation is pretty much described in Section 5.3.1 in the project management page. Is it possible to create a second board for math and move the columns n>4 to the new board?

@Physikerwelt: Ah, thanks! I have some thoughts but before sharing them, please help me first to understand a bit better:

Could you explain why not all tasks in the "Mathoid" column on the current Math workboard also have the Mathoid project tag on them?
Same question for the texvc column vs the Texvcjs tag (though those might be different things?), and the VisualEditor column vs the VisualEditor tag.
Also, I'm wondering if that Design column is really needed: You could always filter for design tasks, no matter which column they are in, by clicking "Open Tasks" in the upper right corner, choose "Advanced Filter...", and query for Design tasks (or even add a shortcut link to the side bar which does that, for convenience).

@Physikerwelt: Any feedback on my last comment here? :)

@Aklapper sorry for the long silence!

@Physikerwelt: Ah, thanks! I have some thoughts but before sharing them, please help me first to understand a bit better:

Could you explain why not all tasks in the "Mathoid" column on the current Math workboard also have the Mathoid project tag on them?

Not really. Note that the tasks are not made or curated by a group of professionals that agreed on standards. There is no systematic assignment of tags or columns. So these are two technically different ways to transport the same message. This task is related to mathoid;-)

Same question for the texvc column vs the Texvcjs tag (though those might be different things?), and the VisualEditor column vs the VisualEditor tag.

I have the same unsatisfying answer here.

Also, I'm wondering if that Design column is really needed: You could always filter for design tasks, no matter which column they are in, by clicking "Open Tasks" in the upper right corner, choose "Advanced Filter...", and query for Design tasks (or even add a shortcut link to the side bar which does that, for convenience).

Maybe that would be good enough. My problem is just that I have difficulties with the columns n>4 (which someone else created). While I see that they serve a purpose they are a bit problematic for the other columns.

Documenting the current workboard columns here:

  • Incoming, Next-up, Doing, Blocked: needs help, VisualEditor columns were created by @Physikerwelt between 2014 and 2016.
  • Experiments, Chemistry, New TeX macro proposals, SVG specific, Design, MediaWiki interaction, Mathoid, texvc, MW Math Extension columns were created by @Pkra in late 2018.

These two concepts indeed collide; IMHO this should have never been done.

No matter what will be changed, I'd either remove the columns

  • Design, use Design instead.
  • Mathoid, use Mathoid instead.
  • VisualEditor, use VisualEditor instead.
  • texvc, use Texvcjs instead.
  • MW Math Extension, as Math *is* about the MW Math extension according to the project description. I don't get this column at all.

or if you want these columns to remain on some workboard, you could look into setting up column triggers (see T227300, I have not looked into that yet).

You could add links to the side bar which allow quick filtering on the board, for example https://phabricator.wikimedia.org/project/board/130/?filter=zD7uhYP3PykD will only display open tasks on the board which also have the VisualEditor tag. See "Custom Filter" in the upper right corner.

I think subprojects are out because "Tasks in subprojects will not show up on the workboard of the parent project." and you want to organize your progress in columns on the Math workboard. And milestones only allow to have one single milestone but some tasks might be in more than one of the current columns.

I realized that the situation is pretty much described in Section 5.3.1 in the project management page. Is it possible to create a second board for math and move the columns n>4 to the new board?

That is one option (though maybe the first four columns should move to some new board). The boards should probably link to each other in the side bar.
However, moving stuff on two boards might be more cumbersome.

Another option would be creating a good bunch of independent parent projects called Math-something, one for each current column, and making sure they are all also tagged with Math, and use the Math workboard only for progress tracking.

In both cases we'd need a Herald rule - create at least one other project/board, and then use a Herald rule to always also have the Math project tag automatically added to tasks in the other project/board (and vice versa, if going for the first option / "5.3.1").

@Aklapper sorry for the long silence. Could you please remove the columns you mentioned? I could not find a button for that. Looking at all the columns I think labels are sufficient. Let's try to keep things as simple as possible. Maybe we can create a label for

  • Chemistry
  • New Macro Proposals

For experiments, we can use research ideas and for SVG we could use Wikimedia SVG rendering. Does that make sense?

Could you please remove the columns you mentioned? I could not find a button for that.

No problem. :) @Physikerwelt: You can hide a column via the dropdown in the column header.

Looking at all the columns I think labels are sufficient. Let's try to keep things as simple as possible. Maybe we can create a label for

  • Chemistry
  • New Macro Proposals

I guess "labels" = "project tags"? That means to create #Math-Chemistry and #Math-Macro-Proposals or something like that? In any case, we will need project descriptions for these. Or where to find more info. :)

For experiments, we can use Research ideas and for SVG we could use Wikimedia-SVG-rendering. Does that make sense?

I guess "labels" = "project tags"? That means to create #Math-Chemistry and Math-Macro-Proposals or something like that? In any case, we will need project descriptions for these. Or where to find more info. :)

Yes. That was what I was referring to

#Math-Chemistry The <chem> tag is used to annotate chemical sum formulae. It uses mhchem provided via the Math extension.

Math-Macro-Proposals Proposals to extend the LaTeX based syntax of <math> tags.

Summarizing my current understanding.
I propose option 2.
@Physikerwelt: I still have four open questions down there though...

Option 1

Category columns on Math workboard; progress columns on some new #Math-Sprint project workboard:

  • Create a project called #Math-Sprint (or something like that) which serves as a constant progress tracking workboard only.
  • Set up a Herald rule which always adds #Math-Sprint to a task when the task is tagged with Math (and potentially the other way round).
  • Move current items in "Next-up" and "Doing" columns on current Math workboard to same columns on new #Math-Sprint workboard
  • Move all other items on current Math workboard into the "Incoming" column on new #Math-Sprint workboard
  • Move all items in current columns "Incoming", "Next-up" and "Doing" on current Math workboard into remaining columns (I should not do that)
  • On current Math workboard at https://phabricator.wikimedia.org/project/board/130/ , hide the columns "Incoming", "Next-up" and "Doing".

This Option 1 still creates the problem that some tasks should probably be in more than one category column at the same time.

Option 2

Progress columns on Math workboard; categories expressed by additional project tags:

  • Create new parent project tag #Math-Chemistry
  • Create new parent project tag Math-Macro-Proposals
  • Set up a Herald rule: When a task is tagged with either Math-Macro-Proposals or #Math-Chemistry, also add the Math project tag to that task
    • [QUESTION] Should tasks tagged with Texvcjs and/or Mathoid always also have the Math tag, or never ever have the Math tag, or what's the criterion?
  • On the Math workboard at https://phabricator.wikimedia.org/project/board/130/ ,
    • Add VisualEditor to all tasks in column VisualEditor, then move all tasks in column VisualEditor to Incoming column, then hide column VisualEditor
    • Move all tasks in column MW Math extension to Incoming column, then hide MW Math extension column
    • Add Texvcjs to all tasks in column texvc, then move all tasks in column texvc to Incoming column, then hide column texvc
    • Add Mathoid to all tasks in column Mathoid, then move all tasks in column Mathoid to Incoming column, then hide column Mathoid
    • [QUESTION] Move all tasks in column MediaWiki interaction to Incoming column, then hide column? Or should tasks in this column also have some dedicated and separate parent tag, like #Math-MediaWiki-integration or such? (I'd recommend KISS, if unsure.)
    • Add Design to all tasks in column Design, then move all tasks in column Design to Incoming column, then hide column Design
    • [QUESTION] Either add Wikimedia-SVG-rendering to all tasks in column SVG specific, then move all tasks in column SVG specific to Incoming column, then hide column SVG specific. Or create a new parent project tag called #Math-SVG-specific. The description of Wikimedia-SVG-rendering is "Bugs related to SVG rendering on Wikimedia websites" but Math can also be used outside of Wikimedia, so creating #Math-SVG-specific might make more sense?
    • Add Math-Macro-Proposals to all tasks in column New TeX macro proposals, then move all tasks in column New TeX macro proposals to Incoming column, then hide column New TeX macro proposals
    • Add #Math-Chemistry to all tasks in column Chemistry, then move all tasks in column Chemistry to Incoming column, then hide column Chemistry
    • Add Research ideas to all tasks in column Experiments, then move all tasks in column Experiments to Incoming column, then hide column Experiments
  • Potentially add shortcut links to the sidebar of https://phabricator.wikimedia.org/tag/math/, like already existing "MathSearch", "texvcjs" and "mathoid" links
  • [QUESTION] Potentially add a "Math only" shortcut link to the sidebar which only displays tasks on the workboard which DO NOT have any of the tags MathSearch, Texvcjs, Mathoid, etc?

@Aklapper thank you very much. I like Option 2

Option 2

Progress columns on Math workboard; categories expressed by additional project tags:

  • Set up a Herald rule: When a task is tagged with either Math-Macro-Proposals or #Math-Chemistry, also add the Math project tag to that task
    • [QUESTION] Should tasks tagged with Texvcjs and/or Mathoid always also have the Math tag, or never ever have the Math tag, or what's the criterion?

Yes. That would make a lot of sense. That way we can see all issues on the math board

  • On the Math workboard at https://phabricator.wikimedia.org/project/board/130/ ,
    • Add Mathoid to all tasks in column Mathoid, then move all tasks in column Mathoid to Incoming column, then hide column Mathoid
    • [QUESTION] Move all tasks in column MediaWiki interaction to Incoming column, then hide column? Or should tasks in this column also have some dedicated and separate parent tag, like #Math-MediaWiki-integration or such? (I'd recommend KISS, if unsure.)

I do not understand what this group is about. So we don't need another tag.

  • [QUESTION] Either add Wikimedia-SVG-rendering to all tasks in column SVG specific, then move all tasks in column SVG specific to Incoming column, then hide column SVG specific. Or create a new parent project tag called #Math-SVG-specific. The description of Wikimedia-SVG-rendering is "Bugs related to SVG rendering on Wikimedia websites" but Math can also be used outside of Wikimedia, so creating #Math-SVG-specific might make more sense?

Most of the current issues are unrelated to math. Any SVG image would have that problem. There is currently no issue that is not related to Wikimedia. As there is not too much to do from the math extension perspective, I think an extra tag math-svg would not be very helpful

  • Potentially add shortcut links to the sidebar of https://phabricator.wikimedia.org/tag/math/, like already existing "MathSearch", "texvcjs" and "mathoid" links
  • [QUESTION] Potentially add a "Math only" shortcut link to the sidebar which only displays tasks on the workboard which DO NOT have any of the tags MathSearch, Texvcjs, Mathoid, etc?

Thank you, but I currently do not see how I would use that button. I hope that people from the VE team are interested in tickets with math and visualeditor.

In addition, it would be good to create or reuse a tag for non-wmf installations, such as T253680 T249881 T242919 T233641 T231101 T200493.

Aklapper claimed this task.

On the Math workboard at https://phabricator.wikimedia.org/project/board/130/ ,

Closing as resolved.