Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Several docs pages reference missing static assets and bytecode files

Open
  • Is something wrong?
#1,425 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Quiet
Domain
documentation

Research direction

Inspect the listed fault-proof and upgrade derivation pages, then compare each referenced /static/assets and /static/bytecode path with the repository contents. Resolve each reference by adding the expected file, correcting its path, or removing/replacing the link; done means all affected diagrams and full bytecode links load correctly.

Written by the indexing model from the issue text.

Description

Summary

Several Base Chain spec pages reference /static/... assets and bytecode files that do not appear to exist in the repository.

Missing image references

  • docs/base-chain/specs/protocol/fault-proof/index.mdx:20 -> /static/assets/fault-proof.svg
  • docs/base-chain/specs/protocol/fault-proof/stage-one/bridge-integration.mdx:29 -> /static/assets/legacy-l2oo-list.png
  • docs/base-chain/specs/protocol/fault-proof/stage-one/fault-dispute-game.mdx:116 -> /static/assets/ob-tree.png
  • docs/base-chain/specs/protocol/fault-proof/stage-one/fault-dispute-game.mdx:205 -> /static/assets/attack.png
  • docs/base-chain/specs/protocol/fault-proof/stage-one/fault-dispute-game.mdx:214 -> /static/assets/defend.png
  • docs/base-chain/specs/protocol/fault-proof/stage-one/fault-dispute-game.mdx:221 -> /static/assets/valid-moves.png

Missing bytecode references

  • docs/base-chain/specs/upgrades/ecotone/derivation.mdx:129 -> /static/bytecode/ecotone-l1-block-deployment.txt
  • docs/base-chain/specs/upgrades/ecotone/derivation.mdx:170 -> /static/bytecode/ecotone-gas-price-oracle-deployment.txt
  • docs/base-chain/specs/upgrades/fjord/derivation.mdx:157 -> /static/bytecode/fjord-gas-price-oracle-deployment.txt
  • docs/base-chain/specs/upgrades/isthmus/derivation.mdx:36 -> /static/bytecode/isthmus-l1-block-deployment.txt
  • docs/base-chain/specs/upgrades/isthmus/derivation.mdx:84 -> /static/bytecode/isthmus-gas-price-oracle-deployment.txt
  • docs/base-chain/specs/upgrades/isthmus/derivation.mdx:137 -> /static/bytecode/isthmus-operator-fee-deployment.txt
  • docs/base-chain/specs/upgrades/jovian/derivation.mdx:48 -> /static/bytecode/jovian-l1-block-deployment.txt
  • docs/base-chain/specs/upgrades/jovian/derivation.mdx:129 -> /static/bytecode/jovian-gas-price-oracle-deployment.txt

Expected behavior

Referenced diagrams and full bytecode files should be present and load correctly.

Suggested fix

Either:

  1. Add the missing static files to the expected location, or
  2. Update the references to the correct existing asset paths, or
  3. Remove or replace the links if these files are no longer intended to be published.

Impact

This affects technical specification pages where diagrams and full bytecode links are important for understanding and verification.

Dominant language
JavaScript
Stars
337
Forks
798
Avg merge
19h 12m
Merged PRs (30d)
60

Getting set up

We have not checked this project's setup files yet. Start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from base/docs

All issues in base/docs

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.