同じコンテキストに複数のexampleがあると後勝ちでdescriptionが上書きされる

[nanophate]

問題

一つの同じContextの中でinclude_examplesし、その中でdescriptionを定義すると、後勝ちでdescriptionが上書きされます。

以下のような:point_down:の内容を実行したところこのバグを発見しました。

require 'rails_helper'

RSpec.describe 'Users', :autodoc do

  describe 'GET /users/:user_id' do
    let(:user) { create(:user) }

    shared_examples 'page not found' do
     it { is_expected.to eq(404) }
    end

    shared_examples 'page accesable ' do
      it { is_expected.to eq(200) }
    end

    include_examples 'page not found' do
      let(:user_id) { user.tap(&:destroy).id }
      let(:description) { 'When user is not exist' }

    end

    include_examples 'page accesable' do
      let(:user_id) { user.id }
      let(:description) { 'When user exist' }
    end
  end
end

## GET /users/:user_id
- When user exist


### Example

#### Request

...

## GET /users/:user_id
- When user exist


### Example

#### Request

[r7kamura]

報告ありがとうございます 🙏

include_examples に block を渡したときに、context の内容がどうなるかについて把握していませんでしたが、確かに起り得そうな話に見えます。

autodoc/lib/autodoc/document.rb

Lines 195 to 199 in 11f2ad2

	if @context.respond_to?(:description)
	@context.description.strip_heredoc
	else
	example.description.sub(/\A./, &:upcase).concat('.')
	end

簡単に見てみたところ、改善できるとしたらこの辺りのコードを変更すると直るかもしれないなと思って見ています。