Topic on Talk:Phabricator/Help

@AKlapper (WMF) Revision where can I put this where you'll be happy.

Hi, I just found Phabricator/High level Phabricator concepts. Probably that's what you're looking for?

Sure. I guess I could combine what I have. But why can't we put it on the main help page? That page is not linked on any other page.

If the question is about your initial edit: Throwing a list of terms onto the very top of a help page does not help anyone who has not (literally) seen Phabricator before. Help is for folks who need to get tasks/work done and solve a specific action-oriented problem. That page can be linked from "See Also", I guess.

It's meant to be a high level overview, just as the other page is. You may not understand all of it first as a new contributor, but it can provide a much better understanding of what Phabricator does and how it is organized than trail and error or looking through the immense amount of documentation on that page that doesn't even explain the details of how tasks work. Users can also return to it after they've seen a task and then understand the different parts of tasks and projects. I had to do trial and error as a new contributor trying to find my way through how projects work, what subscriptions are, etc. and it took me much longer to figure out anything than if I had an overview like this.

Makes sense. Different people have different learning patterns. That's why I'd recommend Phabricator/High level Phabricator concepts.

Why can't we have a section here? It seems silly to immediately show the user a set of videos giving an overview of Phabricator on this page but not have a text equivalent.

I'd say that a list of user interface elements is not a text equivalent to an explanation how to achieve getting a task done.

The File:Phabricator - Tasks.webm video literally explains all of the elements of a task just like the high-level overview does...

@AKlapper (WMF) any response?

I'm not sure what else to add... Phabricator/High level Phabricator concepts has a different target (high level concepts) than the Help page which is explicitly about getting things done (activity based).

Well if the Help page contains videos that describe the same things the overview does, then it doesn't make sense that the videos can be there and the list cannot.

The videos don't describe the same things that the overview does as the videos don't throw a long list of things at people.

They literally do. Go watch File:Phabricator - Tasks.webm. This video describes the same things and even more than the list does.

throw a long list of things at people

1. The list is not long.
2. You're throwing a 10 minute video at them instead.

It describes aspects of tasks and how to use them - activities. We may disagree here and I still think that a long list of bullet points describing some non-shown interface does not help most people who want to get a job done. I have pointed to Phabricator/High level Phabricator concepts already so I'm not sure what you are after?

Also, please note that the linked revision includes incorrect statements. For example, there are more than three task types.