Talk:Documentation/Tools/Documentation metrics dashboard

Dashboard - available metrics

I would also like to have among the available metrics (in v1 or future versions, whatever makes sense):

• (relatively easy to get): Page length, number of sections / headers, depth of headers (this is to reason about page structure and eventually, hopefully, be able to relate it to content types)
• (maybe easy to get?): Number of comments or open topics on the page's Talk page (this is to reason about reader confusion or potential content gaps)
• (probably hard to get): Readability score (not sure if this would fall under "Linter integration"?)

TBurmeister (WMF) (talk) 15:56, 10 May 2023 (UTC)

Some of these would definitely be more difficult to develop than others. If you think any of these would still be useful to you, please create feature requests in Phabricator. KBach-WMF (talk) 14:16, 25 November 2024 (UTC)

Create lists of pages using page metadata or subpage structure?

In addition to the views you describe for the MVP, I'm curious if for future versions, either PagePile or GULP (or the docs dashboard itself) might be able to support these additional ways of viewing metrics:

• Input a parent page --> see metrics for its subpages, both in aggregate and with the option to display single-page metrics
• Input a category (or multiple categories) --> see metrics for all pages tagged with those categories, both in aggregate and with the option to drill down to individual pages

I know we've discussed this but I can't remember what you said about it, and I want to write it down so I don't forget again :-) TBurmeister (WMF) (talk) 16:03, 10 May 2023 (UTC)

We can definitely consider these as features for future development. Please feel free to create Phabricator tickets with feature requests in the Documentation Metrics Dashboard project :) KBach-WMF (talk) 14:13, 25 November 2024 (UTC)

What does "content not found" mean?

In the dashboard, for the "Translations" table, what does "Content not found" mean? Does it mean the dashboard didn't find the page, or it didn't find translate syntax on the page? How is "Content not found" different from "No"? For example, the dashboard for pile #54715 contains both values: https://techdoc-dashboard.toolforge.org/dashboard/54715 TBurmeister (WMF) (talk) 16:58, 1 November 2024 (UTC)

"Content not found" indicates that the dashboard was not able to load page content to scan it for translation syntax. This usually means the page has moved and the page pile is outdated. KBach-WMF (talk) 14:08, 25 November 2024 (UTC)

What is the difference between "big edit" and "major edit", "small edit" and "minor edit"

In the "Edit sizes" section, there are four different items displayed in the graph and the table, but I don't understand the difference them. What is a "big edit" vs. a "major edit"? And the same question for small vs. minor. TBurmeister (WMF) (talk) 16:21, 18 November 2024 (UTC)

Major and minor edits follow wiki terminology as described on Help:Minor edit. Any edit that is equal or greater than 1000 bytes in size is a "big edit". Any edit smaller than 1000 bytes is a "small edit". KBach-WMF (talk) 14:04, 25 November 2024 (UTC)