https://wikitech.wikimedia.org/wiki/Help:Toolforge/Kubernetes#Quotas_and_Resources is marked for moving to a new doc and I would like to understand where @TBurmeister or others in the tech writing role feel it should be listed. The quotas are Kubernetes specific and shared across the Web and Job Service consumers along with any other direct k8s usage that a tool may choose to pursue for itself. To me it makes sense to keep that use case crossing information in a central location that is also directly related to the platform it is documenting, meaning in this case the Kubernetes page.

The new document I suggested creating when I filed this would be a how-to page focused on the task of managing tool quota and resources. For example, a new page entitled "Manage tool quota and resources". Right now, this content being in a k8s-specific document requires users to understand what k8s is and get familiar with it in order to be able to find the information. It also requires visiting many different docs to try to understand how to work with tool quota -- the information is not all covered in the k8s section on quota. The conceptual structure of the docs should be focused first on the user's task, then on the technologies that support that task, rather than vice versa -- because the underlying technologies change over time, but the users' tasks are generally the same. It's also easier to get things done when the information related to one task is in one document, rather than mixed with other content in a document focusing on a larger topic like k8s instead of a task-focused topic like "how to manage your tool's resources".