Wiki source code of Highlights on a Page
Last modified by Eleni Cojocariu on 2026/03/24 09:49
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Highlights are part of both [[landing pages>>Community.DocGuide.CreateLandingPages.WebHome]] and [[structured documentation pages>>Community.DocGuide.PageStructure.WebHome]]. For the topic landing pages the Documentation Team is usually handling the Highlights, but you may [[propose changes>>||anchor="HProposingChangestotheHighlights"]]. For the documentation pages you create, if the page has more than 15 child pages, it should include Highlights and follow the [[criteria for selecting highlighted pages>>||anchor="HCriteriaforSelectingHighlightedPages"]]. A maximum of 6 cards for highlights is allowed to maintain a clean and visually appealing page layout. | ||
| 2 | |||
| 3 | == Proposing Changes to the Highlights == | ||
| 4 | |||
| 5 | Anyone who wants to propose a change to the Highlights can edit and [[save with Change Request>>xwiki:documentation.extensions.user.change-request.create.save.WebHome]] or ask on the [[#xwiki Matrix chat>>dev:Community.Chat]]. The [[Documentation Manager>>dev:Community.DevelopmentPractices||anchor="HDocumentationManagerRole"]] will review and update the Highlights. | ||
| 6 | |||
| 7 | == Criteria for Selecting Highlighted Pages == | ||
| 8 | |||
| 9 | There are some common criteria that can guide the selection of which pages to highlight: | ||
| 10 | |||
| 11 | * Relevant pages to newcomers | ||
| 12 | * Use Pages that are frequently accessed as a reference | ||
| 13 | * Pages that address common issues | ||
| 14 | * Pages that cover essential topics (useful for many situations, containing a lot of important information). |