Deprecate the update-imported-docs workflow and quickstart

[Mohamed0Mourad]

Description

This PR implements the deprecation and announcement phase of subtask B4 in
#56385.

The update-imported-docs workflow is obsolete, but its files and the
quickstart URL are retained temporarily so that contributors, localization
teams, and users with bookmarked links can discover the replacement guides.

This change:

• adds a deprecation notice to every file under update-imported-docs/;
• replaces the quickstart body with a deprecation stub that links to the
  generator-specific guides;
• updates the reference documentation link in new-content/_index.md to point
  to /docs/contribute/generate-ref-docs/;
• leaves generate-ref-docs/_index.md unchanged for subtask B3.

No workflow files or documentation URLs are removed in this PR. Their removal,
including an alias for the quickstart URL, will be handled in a follow-up PR.

Validation

• git diff --cached --check
• python3 scripts/linkchecker.py -n -f content/en/docs/contribute/generate-ref-docs/quickstart.md
• python3 scripts/linkchecker.py -n -f content/en/docs/contribute/new-content/_index.md

• make container-build
• Local preview at /docs/contribute/generate-ref-docs/quickstart/
• quickstart before

- quickstart after

Related to: #56385

Implements the deprecation and announcement phase of B4.

[kubernetes-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign sayakmukhopadhyay for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS
• content/en/docs/OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[netlify]

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	c44769c
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6a5e5e6ec7a7f20008d959eb
😎 Deploy Preview	https://deploy-preview-56525--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Caesarsage]

Thanks for taking this on, @Mohamed0Mourad , retiring update-imported-docs.py is the right direction. Two suggestion:

1. Deprecate, don't delete: both the update-imported-docs/ files and quickstart.md. Nothing in CI or tooling invokes the script, so this is signposting (localization teams, bookmarked URLs) rather than a hard dependency, but deprecate → announce → remove is safer. Add a deprecation notice to each update-imported-docs/ file, and replace the quickstart.md body with a deprecation stub that links the per-generator pages. A follow-up PR removes both, with aliases: for the quickstart URL.

2. Drop the quickstart workflow rewrite. The reference docs are generated one page per generator now (kubernetes-api.md, config-api.md in #56497, the merging of component page in B1), so re-inlining the pipeline here duplicates them and the page is being deprecated anyway.

Also leave the generate-ref-docs/_index.md alone too; turning it into the section entry point is subtask B3.

Scope for this PR: deprecate update-imported-docs/ + deprecate quickstart.md, and retarget the new-content/_index.md link you already changed to the section index (/docs/contribute/generate-ref-docs/) instead of the quickstart.

The module map and the actual removals come with B3 and a cleanup PR.

[Caesarsage]

IMO, we should add a deprecation note here first before deleting the file. This is the flow i generally follow

Deprecate -> Announce -> Wait -> Remove (if needed)

The first PR will serve as (Deprecate and Announce ). Then we could raise another PR to remove the file (referencing this after merged).

[Caesarsage]

Let's do this for all the file on this folder instead of direct removal

[Mohamed0Mourad]

Done. I restored all four files under update-imported-docs/ and added a clear
deprecation notice to each file. No workflow files are removed in this PR now.

[Caesarsage]

As as the comment on the README, let's deprecate first

[Mohamed0Mourad]

Done. I restored reference.yml and marked it as deprecated. I applied the same
notice to release.yml and update-imported-docs.py as requested.

[Caesarsage]

no need for rewrite, it will become a duplicate. we are deprecating this, so a deprecate notice will be suitable instead

[Mohamed0Mourad]

@Caesarsage
Thanks for the detailed review. I narrowed the PR to the deprecation and
announcement phase:

• restored all files under update-imported-docs/ and added deprecation notices;
• replaced the quickstart workflow rewrite with a deprecation stub;
• retargeted the new-content link to /docs/contribute/generate-ref-docs/;
• left generate-ref-docs/_index.md unchanged.

The actual file removal and quickstart alias will be handled in a follow-up PR.
I also rebuilt and previewed the page locally and reran the link checks.