wagtail / guide

A website to teach Wagtail CMS to content editors, moderators and administrators.
https://guide.wagtail.org
BSD 3-Clause "New" or "Revised" License
31 stars 26 forks source link

Overview of Aging pages is Missing in Documentation #335

Open nouman17610 opened 8 months ago

nouman17610 commented 8 months ago

The purpose of Aging pages is to report the pages on the basis of their age. You can see the list of pages from the latest to the latest pages.

Aging-pages-Wagtail

Why it should be documented? The first-time user finds it difficult to understand the purpose of the Aging pages feature. The user needs a clear understanding of the purpose of the Aging Pages webpage. The overview of the page would help a user to avoid any confusion while managing the aging pages. Clear guidelines to use filters increase efficiency and avoid confusion. Documentation should maintain consistency in providing clear guidelines about the pages and features.

How it should be documented? There is a need for an overview of the purpose of the Aging pages feature. Furthermore, "How to use filters to see reports" guide is required.

thibaudcolas commented 8 months ago

@nouman17610 is this not already considered in https://guide.wagtail.org/en-latest/concepts/reports/#aging-pages-report ? Do you think there is more content needed?

nouman17610 commented 8 months ago

@thibaudcolas You are right this is mentioned in the Reports Section. I believe that information is not sufficient to cover all elements on the page. This information is good for repeated users but first-time user needs clear and complete information regarding the purpose of the Aging Pages Report.

It is important to add the following details to the Aging page guide.

Overall, existing content for Aging Pages doesn't provide a complete guide to do necessary actions for the Aging Pages. More details are required to equip the user with complete information.