rspec / rspec-mocks

RSpec's 'test double' framework, with support for stubbing and mocking
https://rspec.info
MIT License
1.16k stars 357 forks source link

doc: broken links (404) on rspec.info #1557

Closed exoego closed 9 months ago

exoego commented 9 months ago

Subject of the issue

https://rspec.info/features/3-12/rspec-mocks/configuring-responses/ image

Links in README.md appears broken (404).

Your environment

No, it is about doc site.

Steps to reproduce

Visit https://rspec.info/features/3-12/rspec-mocks/configuring-responses/ and click links.

Expected behavior

Links should navigate to the proper document.

Actual behavior

404 is shown image

exoego commented 9 months ago

I found GH repo for rspec.info and this issue appears to duplicate https://github.com/rspec/rspec.github.io/issues/188

pirj commented 9 months ago

You can take over if you like, @exoego. Unless you’ve started it already, @danieldiekmeier

danieldiekmeier commented 9 months ago

No, sorry, I haven't had time to start yet. 😰

exoego commented 9 months ago

I've tried to fix markdown generation in https://github.com/rspec/rspec-dev/blob/a2a50c9c855a1666194a139264b99fa735176617/Rakefile#L216 but bin/rake "update_docs[3-12-maintenance]" failed and I do not know how to fix this dependency conflict with the Rake tasks.

$ bin/rake "update_docs[3-12-maintenance]"
Checking versions...                   
==================================================
# rspec-core
----------------------------------------
Switched to a new branch '3-12-maintenance'
bundle update &&          RUBYOPT='-I../rspec.github.io/lib' bundle exec yard                           --yardopts .yardopts                           --output-dir /Users/yasuhiro.tatsuno/IdeaProjects/rspec.github.io/source/documentation/3-12-maintenance/rspec-core/
Your RubyGems version (3.0.3.1) has a bug that prevents `required_ruby_version` from working for Bundler. Any scripts that use `gem install bundler` will break as soon as Bundler drops support for your Ruby version. Please upgrade RubyGems to avoid future breakage and silence this warning by running `gem update --system 3.2.3`
Fetching gem metadata from https://rubygems.org/.........
Resolving dependencies...
Could not find compatible versions

Because every version of rspec-expectations depends on rspec-support = 3.13.0.pre
  and every version of rspec-core depends on rspec-support ~> 3.12.0,
  every version of rspec-expectations is incompatible with rspec-core >= 0.
So, because Gemfile depends on rspec-core >= 0
  and Gemfile depends on rspec-expectations >= 0,
  version solving has failed.
    Creating cucumber documentation requires the gherkin2makrdown tool:
    - Install go using your preferred run time (tested with asdf and golang 1.20)
    - Then run:
  go install github.com/raviqqe/gherkin2markdown@latest
  ```
  OR surpress this message by running with NO_CUCUMBER=true


`gherkin2markdown@latest` is already go-installed.
pirj commented 9 months ago

You need to go into every repo under ‘repos’ directory and ‘git checkout 3-12-stable’.

exoego commented 9 months ago

FYI: Opened https://github.com/rspec/rspec.github.io/pull/190