#20584 Some in-repo `doc_url` calls point to pages that don't exist Issue created by huonw Describe the bug The

doc_url

function constructs a link to the rendered docs. There's a few that seem to land on pages that don't exist, even in the old website (i.e. I wasn't sure where they should point to in #20427 / #20583): • "avro" pants/src/python/pants/backend/codegen/avro/target_types.py Line 56 in</pantsbuild/pants/commit/110ad3898c5a0ceea6f8f57995ec16db7f2edcde|110ad38> | See {doc_url('avro')}. | | ---------------------- | • "create-initial-build-files", according to https://github.com/pantsbuild/pantsbuild.org/blob/main/old_site_redirects.js this existed up to 2.10, but not after. pants/src/python/pants/engine/internals/graph.py Line 933 in</pantsbuild/pants/commit/110ad3898c5a0ceea6f8f57995ec16db7f2edcde|110ad38> | f"{doc_url('create-initial-build-files')}.{option_msg}" | | ------------------------------------------------------- | • "debian-package" pants/src/python/pants/backend/debian/target_types.py Line 123 in</pantsbuild/pants/commit/110ad3898c5a0ceea6f8f57995ec16db7f2edcde|110ad38> | "See {doc_url('debian-package')}. | | --------------------------------- | • "resources", according to https://github.com/pantsbuild/pantsbuild.org/blob/main/old_site_redirects.js this existed up to 2.9, but not after. pants/src/python/pants/backend/python/util_rules/pex_from_targets.py Line 516 in</pantsbuild/pants/commit/110ad3898c5a0ceea6f8f57995ec16db7f2edcde|110ad38> | f"\n\nInstead, use

resources

targets. See {doc_url('resources')}." | | -------------------------------------------------------------------- | • The

user-lockfiles

anchor: pants/src/python/pants/backend/python/subsystems/python_tool_base.py Line 61 in</pantsbuild/pants/commit/110ad3898c5a0ceea6f8f57995ec16db7f2edcde|110ad38> | {doc_url("python-third-party-dependencies#user-lockfiles")}. | | ------------------------------------------------------------ | Pants version 2.20 OS N/A Additional info This lists some spot fixes. A more general solution might validate that the URLs definitely exist, somehow. pantsbuild/pants