Use uiop:define-package in package section

[kilianmh]

uiop define-package is more flexible with additional clauses and more convenient during development (e.g. when symbols change).

I want to add some examples in the packages page for uiop:define-package.

Currently there are only examples with cl:defpackage.
My question is: Should we add a few examples with uiop:define-package but keep it mostly with cl:defpackage or should we convert most package definitions to uiop:define-package and only showcase few examples of cl:defpackage?

[vindarel]

Hi, I think it's great if we mention it (even required), maybe not in the introductory examples. defpackage works when we begin, after all.

Shall we add a second "packages (advanced)" page?

Presenting define-package's other clauses, the difference in behavior, also shadowing imports would be very useful.