From 1c2ff27dcd23f2e911050a698d9e3d79e3ec43b4 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Fri, 10 Jan 2025 17:40:37 +0100
Subject: [PATCH 01/15] mark as deprecated

---
 api/helper/builder/ocm_comparch.go            |  2 +
 .../handlers/ocm/comparch/blobhandler.go      |  4 ++
 .../repositories/comparch/componentarchive.go | 30 +++++++++++++
 .../repositories/comparch/format.go           | 17 +++++++
 .../repositories/comparch/repository.go       | 44 +++++++++++++++++++
 .../extensions/repositories/comparch/type.go  |  9 ++++
 .../repositories/comparch/uniform.go          |  2 +
 cmds/ocm/app/app.go                           |  2 +-
 .../commands/ocmcmds/componentarchive/cmd.go  |  2 +
 .../ocmcmds/componentarchive/create/cmd.go    |  9 +++-
 .../ocmcmds/componentarchive/transfer/cmd.go  |  8 +++-
 cmds/ocm/commands/ocmcmds/names/names.go      |  1 +
 examples/make/Makefile                        |  7 +--
 13 files changed, 131 insertions(+), 6 deletions(-)

diff --git a/api/helper/builder/ocm_comparch.go b/api/helper/builder/ocm_comparch.go
index 45b14789c8..792d0e2569 100644
--- a/api/helper/builder/ocm_comparch.go
+++ b/api/helper/builder/ocm_comparch.go
@@ -7,8 +7,10 @@ import (
 	"ocm.software/ocm/api/utils/accessobj"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 const T_COMPARCH = "component archive"
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (b *Builder) ComponentArchive(path string, fmt accessio.FileFormat, name, vers string, f ...func()) {
 	r, err := comparch.Open(b.OCMContext(), accessobj.ACC_WRITABLE|accessobj.ACC_CREATE, path, 0o777, accessio.PathFileSystem(b.FileSystem()))
 	b.failOn(err)
diff --git a/api/ocm/extensions/blobhandler/handlers/ocm/comparch/blobhandler.go b/api/ocm/extensions/blobhandler/handlers/ocm/comparch/blobhandler.go
index a057a1666d..9e05b22440 100644
--- a/api/ocm/extensions/blobhandler/handlers/ocm/comparch/blobhandler.go
+++ b/api/ocm/extensions/blobhandler/handlers/ocm/comparch/blobhandler.go
@@ -15,19 +15,23 @@ import (
 	common "ocm.software/ocm/api/utils/misc"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func init() {
 	cpi.RegisterBlobHandler(NewBlobHandler(), cpi.ForRepo(cpi.CONTEXT_TYPE, comparch.Type))
 }
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // blobHandler is the default handling to store local blobs as local blobs.
 type blobHandler struct{}
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func NewBlobHandler() cpi.BlobHandler {
 	return &blobHandler{}
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (b *blobHandler) StoreBlob(blob cpi.BlobAccess, artType, hint string, global cpi.AccessSpec, ctx cpi.StorageContext) (cpi.AccessSpec, error) {
 	ocmctx, ok := ctx.(storagecontext.StorageContext)
 	if !ok {
diff --git a/api/ocm/extensions/repositories/comparch/componentarchive.go b/api/ocm/extensions/repositories/comparch/componentarchive.go
index aab4b1020a..f291bcd9d8 100644
--- a/api/ocm/extensions/repositories/comparch/componentarchive.go
+++ b/api/ocm/extensions/repositories/comparch/componentarchive.go
@@ -20,8 +20,10 @@ import (
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type _componentVersionAccess = cpi.ComponentVersionAccess
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // ComponentArchive is the go representation for a component artifact.
 type ComponentArchive struct {
 	_componentVersionAccess
@@ -31,6 +33,7 @@ type ComponentArchive struct {
 	nonref    cpi.Repository
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // New returns a new representation based element.
 func New(ctx cpi.Context, acc accessobj.AccessMode, fs vfs.FileSystem, setup accessobj.Setup, closer accessobj.Closer, mode vfs.FileMode) (*ComponentArchive, error) {
 	obj, err := accessobj.NewAccessObject(accessObjectInfo, acc, fs, setup, closer, mode)
@@ -41,6 +44,7 @@ func New(ctx cpi.Context, acc accessobj.AccessMode, fs vfs.FileSystem, setup acc
 	return _Wrap(ctx, obj, spec, err)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func _Wrap(ctx cpi.ContextProvider, obj *accessobj.AccessObject, spec *RepositorySpec, err error) (*ComponentArchive, error) {
 	if err != nil {
 		return nil, err
@@ -67,41 +71,50 @@ func _Wrap(ctx cpi.ContextProvider, obj *accessobj.AccessObject, spec *Repositor
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var _ cpi.ComponentVersionAccess = &ComponentArchive{}
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentArchive) Close() error {
 	return c.main.Close()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentArchive) IsReadOnly() bool {
 	return c.container.IsReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentArchive) SetReadOnly() {
 	c.container.SetReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // Repository returns a non referencing repository which does not
 // close the archive.
 func (c *ComponentArchive) Repository() cpi.Repository {
 	return c.nonref
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // AsRepository returns a repository view closing the archive.
 func (c *ComponentArchive) AsRepository() cpi.Repository {
 	return c.main
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentArchive) SetName(n string) {
 	c.GetDescriptor().Name = n
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentArchive) SetVersion(v string) {
 	c.GetDescriptor().Version = v
 }
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type componentArchiveContainer struct {
 	ctx   cpi.Context
 	base  repocpi.ComponentVersionAccessBridge
@@ -110,42 +123,52 @@ type componentArchiveContainer struct {
 	repo  cpi.Repository
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var _ repocpi.ComponentVersionAccessImpl = (*componentArchiveContainer)(nil)
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) SetBridge(base repocpi.ComponentVersionAccessBridge) {
 	c.base = base
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) GetParentBridge() repocpi.ComponentAccessBridge {
 	return nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) Close() error {
 	var list errors.ErrorList
 	_, err := c.Update()
 	return list.Add(err, c.fsacc.Close()).Result()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) GetContext() cpi.Context {
 	return c.ctx
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) Repository() cpi.Repository {
 	return c.repo
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) IsReadOnly() bool {
 	return c.fsacc.IsReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) SetReadOnly() {
 	c.fsacc.SetReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) Update() (bool, error) {
 	return c.fsacc.Update()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) SetDescriptor(cd *compdesc.ComponentDescriptor) (bool, error) {
 	if c.fsacc.IsReadOnly() {
 		return false, accessobj.ErrReadOnly
@@ -155,6 +178,7 @@ func (c *componentArchiveContainer) SetDescriptor(cd *compdesc.ComponentDescript
 	return c.fsacc.Update()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) GetDescriptor() *compdesc.ComponentDescriptor {
 	if c.fsacc.IsReadOnly() {
 		return c.fsacc.GetState().GetOriginalState().(*compdesc.ComponentDescriptor)
@@ -162,18 +186,22 @@ func (c *componentArchiveContainer) GetDescriptor() *compdesc.ComponentDescripto
 	return c.fsacc.GetState().GetState().(*compdesc.ComponentDescriptor)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) GetBlob(name string) (cpi.DataAccess, error) {
 	return c.fsacc.GetBlobDataByName(name)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) GetStorageContext() cpi.StorageContext {
 	return ocmhdlr.New(c.Repository(), c.base.GetName(), &BlobSink{c.fsacc}, Type)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type BlobSink struct {
 	Sink ocicpi.BlobSink
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (s *BlobSink) AddBlob(blob blobaccess.BlobAccess) (string, error) {
 	err := s.Sink.AddBlob(blob)
 	if err != nil {
@@ -182,6 +210,7 @@ func (s *BlobSink) AddBlob(blob blobaccess.BlobAccess) (string, error) {
 	return blob.Digest().String(), nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) AddBlob(blob cpi.BlobAccess, refName string, global cpi.AccessSpec) (cpi.AccessSpec, error) {
 	if blob == nil {
 		return nil, errors.New("a resource has to be defined")
@@ -193,6 +222,7 @@ func (c *componentArchiveContainer) AddBlob(blob cpi.BlobAccess, refName string,
 	return localblob.New(common.DigestToFileName(blob.Digest()), refName, blob.MimeType(), global), nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *componentArchiveContainer) AccessMethod(a cpi.AccessSpec, cv refmgmt.ExtendedAllocatable) (cpi.AccessMethod, error) {
 	if a.GetKind() == localblob.Type || a.GetKind() == localfsblob.Type {
 		accessSpec, err := c.GetContext().AccessSpecForSpec(a)
diff --git a/api/ocm/extensions/repositories/comparch/format.go b/api/ocm/extensions/repositories/comparch/format.go
index de3548141d..005714d295 100644
--- a/api/ocm/extensions/repositories/comparch/format.go
+++ b/api/ocm/extensions/repositories/comparch/format.go
@@ -13,12 +13,15 @@ import (
 	"ocm.software/ocm/api/utils/accessobj"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // ComponentDescriptorFileName is the name of the component-descriptor file.
 const ComponentDescriptorFileName = compdesc.ComponentDescriptorFileName
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // BlobsDirectoryName is the name of the blob directory in the tar.
 const BlobsDirectoryName = "blobs"
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var accessObjectInfo = &accessobj.DefaultAccessObjectInfo{
 	DescriptorFileName:       ComponentDescriptorFileName,
 	ObjectTypeName:           "component archive",
@@ -28,13 +31,16 @@ var accessObjectInfo = &accessobj.DefaultAccessObjectInfo{
 	DescriptorValidator:      validateDescriptor,
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func validateDescriptor(data []byte) error {
 	_, err := compdesc.Decode(data)
 	return err
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type Object = ComponentArchive
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type FormatHandler interface {
 	accessio.Option
 
@@ -45,10 +51,12 @@ type FormatHandler interface {
 	Write(obj *Object, path string, opts accessio.Options, mode vfs.FileMode) error
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type formatHandler struct {
 	accessobj.FormatHandler
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var (
 	FormatDirectory = RegisterFormat(accessobj.FormatDirectory)
 	FormatTAR       = RegisterFormat(accessobj.FormatTAR)
@@ -57,11 +65,13 @@ var (
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var (
 	fileFormats = map[accessio.FileFormat]*formatHandler{}
 	lock        sync.RWMutex
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func RegisterFormat(f accessobj.FormatHandler) *formatHandler {
 	lock.Lock()
 	defer lock.Unlock()
@@ -70,12 +80,14 @@ func RegisterFormat(f accessobj.FormatHandler) *formatHandler {
 	return h
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func GetFormats() []string {
 	lock.RLock()
 	defer lock.RUnlock()
 	return accessio.GetFormatsFor(fileFormats)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func GetFormat(name accessio.FileFormat) FormatHandler {
 	lock.RLock()
 	defer lock.RUnlock()
@@ -88,6 +100,7 @@ func GetFormat(name accessio.FileFormat) FormatHandler {
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func Open(ctx cpi.ContextProvider, acc accessobj.AccessMode, path string, mode vfs.FileMode, olist ...accessio.Option) (*Object, error) {
 	opts, err := accessio.AccessOptions(&accessio.StandardOptions{PathFileSystem: vfsattr.Get(ctx.OCMContext())}, olist...)
 	if err != nil {
@@ -107,6 +120,7 @@ func Open(ctx cpi.ContextProvider, acc accessobj.AccessMode, path string, mode v
 	return h.Open(ctx, acc, path, o)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func Create(ctx cpi.ContextProvider, acc accessobj.AccessMode, path string, mode vfs.FileMode, opts ...accessio.Option) (*Object, error) {
 	o, err := accessio.AccessOptions(nil, opts...)
 	if err != nil {
@@ -122,6 +136,7 @@ func Create(ctx cpi.ContextProvider, acc accessobj.AccessMode, path string, mode
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (h *formatHandler) Open(ctx cpi.ContextProvider, acc accessobj.AccessMode, path string, opts accessio.Options) (*Object, error) {
 	obj, err := h.FormatHandler.Open(accessObjectInfo, acc, path, opts)
 	if err != nil {
@@ -131,6 +146,7 @@ func (h *formatHandler) Open(ctx cpi.ContextProvider, acc accessobj.AccessMode,
 	return _Wrap(ctx, obj, spec, err)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (h *formatHandler) Create(ctx cpi.ContextProvider, path string, opts accessio.Options, mode vfs.FileMode) (*Object, error) {
 	obj, err := h.FormatHandler.Create(accessObjectInfo, path, opts, mode)
 	if err != nil {
@@ -140,6 +156,7 @@ func (h *formatHandler) Create(ctx cpi.ContextProvider, path string, opts access
 	return _Wrap(ctx, obj, spec, err)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // WriteToFilesystem writes the current object to a filesystem.
 func (h *formatHandler) Write(obj *Object, path string, opts accessio.Options, mode vfs.FileMode) error {
 	return h.FormatHandler.Write(obj.container.fsacc.Access(), path, opts, mode)
diff --git a/api/ocm/extensions/repositories/comparch/repository.go b/api/ocm/extensions/repositories/comparch/repository.go
index 8ce509bf96..92d2ac0f0b 100644
--- a/api/ocm/extensions/repositories/comparch/repository.go
+++ b/api/ocm/extensions/repositories/comparch/repository.go
@@ -22,6 +22,7 @@ import (
 	"ocm.software/ocm/api/utils/refmgmt"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type RepositoryImpl struct {
 	lock   sync.RWMutex
 	bridge repocpi.RepositoryBridge
@@ -29,8 +30,10 @@ type RepositoryImpl struct {
 	nonref cpi.Repository
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var _ repocpi.RepositoryImpl = (*RepositoryImpl)(nil)
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func NewRepository(ctxp cpi.ContextProvider, s *RepositorySpec) (cpi.Repository, error) {
 	ctx := datacontext.InternalContextRef(ctxp.OCMContext())
 	if s.GetPathFileSystem() == nil {
@@ -52,31 +55,38 @@ func newRepository(a *ComponentArchive) (main, nonref cpi.Repository) {
 	return r, impl.nonref
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) Close() error {
 	return r.arch.container.Close()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) IsReadOnly() bool {
 	return r.arch.IsReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) SetReadOnly() {
 	r.arch.SetReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) SetBridge(base repocpi.RepositoryBridge) {
 	r.bridge = base
 	r.nonref = repocpi.NewNoneRefRepositoryView(base)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) GetContext() cpi.Context {
 	return r.arch.GetContext()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) ComponentLister() cpi.ComponentLister {
 	return r
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) matchPrefix(prefix string, closure bool) bool {
 	if r.arch.GetName() != prefix {
 		if prefix != "" && !strings.HasSuffix(prefix, "/") {
@@ -89,6 +99,7 @@ func (r *RepositoryImpl) matchPrefix(prefix string, closure bool) bool {
 	return true
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) NumComponents(prefix string) (int, error) {
 	r.lock.RLock()
 	defer r.lock.RUnlock()
@@ -101,6 +112,7 @@ func (r *RepositoryImpl) NumComponents(prefix string) (int, error) {
 	return 1, nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) GetComponents(prefix string, closure bool) ([]string, error) {
 	r.lock.RLock()
 	defer r.lock.RUnlock()
@@ -113,6 +125,7 @@ func (r *RepositoryImpl) GetComponents(prefix string, closure bool) ([]string, e
 	return []string{r.arch.GetName()}, nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) Get() *ComponentArchive {
 	r.lock.RLock()
 	defer r.lock.RUnlock()
@@ -122,10 +135,12 @@ func (r *RepositoryImpl) Get() *ComponentArchive {
 	return nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) GetSpecification() cpi.RepositorySpec {
 	return r.arch.spec
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) ExistsComponentVersion(name string, ref string) (bool, error) {
 	r.lock.RLock()
 	defer r.lock.RUnlock()
@@ -135,6 +150,7 @@ func (r *RepositoryImpl) ExistsComponentVersion(name string, ref string) (bool,
 	return r.arch.GetName() == name && r.arch.GetVersion() == ref, nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (r *RepositoryImpl) LookupComponent(name string) (*repocpi.ComponentAccessInfo, error) {
 	r.lock.RLock()
 	defer r.lock.RUnlock()
@@ -149,11 +165,13 @@ func (r *RepositoryImpl) LookupComponent(name string) (*repocpi.ComponentAccessI
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type ComponentAccessImpl struct {
 	base repocpi.ComponentAccessBridge
 	repo *RepositoryImpl
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var _ repocpi.ComponentAccessImpl = (*ComponentAccessImpl)(nil)
 
 func newComponentAccess(r *RepositoryImpl) (*repocpi.ComponentAccessInfo, error) {
@@ -163,38 +181,47 @@ func newComponentAccess(r *RepositoryImpl) (*repocpi.ComponentAccessInfo, error)
 	return &repocpi.ComponentAccessInfo{impl, "component archive", true}, nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) Close() error {
 	return nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) SetBridge(base repocpi.ComponentAccessBridge) {
 	c.base = base
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) GetParentBridge() repocpi.RepositoryViewManager {
 	return c.repo.bridge
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) GetContext() cpi.Context {
 	return c.repo.GetContext()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) GetName() string {
 	return c.repo.arch.GetName()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) IsReadOnly() bool {
 	return c.repo.arch.IsReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) ListVersions() ([]string, error) {
 	return []string{c.repo.arch.GetVersion()}, nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) HasVersion(vers string) (bool, error) {
 	return vers == c.repo.arch.GetVersion(), nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) LookupVersion(version string) (*repocpi.ComponentVersionAccessInfo, error) {
 	if version != c.repo.arch.GetVersion() {
 		return nil, errors.ErrNotFound(cpi.KIND_COMPONENTVERSION, fmt.Sprintf("%s:%s", c.GetName(), c.repo.arch.GetVersion()))
@@ -202,6 +229,7 @@ func (c *ComponentAccessImpl) LookupVersion(version string) (*repocpi.ComponentV
 	return newComponentVersionAccess(c, version, false)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentAccessImpl) NewVersion(version string, overrides ...bool) (*repocpi.ComponentVersionAccessInfo, error) {
 	if version != c.repo.arch.GetVersion() {
 		return nil, errors.ErrNotSupported(cpi.KIND_COMPONENTVERSION, version, fmt.Sprintf("component archive %s:%s", c.GetName(), c.repo.arch.GetVersion()))
@@ -214,6 +242,7 @@ func (c *ComponentAccessImpl) NewVersion(version string, overrides ...bool) (*re
 
 ////////////////////////////////////////////////////////////////////////////////
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type ComponentVersionContainer struct {
 	impl repocpi.ComponentVersionAccessBridge
 
@@ -222,6 +251,7 @@ type ComponentVersionContainer struct {
 	descriptor *compdesc.ComponentDescriptor
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var _ repocpi.ComponentVersionAccessImpl = (*ComponentVersionContainer)(nil)
 
 func newComponentVersionAccess(comp *ComponentAccessImpl, version string, persistent bool) (*repocpi.ComponentVersionAccessInfo, error) {
@@ -239,57 +269,70 @@ func newComponentVersionContainer(comp *ComponentAccessImpl) (*ComponentVersionC
 	}, nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) SetBridge(impl repocpi.ComponentVersionAccessBridge) {
 	c.impl = impl
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) GetParentBridge() repocpi.ComponentAccessBridge {
 	return c.comp.base
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) Close() error {
 	return nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) GetContext() cpi.Context {
 	return c.comp.GetContext()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) Repository() cpi.Repository {
 	return c.comp.repo.arch.nonref
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) IsReadOnly() bool {
 	return c.comp.repo.arch.IsReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) SetReadOnly() {
 	c.comp.repo.arch.SetReadOnly()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) Update() (bool, error) {
 	desc := c.comp.repo.arch.GetDescriptor()
 	*desc = *c.descriptor.Copy()
 	return c.comp.repo.arch.container.Update()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) SetDescriptor(cd *compdesc.ComponentDescriptor) (bool, error) {
 	*c.descriptor = *cd
 	return c.Update()
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) GetDescriptor() *compdesc.ComponentDescriptor {
 	return c.descriptor
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) GetBlob(name string) (cpi.DataAccess, error) {
 	return c.comp.repo.arch.container.GetBlob(name)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) GetStorageContext() cpi.StorageContext {
 	return ocmhdlr.New(c.Repository(), c.comp.GetName(), &BlobSink{c.comp.repo.arch.container.fsacc}, Type)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) AddBlob(blob cpi.BlobAccess, refName string, global cpi.AccessSpec) (cpi.AccessSpec, error) {
 	if blob == nil {
 		return nil, errors.New("a resource has to be defined")
@@ -301,6 +344,7 @@ func (c *ComponentVersionContainer) AddBlob(blob cpi.BlobAccess, refName string,
 	return localblob.New(common.DigestToFileName(blob.Digest()), refName, blob.MimeType(), global), nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (c *ComponentVersionContainer) AccessMethod(a cpi.AccessSpec, cv refmgmt.ExtendedAllocatable) (cpi.AccessMethod, error) {
 	if a.GetKind() == localblob.Type || a.GetKind() == localfsblob.Type {
 		accessSpec, err := c.GetContext().AccessSpecForSpec(a)
diff --git a/api/ocm/extensions/repositories/comparch/type.go b/api/ocm/extensions/repositories/comparch/type.go
index 00af926f0b..626683ff4e 100644
--- a/api/ocm/extensions/repositories/comparch/type.go
+++ b/api/ocm/extensions/repositories/comparch/type.go
@@ -11,6 +11,7 @@ import (
 	"ocm.software/ocm/api/utils/runtime"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 const (
 	Type   = "ComponentArchive"
 	TypeV1 = Type + runtime.VersionSeparator + "v1"
@@ -21,6 +22,7 @@ func init() {
 	cpi.RegisterRepositoryType(cpi.NewRepositoryType[*RepositorySpec](TypeV1, nil))
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type RepositorySpec struct {
 	runtime.ObjectVersionedType `json:",inline"`
 	accessio.StandardOptions    `json:",omitempty"`
@@ -31,12 +33,14 @@ type RepositorySpec struct {
 	AccessMode accessobj.AccessMode `json:"accessMode,omitempty"`
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var (
 	_ accessio.Option                      = (*RepositorySpec)(nil)
 	_ cpi.RepositorySpec                   = (*RepositorySpec)(nil)
 	_ cpi.IntermediateRepositorySpecAspect = (*RepositorySpec)(nil)
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewRepositorySpec creates a new RepositorySpec.
 func NewRepositorySpec(acc accessobj.AccessMode, filePath string, opts ...accessio.Option) (*RepositorySpec, error) {
 	spec := &RepositorySpec{
@@ -52,18 +56,22 @@ func NewRepositorySpec(acc accessobj.AccessMode, filePath string, opts ...access
 	return spec, nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (a *RepositorySpec) IsIntermediate() bool {
 	return true
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (a *RepositorySpec) GetType() string {
 	return Type
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (a *RepositorySpec) Repository(ctx cpi.Context, creds credentials.Credentials) (cpi.Repository, error) {
 	return NewRepository(ctx, a)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (a *RepositorySpec) AsUniformSpec(ctx cpi.Context) *cpi.UniformRepositorySpec {
 	opts := a.StandardOptions
 	opts.Default(vfsattr.Get(ctx))
@@ -75,6 +83,7 @@ func (a *RepositorySpec) AsUniformSpec(ctx cpi.Context) *cpi.UniformRepositorySp
 	return &cpi.UniformRepositorySpec{Type: a.GetKind(), SubPath: p}
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (a *RepositorySpec) Validate(ctx cpi.Context, creds credentials.Credentials, context ...credentials.UsageContext) error {
 	opts := a.StandardOptions
 	opts.Default(vfsattr.Get(ctx))
diff --git a/api/ocm/extensions/repositories/comparch/uniform.go b/api/ocm/extensions/repositories/comparch/uniform.go
index 00a3ca2154..a1d998debd 100644
--- a/api/ocm/extensions/repositories/comparch/uniform.go
+++ b/api/ocm/extensions/repositories/comparch/uniform.go
@@ -7,6 +7,7 @@ import (
 	"ocm.software/ocm/api/utils/accessobj"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 const AltType = "ca"
 
 func init() {
@@ -25,6 +26,7 @@ func explicit(t string) bool {
 	return t == Type || t == AltType
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (h *repospechandler) MapReference(ctx cpi.Context, u *cpi.UniformRepositorySpec) (cpi.RepositorySpec, error) {
 	path := u.Info
 	if u.Info == "" {
diff --git a/cmds/ocm/app/app.go b/cmds/ocm/app/app.go
index d0266a7f4d..fed42c1677 100644
--- a/cmds/ocm/app/app.go
+++ b/cmds/ocm/app/app.go
@@ -86,7 +86,7 @@ type CLIOptions struct {
 
 var desc = `
 The Open Component Model command line client supports the work with OCM
-artifacts, like Component Archives, Common Transport Archive,
+artifacts, like Common Transport Archive,
 Component Repositories, and Component Versions.
 
 Additionally it provides some limited support for the docker daemon, OCI artifacts and
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index a053aa71e3..e80ebfd44a 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -10,8 +10,10 @@ import (
 	"ocm.software/ocm/cmds/ocm/common/utils"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var Names = names.ComponentArchive
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewCommand creates a new command.
 func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd := utils.MassageCommand(&cobra.Command{
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
index a999bc6852..467e0f3982 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
@@ -25,11 +25,13 @@ import (
 	"ocm.software/ocm/cmds/ocm/common/utils"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var (
 	Names = names.ComponentArchive
 	Verb  = verbs.Create
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type Command struct {
 	utils.BaseCommand
 
@@ -46,16 +48,18 @@ type Command struct {
 	Labels         metav1.Labels
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewCommand creates a new ctf command.
 func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 	return utils.SetupCommand(&Command{BaseCommand: utils.NewBaseCommand(ctx, formatoption.New(comparch.GetFormats()...), fileoption.NewCompArch(), schemaoption.New(compdesc.DefaultSchemeVersion))}, utils.Names(Names, names...)...)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) ForName(name string) *cobra.Command {
 	return &cobra.Command{
 		Use:   "[<options>] <component> <version> --provider <provider-name> {--provider <label>=<value>} {<label>=<value>}",
 		Args:  cobra.MinimumNArgs(2),
-		Short: "create new component archive",
+		Short: "(DEPRECATED) create new component archive",
 		Example: `
 $ ocm create componentarchive --file myfirst --provider acme.org --provider email=alice@acme.org acme.org/demo 1.0
 `,
@@ -69,12 +73,14 @@ A provider must be specified, additional provider labels are optional.
 	}
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) AddFlags(fs *pflag.FlagSet) {
 	o.BaseCommand.AddFlags(fs)
 	fs.BoolVarP(&o.Force, "force", "f", false, "remove existing content")
 	fs.StringArrayVarP(&o.providerattrs, "provider", "p", nil, "provider attribute")
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) Complete(args []string) error {
 	var err error
 
@@ -112,6 +118,7 @@ func (o *Command) Complete(args []string) error {
 	return nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) Run() error {
 	mode := formatoption.From(o).Mode()
 	fs := o.Context.FileSystem()
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
index a2944b349d..a50bed446e 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
@@ -24,17 +24,20 @@ import (
 	"ocm.software/ocm/cmds/ocm/common/utils"
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var (
 	Names = names.ComponentArchive
 	Verb  = verbs.Transfer
 )
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 type Command struct {
 	utils.BaseCommand
 	Path       string
 	TargetName string
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewCommand creates a new transfer command.
 func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 	return utils.SetupCommand(
@@ -48,11 +51,12 @@ func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 		)}, utils.Names(Names, names...)...)
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) ForName(name string) *cobra.Command {
 	return &cobra.Command{
 		Use:   "[<options>]  <source> <target>",
 		Args:  cobra.MinimumNArgs(2),
-		Short: "transfer component archive to some component repository",
+		Short: "(DEPRECATED) transfer component archive to some component repository",
 		Long: `
 Transfer a component archive to some component repository. This might
 be a CTF Archive or a regular repository.
@@ -65,6 +69,7 @@ either via inline argument or command configuration file and name.
 	}
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) Complete(args []string) error {
 	o.Path = args[0]
 	o.TargetName = args[1]
@@ -72,6 +77,7 @@ func (o *Command) Complete(args []string) error {
 	return nil
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) Run() error {
 	session := ocm.NewSession(nil)
 	defer session.Close()
diff --git a/cmds/ocm/commands/ocmcmds/names/names.go b/cmds/ocm/commands/ocmcmds/names/names.go
index 652c1c46cf..fe9c422f1e 100644
--- a/cmds/ocm/commands/ocmcmds/names/names.go
+++ b/cmds/ocm/commands/ocmcmds/names/names.go
@@ -1,6 +1,7 @@
 package names
 
 var (
+	// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	ComponentArchive       = []string{"componentarchive", "comparch", "ca"}
 	CommonTransportArchive = []string{"commontransportarchive", "ctf"}
 	Components             = []string{"componentversions", "componentversion", "cv", "components", "component", "comps", "comp", "c"}
diff --git a/examples/make/Makefile b/examples/make/Makefile
index 24b19f9687..8648889937 100644
--- a/examples/make/Makefile
+++ b/examples/make/Makefile
@@ -9,7 +9,8 @@ EFFECTIVE_VERSION                              = $(VERSION)+$(COMMIT)
 .PHONY: ctf
 ctf: ca ## Create CTF from component archive
 	ocm transfer ca gen/ca gen/ctf
-	
+
+# Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 .PHONY: ca
 ca: gen releasenotes ## Create component archive
 	ocm create ca -f $(COMPONENT) "$(VERSION)" mandelsoft gen/ca
@@ -57,7 +58,7 @@ content/RELEASENOTES.md: VERSION
 	echo '- **Release '"`cat VERSION`"'**\n' > content/RELEASENOTES.md
 	cat /tmp/RELEASENOTES.md >>content/RELEASENOTES.md
 
-.PHONY: push 
+.PHONY: push
 push: ctf ## Push local CTF file into a OCI repository
 	ocm transfer ctf -f gen/ctf $(OCI_REPO)
 
@@ -72,7 +73,7 @@ commit: releasenotes ## Commit changes
 
 .PHONY: release
 release: commit push ## Release component
-	
+
 .PHONY: info
 info: ## Display information about the component
 	@echo "VERSION:  $(VERSION)"

From 9fa9aff37b33e5a4cfba3d62af8175944afea99e Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Mon, 13 Jan 2025 09:15:49 +0100
Subject: [PATCH 02/15] test //nolint:staticcheck

---
 cmds/ocm/commands/ocmcmds/componentarchive/cmd.go          | 2 ++
 cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go   | 2 ++
 cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index e80ebfd44a..59a970994e 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -1,5 +1,7 @@
 package componentarchive
 
+//nolint:staticcheck
+
 import (
 	"github.com/spf13/cobra"
 
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
index 467e0f3982..9a5c692e9e 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
@@ -1,5 +1,7 @@
 package create
 
+//nolint:staticcheck
+
 import (
 	"fmt"
 	"strings"
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
index a50bed446e..1c7e86b610 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
@@ -1,5 +1,7 @@
 package transfer
 
+//nolint:staticcheck
+
 import (
 	"github.com/spf13/cobra"
 

From b906d64a3db834ab626ddede28c25d83389bab20 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Mon, 13 Jan 2025 09:29:48 +0100
Subject: [PATCH 03/15] make generate

---
 docs/reference/ocm.md                           | 2 +-
 docs/reference/ocm_create.md                    | 2 +-
 docs/reference/ocm_create_componentarchive.md   | 2 +-
 docs/reference/ocm_transfer.md                  | 2 +-
 docs/reference/ocm_transfer_componentarchive.md | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/reference/ocm.md b/docs/reference/ocm.md
index 3dd9541eb2..3e49ba7bbf 100644
--- a/docs/reference/ocm.md
+++ b/docs/reference/ocm.md
@@ -30,7 +30,7 @@ ocm [<options>] <sub command> ...
 ### Description
 
 The Open Component Model command line client supports the work with OCM
-artifacts, like Component Archives, Common Transport Archive,
+artifacts, like Common Transport Archive,
 Component Repositories, and Component Versions.
 
 Additionally it provides some limited support for the docker daemon, OCI artifacts and
diff --git a/docs/reference/ocm_create.md b/docs/reference/ocm_create.md
index 0b326e8292..eb4db9987a 100644
--- a/docs/reference/ocm_create.md
+++ b/docs/reference/ocm_create.md
@@ -21,7 +21,7 @@ ocm create [<options>] <sub command> ...
 
 ##### Sub Commands
 
-* [ocm create <b>componentarchive</b>](ocm_create_componentarchive.md)	 &mdash; create new component archive
+* [ocm create <b>componentarchive</b>](ocm_create_componentarchive.md)	 &mdash; (DEPRECATED) create new component archive
 * [ocm create <b>rsakeypair</b>](ocm_create_rsakeypair.md)	 &mdash; create RSA public key pair
 * [ocm create <b>transportarchive</b>](ocm_create_transportarchive.md)	 &mdash; create new OCI/OCM transport  archive
 
diff --git a/docs/reference/ocm_create_componentarchive.md b/docs/reference/ocm_create_componentarchive.md
index 990442f73e..f95d8403dc 100644
--- a/docs/reference/ocm_create_componentarchive.md
+++ b/docs/reference/ocm_create_componentarchive.md
@@ -1,4 +1,4 @@
-## ocm create componentarchive &mdash; Create New Component Archive
+## ocm create componentarchive &mdash; (DEPRECATED) Create New Component Archive
 
 ### Synopsis
 
diff --git a/docs/reference/ocm_transfer.md b/docs/reference/ocm_transfer.md
index 0771fba001..9a9cad036f 100644
--- a/docs/reference/ocm_transfer.md
+++ b/docs/reference/ocm_transfer.md
@@ -23,6 +23,6 @@ ocm transfer [<options>] <sub command> ...
 
 * [ocm transfer <b>artifacts</b>](ocm_transfer_artifacts.md)	 &mdash; transfer OCI artifacts
 * [ocm transfer <b>commontransportarchive</b>](ocm_transfer_commontransportarchive.md)	 &mdash; transfer transport archive
-* [ocm transfer <b>componentarchive</b>](ocm_transfer_componentarchive.md)	 &mdash; transfer component archive to some component repository
+* [ocm transfer <b>componentarchive</b>](ocm_transfer_componentarchive.md)	 &mdash; (DEPRECATED) transfer component archive to some component repository
 * [ocm transfer <b>componentversions</b>](ocm_transfer_componentversions.md)	 &mdash; transfer component version
 
diff --git a/docs/reference/ocm_transfer_componentarchive.md b/docs/reference/ocm_transfer_componentarchive.md
index af7b4a058f..a4fe9e4e8f 100644
--- a/docs/reference/ocm_transfer_componentarchive.md
+++ b/docs/reference/ocm_transfer_componentarchive.md
@@ -1,4 +1,4 @@
-## ocm transfer componentarchive &mdash; Transfer Component Archive To Some Component Repository
+## ocm transfer componentarchive &mdash; (DEPRECATED) Transfer Component Archive To Some Component Repository
 
 ### Synopsis
 

From 15ea613d8b20ba31025723ed779d3a1bac1a9426 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Mon, 13 Jan 2025 09:49:28 +0100
Subject: [PATCH 04/15] //nolint:staticcheck

---
 cmds/ocm/commands/ocmcmds/componentarchive/cmd.go          | 3 +--
 cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go   | 4 ++--
 cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go | 3 +--
 3 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index 59a970994e..5de10ac95f 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -1,7 +1,5 @@
 package componentarchive
 
-//nolint:staticcheck
-
 import (
 	"github.com/spf13/cobra"
 
@@ -13,6 +11,7 @@ import (
 )
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
+//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var Names = names.ComponentArchive
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
index 9a5c692e9e..47b093c240 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
@@ -1,7 +1,5 @@
 package create
 
-//nolint:staticcheck
-
 import (
 	"fmt"
 	"strings"
@@ -29,6 +27,7 @@ import (
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var (
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	Names = names.ComponentArchive
 	Verb  = verbs.Create
 )
@@ -39,6 +38,7 @@ type Command struct {
 
 	providerattrs []string
 
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	Handler comparch.FormatHandler
 	Force   bool
 	Format  string
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
index 1c7e86b610..1e9d88da90 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
@@ -1,7 +1,5 @@
 package transfer
 
-//nolint:staticcheck
-
 import (
 	"github.com/spf13/cobra"
 
@@ -28,6 +26,7 @@ import (
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var (
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	Names = names.ComponentArchive
 	Verb  = verbs.Transfer
 )

From a11aca8ac6e1e0cb1d241685a9366f912f34cffd Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Mon, 13 Jan 2025 10:02:39 +0100
Subject: [PATCH 05/15] //nolint:staticcheck

---
 cmds/ocm/app/app.go                     | 1 +
 cmds/ocm/commands/ocmcmds/cmd.go        | 1 +
 cmds/ocm/commands/verbs/create/cmd.go   | 1 +
 cmds/ocm/commands/verbs/transfer/cmd.go | 1 +
 4 files changed, 4 insertions(+)

diff --git a/cmds/ocm/app/app.go b/cmds/ocm/app/app.go
index fed42c1677..ca479189f5 100644
--- a/cmds/ocm/app/app.go
+++ b/cmds/ocm/app/app.go
@@ -243,6 +243,7 @@ func newCliCommand(opts *CLIOptions, mod ...func(clictx.Context, *cobra.Command)
 	cmd.AddCommand(execute.NewCommand(opts.Context))
 	cmd.AddCommand(controller.NewCommand(opts.Context))
 
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	cmd.AddCommand(cmdutils.HideCommand(componentarchive.NewCommand(opts.Context)))
 	cmd.AddCommand(cmdutils.HideCommand(resources.NewCommand(opts.Context)))
 	cmd.AddCommand(cmdutils.HideCommand(references.NewCommand(opts.Context)))
diff --git a/cmds/ocm/commands/ocmcmds/cmd.go b/cmds/ocm/commands/ocmcmds/cmd.go
index a35b28540b..534a4bb942 100644
--- a/cmds/ocm/commands/ocmcmds/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/cmd.go
@@ -36,6 +36,7 @@ func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd.AddCommand(references.NewCommand(ctx))
 	cmd.AddCommand(components.NewCommand(ctx))
 	cmd.AddCommand(ctf.NewCommand(ctx))
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	cmd.AddCommand(componentarchive.NewCommand(ctx))
 	cmd.AddCommand(versions.NewCommand(ctx))
 	cmd.AddCommand(plugins.NewCommand(ctx))
diff --git a/cmds/ocm/commands/verbs/create/cmd.go b/cmds/ocm/commands/verbs/create/cmd.go
index b48be99304..67dbe8f6e2 100644
--- a/cmds/ocm/commands/verbs/create/cmd.go
+++ b/cmds/ocm/commands/verbs/create/cmd.go
@@ -16,6 +16,7 @@ func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd := utils.MassageCommand(&cobra.Command{
 		Short: "Create transport or component archive",
 	}, verbs.Create)
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	cmd.AddCommand(comparch.NewCommand(ctx))
 	cmd.AddCommand(ctf.NewCommand(ctx))
 	cmd.AddCommand(rsakeypair.NewCommand(ctx))
diff --git a/cmds/ocm/commands/verbs/transfer/cmd.go b/cmds/ocm/commands/verbs/transfer/cmd.go
index 9124c789ee..59ab1b590f 100644
--- a/cmds/ocm/commands/verbs/transfer/cmd.go
+++ b/cmds/ocm/commands/verbs/transfer/cmd.go
@@ -17,6 +17,7 @@ func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd := utils.MassageCommand(&cobra.Command{
 		Short: "Transfer artifacts or components",
 	}, verbs.Transfer)
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	cmd.AddCommand(comparch.NewCommand(ctx))
 	cmd.AddCommand(artifacts.NewCommand(ctx))
 	cmd.AddCommand(components.NewCommand(ctx))

From 6e9c3c31439f9c48dbbe9fe1383b822ea4f10cda Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Tue, 14 Jan 2025 14:53:26 +0100
Subject: [PATCH 06/15] make format

---
 cmds/ocm/commands/ocmcmds/componentarchive/cmd.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index 5de10ac95f..5ec76b916b 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -11,6 +11,7 @@ import (
 )
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
+//
 //nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 var Names = names.ComponentArchive
 

From 6fd914d1055a89df175adc8e8019d9ed88dc5d1a Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Tue, 14 Jan 2025 15:57:44 +0100
Subject: [PATCH 07/15] filter 'ComponentArchive' from Dedicated OCM repository
 types

when the resulting list becomes empty, just completely skip the
"Dedicated OCM repository types"
---
 .../ocmcmds/common/options/repooption/option.go  | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/cmds/ocm/commands/ocmcmds/common/options/repooption/option.go b/cmds/ocm/commands/ocmcmds/common/options/repooption/option.go
index 51134b6c73..24ac1f2cf2 100644
--- a/cmds/ocm/commands/ocmcmds/common/options/repooption/option.go
+++ b/cmds/ocm/commands/ocmcmds/common/options/repooption/option.go
@@ -6,6 +6,7 @@ import (
 	clictx "ocm.software/ocm/api/cli"
 	"ocm.software/ocm/api/oci"
 	"ocm.software/ocm/api/ocm"
+	"ocm.software/ocm/api/ocm/extensions/repositories/comparch"
 	"ocm.software/ocm/api/ocm/extensions/repositories/genericocireg"
 	"ocm.software/ocm/api/utils/listformat"
 	"ocm.software/ocm/api/utils/runtime"
@@ -62,7 +63,7 @@ relative to the specified repository using the syntax
     <pre>&lt;component>[:&lt;version>]</pre>
 </center>
 
-If no <code>--repo</code> option is specified the given names are interpreted 
+If no <code>--repo</code> option is specified the given names are interpreted
 as located OCM component version references:
 
 <center>
@@ -85,16 +86,23 @@ The <code>--repo</code> option takes an OCM repository specification:
 For the *Common Transport Format* the types <code>directory</code>,
 <code>tar</code> or <code>tgz</code> is possible.
 
-Using the JSON variant any repository types supported by the 
+Using the JSON variant any repository types supported by the
 linked library can be used:
+`
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
+	knownTypes := runtime.KindToVersionList(ocm.DefaultContext().RepositoryTypes().KnownTypeNames(), comparch.Type)
+	if len(knownTypes) > 0 {
+		s += `
 
 Dedicated OCM repository types:
-`
 
-	s += listformat.FormatMapElements("", runtime.KindToVersionList(ocm.DefaultContext().RepositoryTypes().KnownTypeNames()))
+`
+		s += listformat.FormatMapElements("", knownTypes)
+	}
 
 	s += `
 OCI Repository types (using standard component repository to OCI mapping):
+
 `
 	s += listformat.FormatMapElements("", runtime.KindToVersionList(oci.DefaultContext().RepositoryTypes().KnownTypeNames(), genericocireg.Excludes...))
 	return s

From 28e51bb7645cebf4ee55d08615700df18402cea5 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Tue, 14 Jan 2025 15:58:59 +0100
Subject: [PATCH 08/15] set cobra.Command.Deprecated: "Deprecated - use ...

ocm.CommonTransportFormat instead
---
 cmds/ocm/commands/ocmcmds/componentarchive/cmd.go      |  4 +++-
 .../commands/ocmcmds/componentarchive/create/cmd.go    | 10 +++++++++-
 .../commands/ocmcmds/componentarchive/transfer/cmd.go  |  4 +++-
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index 5ec76b916b..0a5c8b82ca 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -4,6 +4,7 @@ import (
 	"github.com/spf13/cobra"
 
 	clictx "ocm.software/ocm/api/cli"
+	"ocm.software/ocm/api/ocm"
 	"ocm.software/ocm/cmds/ocm/commands/ocmcmds/componentarchive/create"
 	"ocm.software/ocm/cmds/ocm/commands/ocmcmds/componentarchive/transfer"
 	"ocm.software/ocm/cmds/ocm/commands/ocmcmds/names"
@@ -19,7 +20,8 @@ var Names = names.ComponentArchive
 // NewCommand creates a new command.
 func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd := utils.MassageCommand(&cobra.Command{
-		Short: "Commands acting on component archives",
+		Short:      "Commands acting on component archives",
+		Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 	}, Names...)
 	cmd.AddCommand(transfer.NewCommand(ctx, transfer.Verb))
 	cmd.AddCommand(create.NewCommand(ctx, create.Verb))
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
index 47b093c240..415bea4317 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
@@ -10,6 +10,7 @@ import (
 	"github.com/spf13/pflag"
 
 	clictx "ocm.software/ocm/api/cli"
+	"ocm.software/ocm/api/ocm"
 	"ocm.software/ocm/api/ocm/compdesc"
 	metav1 "ocm.software/ocm/api/ocm/compdesc/meta/v1"
 	"ocm.software/ocm/api/ocm/extensions/attrs/compatattr"
@@ -53,7 +54,14 @@ type Command struct {
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewCommand creates a new ctf command.
 func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
-	return utils.SetupCommand(&Command{BaseCommand: utils.NewBaseCommand(ctx, formatoption.New(comparch.GetFormats()...), fileoption.NewCompArch(), schemaoption.New(compdesc.DefaultSchemeVersion))}, utils.Names(Names, names...)...)
+	c := utils.SetupCommand(
+		&Command{BaseCommand: utils.NewBaseCommand(ctx,
+			formatoption.New(comparch.GetFormats()...),
+			fileoption.NewCompArch(),
+			schemaoption.New(compdesc.DefaultSchemeVersion))},
+		utils.Names(Names, names...)...)
+	c.Deprecated = "Deprecated - use " + ocm.CommonTransportFormat + " instead"
+	return c
 }
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
index 1e9d88da90..68aa89e59a 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
@@ -41,7 +41,7 @@ type Command struct {
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewCommand creates a new transfer command.
 func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
-	return utils.SetupCommand(
+	c := utils.SetupCommand(
 		&Command{BaseCommand: utils.NewBaseCommand(ctx,
 			formatoption.New(),
 			lookupoption.New(),
@@ -50,6 +50,8 @@ func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 			rscbyvalueoption.New(),
 			srcbyvalueoption.New(),
 		)}, utils.Names(Names, names...)...)
+	c.Deprecated = "Deprecated - use " + ocm.CommonTransportFormat + " instead"
+	return c
 }
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489

From 311d1105a2c20854c9f8b963f3edc70686a91893 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Tue, 14 Jan 2025 16:00:14 +0100
Subject: [PATCH 09/15] skip if IsDeprecated(child)

---
 docs/reference/ocm_add_routingslips.md        |  4 +-
 docs/reference/ocm_bootstrap_configuration.md |  4 +-
 docs/reference/ocm_bootstrap_package.md       |  4 +-
 docs/reference/ocm_check_componentversions.md |  4 +-
 docs/reference/ocm_create.md                  |  1 -
 docs/reference/ocm_create_componentarchive.md | 62 ------------
 docs/reference/ocm_describe_package.md        |  4 +-
 docs/reference/ocm_download_cli.md            |  4 +-
 .../ocm_download_componentversions.md         |  4 +-
 docs/reference/ocm_download_resources.md      |  4 +-
 docs/reference/ocm_get_componentversions.md   |  4 +-
 docs/reference/ocm_get_references.md          |  4 +-
 docs/reference/ocm_get_resources.md           |  4 +-
 docs/reference/ocm_get_routingslips.md        |  4 +-
 docs/reference/ocm_get_sources.md             |  4 +-
 docs/reference/ocm_hash_componentversions.md  |  4 +-
 docs/reference/ocm_install_plugins.md         |  4 +-
 docs/reference/ocm_list_componentversions.md  |  4 +-
 docs/reference/ocm_ocm.md                     |  1 -
 docs/reference/ocm_show_versions.md           |  4 +-
 docs/reference/ocm_sign_componentversions.md  |  4 +-
 docs/reference/ocm_transfer.md                |  1 -
 .../ocm_transfer_componentarchive.md          | 96 -------------------
 .../ocm_transfer_componentversions.md         |  4 +-
 .../reference/ocm_verify_componentversions.md |  4 +-
 hack/generate-docs/cobradoc/md_docs.go        |  6 +-
 26 files changed, 25 insertions(+), 222 deletions(-)
 delete mode 100644 docs/reference/ocm_create_componentarchive.md
 delete mode 100644 docs/reference/ocm_transfer_componentarchive.md

diff --git a/docs/reference/ocm_add_routingslips.md b/docs/reference/ocm_add_routingslips.md
index 4bebc50df7..968d9ad83f 100644
--- a/docs/reference/ocm_add_routingslips.md
+++ b/docs/reference/ocm_add_routingslips.md
@@ -94,10 +94,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_bootstrap_configuration.md b/docs/reference/ocm_bootstrap_configuration.md
index 92396ca672..c74726be34 100644
--- a/docs/reference/ocm_bootstrap_configuration.md
+++ b/docs/reference/ocm_bootstrap_configuration.md
@@ -75,10 +75,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_bootstrap_package.md b/docs/reference/ocm_bootstrap_package.md
index 19e343b811..a752fdca38 100644
--- a/docs/reference/ocm_bootstrap_package.md
+++ b/docs/reference/ocm_bootstrap_package.md
@@ -156,10 +156,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_check_componentversions.md b/docs/reference/ocm_check_componentversions.md
index 23f9849220..9689f20306 100644
--- a/docs/reference/ocm_check_componentversions.md
+++ b/docs/reference/ocm_check_componentversions.md
@@ -63,10 +63,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_create.md b/docs/reference/ocm_create.md
index eb4db9987a..70c319cbee 100644
--- a/docs/reference/ocm_create.md
+++ b/docs/reference/ocm_create.md
@@ -21,7 +21,6 @@ ocm create [<options>] <sub command> ...
 
 ##### Sub Commands
 
-* [ocm create <b>componentarchive</b>](ocm_create_componentarchive.md)	 &mdash; (DEPRECATED) create new component archive
 * [ocm create <b>rsakeypair</b>](ocm_create_rsakeypair.md)	 &mdash; create RSA public key pair
 * [ocm create <b>transportarchive</b>](ocm_create_transportarchive.md)	 &mdash; create new OCI/OCM transport  archive
 
diff --git a/docs/reference/ocm_create_componentarchive.md b/docs/reference/ocm_create_componentarchive.md
deleted file mode 100644
index f95d8403dc..0000000000
--- a/docs/reference/ocm_create_componentarchive.md
+++ /dev/null
@@ -1,62 +0,0 @@
-## ocm create componentarchive &mdash; (DEPRECATED) Create New Component Archive
-
-### Synopsis
-
-```bash
-ocm create componentarchive [<options>] <component> <version> --provider <provider-name> {--provider <label>=<value>} {<label>=<value>}
-```
-
-#### Aliases
-
-```text
-componentarchive, comparch, ca
-```
-
-### Options
-
-```text
-  -F, --file string            target file/directory (default "component-archive")
-  -f, --force                  remove existing content
-  -h, --help                   help for componentarchive
-  -p, --provider stringArray   provider attribute
-  -S, --scheme string          schema version (default "v2")
-  -t, --type string            archive format (directory, tar, tgz) (default "directory")
-```
-
-### Description
-
-Create a new component archive. This might be either a directory prepared
-to host component version content or a tar/tgz file (see option --type).
-
-A provider must be specified, additional provider labels are optional.
-
-
-The <code>--type</code> option accepts a file format for the
-target archive to use. It is only evaluated if the target
-archive does not exist yet. The following formats are supported:
-- directory
-- tar
-- tgz
-
-The default format is <code>directory</code>.
-
-
-If the option <code>--scheme</code> is given, the specified component descriptor format is used/generated.
-
-The following schema versions are supported for explicit conversions:
-  - <code>ocm.software/v3alpha1</code>
-  - <code>v2</code> (default)
-
-### Examples
-
-```bash
-$ ocm create componentarchive --file myfirst --provider acme.org --provider email=alice@acme.org acme.org/demo 1.0
-```
-
-### SEE ALSO
-
-#### Parents
-
-* [ocm create](ocm_create.md)	 &mdash; Create transport or component archive
-* [ocm](ocm.md)	 &mdash; Open Component Model command line client
-
diff --git a/docs/reference/ocm_describe_package.md b/docs/reference/ocm_describe_package.md
index def83647ae..b22262610d 100644
--- a/docs/reference/ocm_describe_package.md
+++ b/docs/reference/ocm_describe_package.md
@@ -66,10 +66,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_download_cli.md b/docs/reference/ocm_download_cli.md
index ff71ec89dd..34fdab53db 100644
--- a/docs/reference/ocm_download_cli.md
+++ b/docs/reference/ocm_download_cli.md
@@ -76,10 +76,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_download_componentversions.md b/docs/reference/ocm_download_componentversions.md
index 79dbd5c69e..359df96a98 100644
--- a/docs/reference/ocm_download_componentversions.md
+++ b/docs/reference/ocm_download_componentversions.md
@@ -62,10 +62,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_download_resources.md b/docs/reference/ocm_download_resources.md
index fd14528178..09e3012282 100644
--- a/docs/reference/ocm_download_resources.md
+++ b/docs/reference/ocm_download_resources.md
@@ -101,10 +101,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_get_componentversions.md b/docs/reference/ocm_get_componentversions.md
index ceebb7e970..58b5e14b5a 100644
--- a/docs/reference/ocm_get_componentversions.md
+++ b/docs/reference/ocm_get_componentversions.md
@@ -72,10 +72,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_get_references.md b/docs/reference/ocm_get_references.md
index 684f1b4787..c518a857b0 100644
--- a/docs/reference/ocm_get_references.md
+++ b/docs/reference/ocm_get_references.md
@@ -73,10 +73,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_get_resources.md b/docs/reference/ocm_get_resources.md
index 9790deeb88..c7ef77e761 100644
--- a/docs/reference/ocm_get_resources.md
+++ b/docs/reference/ocm_get_resources.md
@@ -73,10 +73,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_get_routingslips.md b/docs/reference/ocm_get_routingslips.md
index a5402ac441..576b1dab42 100644
--- a/docs/reference/ocm_get_routingslips.md
+++ b/docs/reference/ocm_get_routingslips.md
@@ -72,10 +72,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_get_sources.md b/docs/reference/ocm_get_sources.md
index fc32e41373..339692caea 100644
--- a/docs/reference/ocm_get_sources.md
+++ b/docs/reference/ocm_get_sources.md
@@ -73,10 +73,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_hash_componentversions.md b/docs/reference/ocm_hash_componentversions.md
index 4c5e46bdca..1a38a166a9 100644
--- a/docs/reference/ocm_hash_componentversions.md
+++ b/docs/reference/ocm_hash_componentversions.md
@@ -116,10 +116,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_install_plugins.md b/docs/reference/ocm_install_plugins.md
index 9c20720c97..02b045c7be 100644
--- a/docs/reference/ocm_install_plugins.md
+++ b/docs/reference/ocm_install_plugins.md
@@ -65,10 +65,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_list_componentversions.md b/docs/reference/ocm_list_componentversions.md
index 630d009e9b..95ddc71d05 100644
--- a/docs/reference/ocm_list_componentversions.md
+++ b/docs/reference/ocm_list_componentversions.md
@@ -71,10 +71,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_ocm.md b/docs/reference/ocm_ocm.md
index 2c1f092df8..ff385ece4f 100644
--- a/docs/reference/ocm_ocm.md
+++ b/docs/reference/ocm_ocm.md
@@ -22,7 +22,6 @@ ocm ocm [<options>] <sub command> ...
 ##### Sub Commands
 
 * ocm ocm <b>commontransportarchive</b>	 &mdash; Commands acting on common transport archives
-* ocm ocm <b>componentarchive</b>	 &mdash; Commands acting on component archives
 * ocm ocm <b>componentversions</b>	 &mdash; Commands acting on components
 * ocm ocm <b>plugins</b>	 &mdash; Commands related to OCM plugins
 * ocm ocm <b>pubsub</b>	 &mdash; Commands acting on sub/sub specifications
diff --git a/docs/reference/ocm_show_versions.md b/docs/reference/ocm_show_versions.md
index 075203cf3c..831d24c717 100644
--- a/docs/reference/ocm_show_versions.md
+++ b/docs/reference/ocm_show_versions.md
@@ -59,10 +59,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_sign_componentversions.md b/docs/reference/ocm_sign_componentversions.md
index fa9a0d7d17..c3ecf6f017 100644
--- a/docs/reference/ocm_sign_componentversions.md
+++ b/docs/reference/ocm_sign_componentversions.md
@@ -83,10 +83,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_transfer.md b/docs/reference/ocm_transfer.md
index 9a9cad036f..7285b0b873 100644
--- a/docs/reference/ocm_transfer.md
+++ b/docs/reference/ocm_transfer.md
@@ -23,6 +23,5 @@ ocm transfer [<options>] <sub command> ...
 
 * [ocm transfer <b>artifacts</b>](ocm_transfer_artifacts.md)	 &mdash; transfer OCI artifacts
 * [ocm transfer <b>commontransportarchive</b>](ocm_transfer_commontransportarchive.md)	 &mdash; transfer transport archive
-* [ocm transfer <b>componentarchive</b>](ocm_transfer_componentarchive.md)	 &mdash; (DEPRECATED) transfer component archive to some component repository
 * [ocm transfer <b>componentversions</b>](ocm_transfer_componentversions.md)	 &mdash; transfer component version
 
diff --git a/docs/reference/ocm_transfer_componentarchive.md b/docs/reference/ocm_transfer_componentarchive.md
deleted file mode 100644
index a4fe9e4e8f..0000000000
--- a/docs/reference/ocm_transfer_componentarchive.md
+++ /dev/null
@@ -1,96 +0,0 @@
-## ocm transfer componentarchive &mdash; (DEPRECATED) Transfer Component Archive To Some Component Repository
-
-### Synopsis
-
-```bash
-ocm transfer componentarchive [<options>]  <source> <target>
-```
-
-#### Aliases
-
-```text
-componentarchive, comparch, ca
-```
-
-### Options
-
-```text
-  -L, --copy-local-resources   transfer referenced local resources by-value
-  -V, --copy-resources         transfer referenced resources by-value
-      --copy-sources           transfer referenced sources by-value
-      --enforce                enforce transport as if target version were not present
-  -h, --help                   help for componentarchive
-      --lookup stringArray     repository name or spec for closure lookup fallback
-      --no-update              don't touch existing versions in target
-  -f, --overwrite              overwrite existing component versions
-  -t, --type string            archive format (directory, tar, tgz) (default "directory")
-```
-
-### Description
-
-Transfer a component archive to some component repository. This might
-be a CTF Archive or a regular repository.
-If the type CTF is specified the target must already exist, if CTF flavor
-is specified it will be created if it does not exist.
-
-Besides those explicitly known types a complete repository spec might be configured,
-either via inline argument or command configuration file and name.
-
-
-The <code>--type</code> option accepts a file format for the
-target archive to use. It is only evaluated if the target
-archive does not exist yet. The following formats are supported:
-- directory
-- tar
-- tgz
-
-The default format is <code>directory</code>.
-
-\
-If a component lookup for building a reference closure is required
-the <code>--lookup</code>  option can be used to specify a fallback
-lookup repository. By default, the component versions are searched in
-the repository holding the component version for which the closure is
-determined. For *Component Archives* this is never possible, because
-it only contains a single component version. Therefore, in this scenario
-this option must always be specified to be able to follow component
-references.
-
-
-With the option <code>--no-update</code> existing versions in the target
-repository will not be touched at all. An additional specification of the
-option <code>--overwrite</code> is ignored. By default, updates of
-volatile (non-signature-relevant) information is enabled, but the
-modification of non-volatile data is prohibited unless the overwrite
-option is given.
-
-
-If the option <code>--overwrite</code> is given, component versions in the
-target repository will be overwritten, if they already exist, but with different digest.
-If the option <code>--enforce</code> is given, component versions in the
-target repository will be transported as if they were not present on the target side,
-regardless of their state (this is independent on their actual state, even identical
-versions are re-transported).
-
-
-If the option <code>--copy-resources</code> is given, all referential
-resources will potentially be localized, mapped to component version local
-resources in the target repository. If the option <code>--copy-local-resources</code>
-is given, instead, only resources with the relation <code>local</code> will be
-transferred. This behaviour can be further influenced by specifying a transfer
-script with the <code>script</code> option family.
-
-
-If the option <code>--copy-sources</code> is given, all referential
-sources will potentially be localized, mapped to component version local
-resources in the target repository.
-This behaviour can be further influenced by specifying a transfer script
-with the <code>script</code> option family.
-
-### SEE ALSO
-
-#### Parents
-
-* [ocm transfer](ocm_transfer.md)	 &mdash; Transfer artifacts or components
-* [ocm](ocm.md)	 &mdash; Open Component Model command line client
-
diff --git a/docs/reference/ocm_transfer_componentversions.md b/docs/reference/ocm_transfer_componentversions.md
index 1c235f0e82..8a3a9be36d 100644
--- a/docs/reference/ocm_transfer_componentversions.md
+++ b/docs/reference/ocm_transfer_componentversions.md
@@ -84,10 +84,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/docs/reference/ocm_verify_componentversions.md b/docs/reference/ocm_verify_componentversions.md
index dabdd5d270..015de6b495 100644
--- a/docs/reference/ocm_verify_componentversions.md
+++ b/docs/reference/ocm_verify_componentversions.md
@@ -80,10 +80,8 @@ For the *Common Transport Format* the types <code>directory</code>,
 Using the JSON variant any repository types supported by the
 linked library can be used:
 
-Dedicated OCM repository types:
-  - <code>ComponentArchive</code>: v1
-
 OCI Repository types (using standard component repository to OCI mapping):
+
   - <code>CommonTransportFormat</code>: v1
   - <code>OCIRegistry</code>: v1
   - <code>oci</code>: v1
diff --git a/hack/generate-docs/cobradoc/md_docs.go b/hack/generate-docs/cobradoc/md_docs.go
index 0b7ea0a0ad..afb1ad8ae4 100644
--- a/hack/generate-docs/cobradoc/md_docs.go
+++ b/hack/generate-docs/cobradoc/md_docs.go
@@ -139,7 +139,7 @@ func GenMarkdownCustom(cmd *cobra.Command, w io.Writer, linkHandler func(string)
 
 		subheader := false
 		for _, child := range children {
-			if OverviewOnly(child) || !child.IsAvailableCommand() || child.IsAdditionalHelpTopicCommand() {
+			if OverviewOnly(child) || !child.IsAvailableCommand() || child.IsAdditionalHelpTopicCommand() || IsDeprecated(child) {
 				continue
 			}
 			if header && !subheader {
@@ -266,6 +266,10 @@ func DocuCommandPath(cmd *cobra.Command) string {
 	return cmd.CommandPath()
 }
 
+func IsDeprecated(cmd *cobra.Command) bool {
+	return cmd.Deprecated != ""
+}
+
 func ExampleCodeStyle(cmd *cobra.Command) string {
 	if cmd.Annotations != nil {
 		if p, ok := cmd.Annotations["ExampleCodeStyle"]; ok {

From 06c7d8ebad46a1533136fb7f715789bdfd86b831 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Tue, 14 Jan 2025 16:08:01 +0100
Subject: [PATCH 10/15] move Deprecated: "Deprecated - use " +
 ocm.CommonTransportFormat + " instead",

---
 .../ocmcmds/componentarchive/create/cmd.go       | 16 +++++-----------
 .../ocmcmds/componentarchive/transfer/cmd.go     | 11 +++++------
 2 files changed, 10 insertions(+), 17 deletions(-)

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
index 415bea4317..5b49043eaf 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
@@ -54,22 +54,16 @@ type Command struct {
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewCommand creates a new ctf command.
 func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
-	c := utils.SetupCommand(
-		&Command{BaseCommand: utils.NewBaseCommand(ctx,
-			formatoption.New(comparch.GetFormats()...),
-			fileoption.NewCompArch(),
-			schemaoption.New(compdesc.DefaultSchemeVersion))},
-		utils.Names(Names, names...)...)
-	c.Deprecated = "Deprecated - use " + ocm.CommonTransportFormat + " instead"
-	return c
+	return utils.SetupCommand(&Command{BaseCommand: utils.NewBaseCommand(ctx, formatoption.New(comparch.GetFormats()...), fileoption.NewCompArch(), schemaoption.New(compdesc.DefaultSchemeVersion))}, utils.Names(Names, names...)...)
 }
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) ForName(name string) *cobra.Command {
 	return &cobra.Command{
-		Use:   "[<options>] <component> <version> --provider <provider-name> {--provider <label>=<value>} {<label>=<value>}",
-		Args:  cobra.MinimumNArgs(2),
-		Short: "(DEPRECATED) create new component archive",
+		Use:        "[<options>] <component> <version> --provider <provider-name> {--provider <label>=<value>} {<label>=<value>}",
+		Args:       cobra.MinimumNArgs(2),
+		Short:      "(DEPRECATED) create new component archive",
+		Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 		Example: `
 $ ocm create componentarchive --file myfirst --provider acme.org --provider email=alice@acme.org acme.org/demo 1.0
 `,
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
index 68aa89e59a..aa0582c634 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
@@ -41,7 +41,7 @@ type Command struct {
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 // NewCommand creates a new transfer command.
 func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
-	c := utils.SetupCommand(
+	return utils.SetupCommand(
 		&Command{BaseCommand: utils.NewBaseCommand(ctx,
 			formatoption.New(),
 			lookupoption.New(),
@@ -50,16 +50,15 @@ func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 			rscbyvalueoption.New(),
 			srcbyvalueoption.New(),
 		)}, utils.Names(Names, names...)...)
-	c.Deprecated = "Deprecated - use " + ocm.CommonTransportFormat + " instead"
-	return c
 }
 
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) ForName(name string) *cobra.Command {
 	return &cobra.Command{
-		Use:   "[<options>]  <source> <target>",
-		Args:  cobra.MinimumNArgs(2),
-		Short: "(DEPRECATED) transfer component archive to some component repository",
+		Use:        "[<options>]  <source> <target>",
+		Args:       cobra.MinimumNArgs(2),
+		Short:      "(DEPRECATED) transfer component archive to some component repository",
+		Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 		Long: `
 Transfer a component archive to some component repository. This might
 be a CTF Archive or a regular repository.

From 0296603c824b3883e81a3f6d665937f5fbe59caf Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Tue, 14 Jan 2025 16:25:39 +0100
Subject: [PATCH 11/15] FIXME: use CommonTransportFormat archives to store OCM
 components

---
 cmds/ocm/commands/ocmcmds/common/resources.go        | 3 +++
 cmds/ocm/commands/ocmcmds/components/download/cmd.go | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/cmds/ocm/commands/ocmcmds/common/resources.go b/cmds/ocm/commands/ocmcmds/common/resources.go
index 63c1d63c44..9886b15ad6 100644
--- a/cmds/ocm/commands/ocmcmds/common/resources.go
+++ b/cmds/ocm/commands/ocmcmds/common/resources.go
@@ -456,10 +456,13 @@ func (o *ResourceAdderCommand) ProcessResourceDescriptions() error {
 		return addhdlrs.PrintElements(printer, elems, dr.Outfile, o.Context.FileSystem())
 	}
 
+	// FIXME: use CommonTransportFormat archives to store OCM components
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	obj, err := comparch.Open(o.Context.OCMContext(), accessobj.ACC_WRITABLE, o.Archive, 0, accessio.PathFileSystem(fs))
 	if err != nil {
 		return err
 	}
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	defer obj.Close()
 	return ProcessElements(ictx, obj, elems, o.Handler)
 }
diff --git a/cmds/ocm/commands/ocmcmds/components/download/cmd.go b/cmds/ocm/commands/ocmcmds/components/download/cmd.go
index 1254cf7b57..71ac2a8d7f 100644
--- a/cmds/ocm/commands/ocmcmds/components/download/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/components/download/cmd.go
@@ -134,10 +134,13 @@ func (d *action) Save(o *comphdlr.Object, f string) (err error) {
 	}
 
 	format := formatoption.From(d.cmd)
+	// FIXME: use CommonTransportFormat archives to store OCM components
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	set, err := comparch.Create(d.cmd.OCMContext(), accessobj.ACC_CREATE, f, format.Mode(), format.Format, accessio.PathFileSystem(dest.PathFilesystem))
 	if err != nil {
 		return err
 	}
+	//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 	defer errors.PropagateError(&err, set.Close)
 
 	nv := common.VersionedElementKey(src)

From 461598132d7eadac2467afe93c8ba8fde67f0b4f Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Fri, 17 Jan 2025 14:47:11 +0100
Subject: [PATCH 12/15] Deprecated: fileoption.NewCompArch()

---
 cmds/ocm/commands/ocmcmds/common/options/fileoption/option.go | 1 +
 cmds/ocm/commands/ocmcmds/common/resources.go                 | 3 ++-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/cmds/ocm/commands/ocmcmds/common/options/fileoption/option.go b/cmds/ocm/commands/ocmcmds/common/options/fileoption/option.go
index 69a0894747..7fb0e4910b 100644
--- a/cmds/ocm/commands/ocmcmds/common/options/fileoption/option.go
+++ b/cmds/ocm/commands/ocmcmds/common/options/fileoption/option.go
@@ -19,6 +19,7 @@ func From(o options.OptionSetProvider) *Option {
 	return opt
 }
 
+// Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func NewCompArch() *Option {
 	return New("component-archive")
 }
diff --git a/cmds/ocm/commands/ocmcmds/common/resources.go b/cmds/ocm/commands/ocmcmds/common/resources.go
index 9886b15ad6..3ef2840856 100644
--- a/cmds/ocm/commands/ocmcmds/common/resources.go
+++ b/cmds/ocm/commands/ocmcmds/common/resources.go
@@ -192,7 +192,7 @@ it is possible to add extra identity attributes. Explicitly specified options
 override values specified by the <code>--%s</code> option.
 (Note: Go templates are not supported for YAML-based option values. Besides
 this restriction, the finally composed element description is still processed
-by the selected template engine.) 
+by the selected template engine.)
 `, a.typename, a.typename, a.typename)
 }
 
@@ -388,6 +388,7 @@ func NewResourceAdderCommand(ctx clictx.Context, h ResourceSpecHandler, provider
 	}
 	return ResourceAdderCommand{
 		BaseCommand: utils.NewBaseCommand(ctx, sliceutils.CopyAppend[options.Options](opts,
+			//nolint:staticcheck // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 			fileoption.NewCompArch(),
 			dryrunoption.New(fmt.Sprintf("evaluate and print %s specifications", h.Key()), true),
 			templateroption.New(""),

From 7dba90dbb7ce90f4d53f156cca2d14884ed519c1 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Thu, 23 Jan 2025 11:13:48 +0100
Subject: [PATCH 13/15] team wants to keep the documentation still visible

https://github.com/open-component-model/ocm/issues/1242#issuecomment-2609312927
---
 .../commands/ocmcmds/componentarchive/cmd.go  |  6 +-
 .../ocmcmds/componentarchive/create/cmd.go    | 10 +-
 .../ocmcmds/componentarchive/transfer/cmd.go  |  9 +-
 docs/reference/ocm_create.md                  |  1 +
 docs/reference/ocm_create_componentarchive.md | 62 ++++++++++++
 docs/reference/ocm_ocm.md                     |  1 +
 docs/reference/ocm_transfer.md                |  1 +
 .../ocm_transfer_componentarchive.md          | 96 +++++++++++++++++++
 hack/generate-docs/cobradoc/md_docs.go        |  6 +-
 9 files changed, 175 insertions(+), 17 deletions(-)
 create mode 100644 docs/reference/ocm_create_componentarchive.md
 create mode 100644 docs/reference/ocm_transfer_componentarchive.md

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index 0a5c8b82ca..0dba356f84 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -4,7 +4,6 @@ import (
 	"github.com/spf13/cobra"
 
 	clictx "ocm.software/ocm/api/cli"
-	"ocm.software/ocm/api/ocm"
 	"ocm.software/ocm/cmds/ocm/commands/ocmcmds/componentarchive/create"
 	"ocm.software/ocm/cmds/ocm/commands/ocmcmds/componentarchive/transfer"
 	"ocm.software/ocm/cmds/ocm/commands/ocmcmds/names"
@@ -20,8 +19,9 @@ var Names = names.ComponentArchive
 // NewCommand creates a new command.
 func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd := utils.MassageCommand(&cobra.Command{
-		Short:      "Commands acting on component archives",
-		Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
+		Short: "Commands acting on component archives",
+		// this removes the command from the help output - https://github.com/open-component-model/ocm/issues/1242#issuecomment-2609312927
+		// Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 	}, Names...)
 	cmd.AddCommand(transfer.NewCommand(ctx, transfer.Verb))
 	cmd.AddCommand(create.NewCommand(ctx, create.Verb))
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
index 5b49043eaf..9643e5439c 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/create/cmd.go
@@ -10,7 +10,6 @@ import (
 	"github.com/spf13/pflag"
 
 	clictx "ocm.software/ocm/api/cli"
-	"ocm.software/ocm/api/ocm"
 	"ocm.software/ocm/api/ocm/compdesc"
 	metav1 "ocm.software/ocm/api/ocm/compdesc/meta/v1"
 	"ocm.software/ocm/api/ocm/extensions/attrs/compatattr"
@@ -60,10 +59,11 @@ func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) ForName(name string) *cobra.Command {
 	return &cobra.Command{
-		Use:        "[<options>] <component> <version> --provider <provider-name> {--provider <label>=<value>} {<label>=<value>}",
-		Args:       cobra.MinimumNArgs(2),
-		Short:      "(DEPRECATED) create new component archive",
-		Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
+		Use:   "[<options>] <component> <version> --provider <provider-name> {--provider <label>=<value>} {<label>=<value>}",
+		Args:  cobra.MinimumNArgs(2),
+		Short: "(DEPRECATED) create new component archive",
+		// this removes the command from the help output - https://github.com/open-component-model/ocm/issues/1242#issuecomment-2609312927
+		// Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 		Example: `
 $ ocm create componentarchive --file myfirst --provider acme.org --provider email=alice@acme.org acme.org/demo 1.0
 `,
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
index aa0582c634..6aca6a247e 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
@@ -55,10 +55,11 @@ func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) ForName(name string) *cobra.Command {
 	return &cobra.Command{
-		Use:        "[<options>]  <source> <target>",
-		Args:       cobra.MinimumNArgs(2),
-		Short:      "(DEPRECATED) transfer component archive to some component repository",
-		Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
+		Use:   "[<options>]  <source> <target>",
+		Args:  cobra.MinimumNArgs(2),
+		Short: "(DEPRECATED) transfer component archive to some component repository",
+		// this removes the command from the help output - https://github.com/open-component-model/ocm/issues/1242#issuecomment-2609312927
+		// Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 		Long: `
 Transfer a component archive to some component repository. This might
 be a CTF Archive or a regular repository.
diff --git a/docs/reference/ocm_create.md b/docs/reference/ocm_create.md
index 70c319cbee..eb4db9987a 100644
--- a/docs/reference/ocm_create.md
+++ b/docs/reference/ocm_create.md
@@ -21,6 +21,7 @@ ocm create [<options>] <sub command> ...
 
 ##### Sub Commands
 
+* [ocm create <b>componentarchive</b>](ocm_create_componentarchive.md)	 &mdash; (DEPRECATED) create new component archive
 * [ocm create <b>rsakeypair</b>](ocm_create_rsakeypair.md)	 &mdash; create RSA public key pair
 * [ocm create <b>transportarchive</b>](ocm_create_transportarchive.md)	 &mdash; create new OCI/OCM transport  archive
 
diff --git a/docs/reference/ocm_create_componentarchive.md b/docs/reference/ocm_create_componentarchive.md
new file mode 100644
index 0000000000..f95d8403dc
--- /dev/null
+++ b/docs/reference/ocm_create_componentarchive.md
@@ -0,0 +1,62 @@
+## ocm create componentarchive &mdash; (DEPRECATED) Create New Component Archive
+
+### Synopsis
+
+```bash
+ocm create componentarchive [<options>] <component> <version> --provider <provider-name> {--provider <label>=<value>} {<label>=<value>}
+```
+
+#### Aliases
+
+```text
+componentarchive, comparch, ca
+```
+
+### Options
+
+```text
+  -F, --file string            target file/directory (default "component-archive")
+  -f, --force                  remove existing content
+  -h, --help                   help for componentarchive
+  -p, --provider stringArray   provider attribute
+  -S, --scheme string          schema version (default "v2")
+  -t, --type string            archive format (directory, tar, tgz) (default "directory")
+```
+
+### Description
+
+Create a new component archive. This might be either a directory prepared
+to host component version content or a tar/tgz file (see option --type).
+
+A provider must be specified, additional provider labels are optional.
+
+
+The <code>--type</code> option accepts a file format for the
+target archive to use. It is only evaluated if the target
+archive does not exist yet. The following formats are supported:
+- directory
+- tar
+- tgz
+
+The default format is <code>directory</code>.
+
+
+If the option <code>--scheme</code> is given, the specified component descriptor format is used/generated.
+
+The following schema versions are supported for explicit conversions:
+  - <code>ocm.software/v3alpha1</code>
+  - <code>v2</code> (default)
+
+### Examples
+
+```bash
+$ ocm create componentarchive --file myfirst --provider acme.org --provider email=alice@acme.org acme.org/demo 1.0
+```
+
+### SEE ALSO
+
+#### Parents
+
+* [ocm create](ocm_create.md)	 &mdash; Create transport or component archive
+* [ocm](ocm.md)	 &mdash; Open Component Model command line client
+
diff --git a/docs/reference/ocm_ocm.md b/docs/reference/ocm_ocm.md
index ff385ece4f..2c1f092df8 100644
--- a/docs/reference/ocm_ocm.md
+++ b/docs/reference/ocm_ocm.md
@@ -22,6 +22,7 @@ ocm ocm [<options>] <sub command> ...
 ##### Sub Commands
 
 * ocm ocm <b>commontransportarchive</b>	 &mdash; Commands acting on common transport archives
+* ocm ocm <b>componentarchive</b>	 &mdash; Commands acting on component archives
 * ocm ocm <b>componentversions</b>	 &mdash; Commands acting on components
 * ocm ocm <b>plugins</b>	 &mdash; Commands related to OCM plugins
 * ocm ocm <b>pubsub</b>	 &mdash; Commands acting on sub/sub specifications
diff --git a/docs/reference/ocm_transfer.md b/docs/reference/ocm_transfer.md
index 7285b0b873..9a9cad036f 100644
--- a/docs/reference/ocm_transfer.md
+++ b/docs/reference/ocm_transfer.md
@@ -23,5 +23,6 @@ ocm transfer [<options>] <sub command> ...
 
 * [ocm transfer <b>artifacts</b>](ocm_transfer_artifacts.md)	 &mdash; transfer OCI artifacts
 * [ocm transfer <b>commontransportarchive</b>](ocm_transfer_commontransportarchive.md)	 &mdash; transfer transport archive
+* [ocm transfer <b>componentarchive</b>](ocm_transfer_componentarchive.md)	 &mdash; (DEPRECATED) transfer component archive to some component repository
 * [ocm transfer <b>componentversions</b>](ocm_transfer_componentversions.md)	 &mdash; transfer component version
 
diff --git a/docs/reference/ocm_transfer_componentarchive.md b/docs/reference/ocm_transfer_componentarchive.md
new file mode 100644
index 0000000000..a4fe9e4e8f
--- /dev/null
+++ b/docs/reference/ocm_transfer_componentarchive.md
@@ -0,0 +1,96 @@
+## ocm transfer componentarchive &mdash; (DEPRECATED) Transfer Component Archive To Some Component Repository
+
+### Synopsis
+
+```bash
+ocm transfer componentarchive [<options>]  <source> <target>
+```
+
+#### Aliases
+
+```text
+componentarchive, comparch, ca
+```
+
+### Options
+
+```text
+  -L, --copy-local-resources   transfer referenced local resources by-value
+  -V, --copy-resources         transfer referenced resources by-value
+      --copy-sources           transfer referenced sources by-value
+      --enforce                enforce transport as if target version were not present
+  -h, --help                   help for componentarchive
+      --lookup stringArray     repository name or spec for closure lookup fallback
+      --no-update              don't touch existing versions in target
+  -f, --overwrite              overwrite existing component versions
+  -t, --type string            archive format (directory, tar, tgz) (default "directory")
+```
+
+### Description
+
+Transfer a component archive to some component repository. This might
+be a CTF Archive or a regular repository.
+If the type CTF is specified the target must already exist, if CTF flavor
+is specified it will be created if it does not exist.
+
+Besides those explicitly known types a complete repository spec might be configured,
+either via inline argument or command configuration file and name.
+
+
+The <code>--type</code> option accepts a file format for the
+target archive to use. It is only evaluated if the target
+archive does not exist yet. The following formats are supported:
+- directory
+- tar
+- tgz
+
+The default format is <code>directory</code>.
+
+\
+If a component lookup for building a reference closure is required
+the <code>--lookup</code>  option can be used to specify a fallback
+lookup repository. By default, the component versions are searched in
+the repository holding the component version for which the closure is
+determined. For *Component Archives* this is never possible, because
+it only contains a single component version. Therefore, in this scenario
+this option must always be specified to be able to follow component
+references.
+
+
+With the option <code>--no-update</code> existing versions in the target
+repository will not be touched at all. An additional specification of the
+option <code>--overwrite</code> is ignored. By default, updates of
+volatile (non-signature-relevant) information is enabled, but the
+modification of non-volatile data is prohibited unless the overwrite
+option is given.
+
+
+If the option <code>--overwrite</code> is given, component versions in the
+target repository will be overwritten, if they already exist, but with different digest.
+If the option <code>--enforce</code> is given, component versions in the
+target repository will be transported as if they were not present on the target side,
+regardless of their state (this is independent on their actual state, even identical
+versions are re-transported).
+
+
+If the option <code>--copy-resources</code> is given, all referential
+resources will potentially be localized, mapped to component version local
+resources in the target repository. If the option <code>--copy-local-resources</code>
+is given, instead, only resources with the relation <code>local</code> will be
+transferred. This behaviour can be further influenced by specifying a transfer
+script with the <code>script</code> option family.
+
+
+If the option <code>--copy-sources</code> is given, all referential
+sources will potentially be localized, mapped to component version local
+resources in the target repository.
+This behaviour can be further influenced by specifying a transfer script
+with the <code>script</code> option family.
+
+### SEE ALSO
+
+#### Parents
+
+* [ocm transfer](ocm_transfer.md)	 &mdash; Transfer artifacts or components
+* [ocm](ocm.md)	 &mdash; Open Component Model command line client
+
diff --git a/hack/generate-docs/cobradoc/md_docs.go b/hack/generate-docs/cobradoc/md_docs.go
index afb1ad8ae4..0b7ea0a0ad 100644
--- a/hack/generate-docs/cobradoc/md_docs.go
+++ b/hack/generate-docs/cobradoc/md_docs.go
@@ -139,7 +139,7 @@ func GenMarkdownCustom(cmd *cobra.Command, w io.Writer, linkHandler func(string)
 
 		subheader := false
 		for _, child := range children {
-			if OverviewOnly(child) || !child.IsAvailableCommand() || child.IsAdditionalHelpTopicCommand() || IsDeprecated(child) {
+			if OverviewOnly(child) || !child.IsAvailableCommand() || child.IsAdditionalHelpTopicCommand() {
 				continue
 			}
 			if header && !subheader {
@@ -266,10 +266,6 @@ func DocuCommandPath(cmd *cobra.Command) string {
 	return cmd.CommandPath()
 }
 
-func IsDeprecated(cmd *cobra.Command) bool {
-	return cmd.Deprecated != ""
-}
-
 func ExampleCodeStyle(cmd *cobra.Command) string {
 	if cmd.Annotations != nil {
 		if p, ok := cmd.Annotations["ExampleCodeStyle"]; ok {

From 768daa40004353940e8ed434e021ae9db51effb8 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Thu, 23 Jan 2025 11:38:59 +0100
Subject: [PATCH 14/15] (DEPRECATED)

---
 cmds/ocm/commands/ocmcmds/componentarchive/cmd.go | 2 +-
 docs/reference/ocm_ocm.md                         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index 0dba356f84..d999a51294 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -19,7 +19,7 @@ var Names = names.ComponentArchive
 // NewCommand creates a new command.
 func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd := utils.MassageCommand(&cobra.Command{
-		Short: "Commands acting on component archives",
+		Short: "(DEPRECATED) Commands acting on component archives",
 		// this removes the command from the help output - https://github.com/open-component-model/ocm/issues/1242#issuecomment-2609312927
 		// Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 	}, Names...)
diff --git a/docs/reference/ocm_ocm.md b/docs/reference/ocm_ocm.md
index 2c1f092df8..d3caaff28b 100644
--- a/docs/reference/ocm_ocm.md
+++ b/docs/reference/ocm_ocm.md
@@ -22,7 +22,7 @@ ocm ocm [<options>] <sub command> ...
 ##### Sub Commands
 
 * ocm ocm <b>commontransportarchive</b>	 &mdash; Commands acting on common transport archives
-* ocm ocm <b>componentarchive</b>	 &mdash; Commands acting on component archives
+* ocm ocm <b>componentarchive</b>	 &mdash; (DEPRECATED) Commands acting on component archives
 * ocm ocm <b>componentversions</b>	 &mdash; Commands acting on components
 * ocm ocm <b>plugins</b>	 &mdash; Commands related to OCM plugins
 * ocm ocm <b>pubsub</b>	 &mdash; Commands acting on sub/sub specifications

From 7adebf0304d47b3a3f762b51b10e648339fe9079 Mon Sep 17 00:00:00 2001
From: Hilmar Falkenberg <hilmar.falkenberg@sap.com>
Date: Mon, 27 Jan 2025 14:14:03 +0100
Subject: [PATCH 15/15] (DEPRECATED) - Please use commontransportarchive
 instead

---
 cmds/ocm/commands/ocmcmds/componentarchive/cmd.go          | 2 +-
 cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go | 4 ++--
 docs/reference/ocm_ocm.md                                  | 2 +-
 docs/reference/ocm_transfer.md                             | 2 +-
 docs/reference/ocm_transfer_componentarchive.md            | 4 ++--
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
index d999a51294..d13bd637d9 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/cmd.go
@@ -19,7 +19,7 @@ var Names = names.ComponentArchive
 // NewCommand creates a new command.
 func NewCommand(ctx clictx.Context) *cobra.Command {
 	cmd := utils.MassageCommand(&cobra.Command{
-		Short: "(DEPRECATED) Commands acting on component archives",
+		Short: "(DEPRECATED) - Please use " + names.CommonTransportArchive[0] + " instead",
 		// this removes the command from the help output - https://github.com/open-component-model/ocm/issues/1242#issuecomment-2609312927
 		// Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 	}, Names...)
diff --git a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
index 6aca6a247e..e79d6155d3 100644
--- a/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
+++ b/cmds/ocm/commands/ocmcmds/componentarchive/transfer/cmd.go
@@ -55,9 +55,9 @@ func NewCommand(ctx clictx.Context, names ...string) *cobra.Command {
 // Deprecated: Component Archive (CA) - https://kubernetes.slack.com/archives/C05UWBE8R1D/p1734357630853489
 func (o *Command) ForName(name string) *cobra.Command {
 	return &cobra.Command{
-		Use:   "[<options>]  <source> <target>",
+		Use:   "[<options>] <source> <target>",
 		Args:  cobra.MinimumNArgs(2),
-		Short: "(DEPRECATED) transfer component archive to some component repository",
+		Short: "(DEPRECATED) - Please use " + names.CommonTransportArchive[0] + " instead",
 		// this removes the command from the help output - https://github.com/open-component-model/ocm/issues/1242#issuecomment-2609312927
 		// Deprecated: "Deprecated - use " + ocm.CommonTransportFormat + " instead",
 		Long: `
diff --git a/docs/reference/ocm_ocm.md b/docs/reference/ocm_ocm.md
index d3caaff28b..1a740ca492 100644
--- a/docs/reference/ocm_ocm.md
+++ b/docs/reference/ocm_ocm.md
@@ -22,7 +22,7 @@ ocm ocm [<options>] <sub command> ...
 ##### Sub Commands
 
 * ocm ocm <b>commontransportarchive</b>	 &mdash; Commands acting on common transport archives
-* ocm ocm <b>componentarchive</b>	 &mdash; (DEPRECATED) Commands acting on component archives
+* ocm ocm <b>componentarchive</b>	 &mdash; (DEPRECATED) - Please use commontransportarchive instead
 * ocm ocm <b>componentversions</b>	 &mdash; Commands acting on components
 * ocm ocm <b>plugins</b>	 &mdash; Commands related to OCM plugins
 * ocm ocm <b>pubsub</b>	 &mdash; Commands acting on sub/sub specifications
diff --git a/docs/reference/ocm_transfer.md b/docs/reference/ocm_transfer.md
index 9a9cad036f..171a8075c7 100644
--- a/docs/reference/ocm_transfer.md
+++ b/docs/reference/ocm_transfer.md
@@ -23,6 +23,6 @@ ocm transfer [<options>] <sub command> ...
 
 * [ocm transfer <b>artifacts</b>](ocm_transfer_artifacts.md)	 &mdash; transfer OCI artifacts
 * [ocm transfer <b>commontransportarchive</b>](ocm_transfer_commontransportarchive.md)	 &mdash; transfer transport archive
-* [ocm transfer <b>componentarchive</b>](ocm_transfer_componentarchive.md)	 &mdash; (DEPRECATED) transfer component archive to some component repository
+* [ocm transfer <b>componentarchive</b>](ocm_transfer_componentarchive.md)	 &mdash; (DEPRECATED) - Please use commontransportarchive instead
 * [ocm transfer <b>componentversions</b>](ocm_transfer_componentversions.md)	 &mdash; transfer component version
 
diff --git a/docs/reference/ocm_transfer_componentarchive.md b/docs/reference/ocm_transfer_componentarchive.md
index a4fe9e4e8f..bd50b97fb9 100644
--- a/docs/reference/ocm_transfer_componentarchive.md
+++ b/docs/reference/ocm_transfer_componentarchive.md
@@ -1,9 +1,9 @@
-## ocm transfer componentarchive &mdash; (DEPRECATED) Transfer Component Archive To Some Component Repository
+## ocm transfer componentarchive &mdash; (DEPRECATED) - Please Use Commontransportarchive Instead
 
 ### Synopsis
 
 ```bash
-ocm transfer componentarchive [<options>]  <source> <target>
+ocm transfer componentarchive [<options>] <source> <target>
 ```
 
 #### Aliases