Skip to content

📚 Scribe: weave admin_manual/release_notes@3ad9158 (admin-manual-release-notes-1) - #64

Merged
ddespinoza merged 1 commit into
mainfrom
weave/admin-manual-release-notes-1
Oct 9, 2026
Merged

ddespinoza merged 1 commit into
mainfrom
weave/admin-manual-release-notes-1

Conversation

@ddespinoza

Copy link
Copy Markdown
Contributor

Why

Bulk weave of the Nextcloud manuals (scribe W-runs): this batch brings admin_manual/release_notes from nextcloud/documentation 3ad9158 into the APS chapters, translated per tools/weave-contract.md. User-manual paragraphs with an official Transifex msgstr use it word for word; the rest is AI-translated. «Nextcloud» stays in the source and the build renames it.

Docs

Upstream Page
admin_manual/release_notes/index administracion/notas-de-version/index.md new
admin_manual/release_notes/upgrade_to_26 administracion/notas-de-version/upgrade-to-26.md new
admin_manual/release_notes/upgrade_to_27 administracion/notas-de-version/upgrade-to-27.md new
admin_manual/release_notes/upgrade_to_28 administracion/notas-de-version/upgrade-to-28.md new
admin_manual/release_notes/upgrade_to_30 administracion/notas-de-version/upgrade-to-30.md new
admin_manual/release_notes/upgrade_to_31 administracion/notas-de-version/upgrade-to-31.md new
admin_manual/release_notes/upgrade_to_32 administracion/notas-de-version/upgrade-to-32.md new
admin_manual/release_notes/upgrade_to_33 administracion/notas-de-version/upgrade-to-33.md new

Gaps

  • No include, literalinclude, raw:: html or unknown constructs anywhere in the batch. Nothing was left out.
  • admin_manual/release_notes/upgrade_to_30 (upstream defect, typo): «was added to allow bocking files with specific basenames». «bocking» is a typo for «blocking». A translation cannot keep the typo, so the page says «bloquear».
  • admin_manual/release_notes/upgrade_to_33 (upstream defect, RST default role used for code): «run occ background-job:worker <JobClass> ... running occ taskprocessing:worker». Single backticks render in italics upstream, not as code. Written as occ background-job:worker <JobClass> and occ taskprocessing:worker, as the contract says. The < > escapes stop MyST from reading as an HTML tag, and the page renders it correctly.
  • admin_manual/release_notes/upgrade_to_28 (upstream defect, same class): «review not only their config.php (for cleanup)». The single backticks render in italics upstream, so the page has config.php.
  • admin_manual/release_notes/upgrade_to_32 (upstream defect, dangling pointer): «For more information about the system address book, see the documentation. :ref:System Address Book <system-address-book>». The link sits loose after the sentence that points at it. Kept as upstream writes it.
  • admin_manual/release_notes/upgrade_to_28: «Please reach out to us via feat: add preview provider for emf files based on office nextcloud/server#41395 if that's causing any trouble for you». This invites readers to report a problem to Nextcloud through a single upstream PR. The page carries the URL unchanged as an autolink, with «us» written as {vendor}Nextcloud. The contract's verbatim suite-issues note follows the block. That note links {doc}/proyecto/errores-conocidos, whose searches are org:APS-Conecta across the whole suite, not the documentation repo. Specific issue and PR links in upgrade_to_31 (issues/34497, pull/48547) are technical references, so they get no note.

Checks

  • Translator (Opus 5.5, xhigh) ran the contract gates. Adversarial reviewer (Opus 5.5, high): 3 finding(s), then one fix round (Opus 5.5, xhigh):
    • administracion/notas-de-version/index.md (other): The page is wrong only according to the gate. tools/upstream-fidelity.py fails it with «cross-references differ: missing [('doc', 'admin_manual/release_notes/upgrade_to_26.rst'), …]». The upstream toctree lists its entries with the .rst
    • administracion/notas-de-version/index.md (other): This is a second false positive from the gate on the same list: «paragraph reads as English: «admin_manual/release_notes/upgrade_to_33 …»». plain() keeps the target of a bare {nc-doc} role as visible text, so reads_english counts `adm
    • administracion/notas-de-version/upgrade-to-31.md (rebrand): tools/rebrand-check.py reports a leftover in upgrade-to-31.html: «…ño de fragmento en el lado de Nextcloud . Monitorización…». The cause is the bare {nc-ref}files_configure_max_chunk_size``, which is correct under contract §3 (a bare
  • Re-run before push: upstream-fidelity → [upstream-fidelity] 8 block(s); coverage 8/507 documents; 117 AI-translated paragraph(s) counted; repo-docs check . --offline → -- 0 error(s); sphinx-build -W --keep-going → clean.
  • CI: required build + docs; auto-merge (Q16).

This PR includes text written with AI assistance; not yet reviewed by a human. It merges on green deterministic checks (Q16).

🤖 Generated with Claude Code

https://claude.ai/code/session_01GNb89udEGm8RLSEDcPS6Z8

…d9158

- admin_manual/release_notes/index -> administracion/notas-de-version/index.md
- admin_manual/release_notes/upgrade_to_26 -> administracion/notas-de-version/upgrade-to-26.md
- admin_manual/release_notes/upgrade_to_27 -> administracion/notas-de-version/upgrade-to-27.md
- admin_manual/release_notes/upgrade_to_28 -> administracion/notas-de-version/upgrade-to-28.md
- admin_manual/release_notes/upgrade_to_30 -> administracion/notas-de-version/upgrade-to-30.md
- admin_manual/release_notes/upgrade_to_31 -> administracion/notas-de-version/upgrade-to-31.md
- admin_manual/release_notes/upgrade_to_32 -> administracion/notas-de-version/upgrade-to-32.md
- admin_manual/release_notes/upgrade_to_33 -> administracion/notas-de-version/upgrade-to-33.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GNb89udEGm8RLSEDcPS6Z8
@ddespinoza ddespinoza added the ai-assisted Written with AI assistance label Oct 9, 2026
@ddespinoza
ddespinoza enabled auto-merge (squash) October 9, 2026 19:19
@ddespinoza
ddespinoza merged commit a56f9b4 into main Oct 9, 2026
3 checks passed
@ddespinoza
ddespinoza deleted the weave/admin-manual-release-notes-1 branch October 9, 2026 19:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-assisted Written with AI assistance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant