Skip to content
GitLab
Projects Groups Topics Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • D Developer Tutorial and Article Site
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributor statistics
    • Graph
    • Compare revisions
  • Issues 55
    • Issues 55
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 15
    • Merge requests 15
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Releases
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • DocumentationDocumentation
  • Developer Tutorial and Article Site
  • Merge requests
  • !235

Update Kirigami tutorial

  • Review changes

  • Download
  • Email patches
  • Plain diff
Merged Thiago Sueto requested to merge thiagosueto/develop-kde-org:work/thiagosueto/kirigami into master Jan 15, 2023
  • Overview 185
  • Commits 119
  • Pipelines 110
  • Changes 131

Only minor blockers now, they should be done by the end of the month:

  • Remove org::kde::kirigami:: section of certain links
  • Lessen the use of API links where not needed (e.g. form layout instead of FormLayout) (Style: should follow max of 1 of the same API link in the same paragraph)
  • Fix some page weights (style pages)
  • Remove excessive comments and add where needed/relevant
  • Add alternative text for accessibility
  • Check which images should use the {{< figure >}} shortcode
  • Move ListModel functions to introduction-listviews (it's actually fine where it is)
  • Retroactively check if there are still code examples using tabs instead of 4 spaces (introduction-actions?)
  • Add more beginner C++ resources
  • Test Kirigami gallery
  • Recheck style-colors to mention qqc2-breeze-style and qqc2-desktop-style (Does not concern app developers)
  • Confirm that PageRow links work
  • Check what needs to be done with deprecated ItemViewHeader in components-listviews (full deletion, removed from KF6)
  • Check every code example for correctness and buildability

Important reminders:

  • See if there's a friendlier way to implement the singleton in about-page
  • Write a STYLE.md guide for this repo's readme (e.g. avoid API links abuse, introduction to the API by mentioning namespace etc)
  • Document {{< sections >}} and {{< compare >}} shortcode in this repo's readme, consider moving most of it to CONTRIBUTING.md

Self-hosted version for previewing the results: http://vps22927.publiccloud.com.br:6789/docs/use/kirigami/

To test this MR:

git clone https://invent.kde.org/documentation/develop-kde-org.git
cd develop-kde-org
git mr 235
hugo server
Edited Feb 11, 2023 by Thiago Sueto
Assignee
Assign to
Reviewers
Request review from
Time tracking
Source branch: work/thiagosueto/kirigami