Update tutorial.rst: clarify how to run spider

[JessA-L]

When I used the tutorial, I was confused about how to run the spider again. I later realized that I never exited the Scrapy shell.

This edit should provide more guidance to future users of Scrapy and the tutorial.

[wRAR]

I'm not convinced we should expect users to not understand the difference between console commands and Python code :-/

[JessA-L]

Hi, thanks for your quick reply.

I’m proposing this change because I had to troubleshoot it myself. Another fellow student had issues at this section as well. Further, Scrapy is used by others who aren’t super familiar with the command line, like those in the marketing field. The tutorial begins with references to basic python instruction, so it seems like it targets unexperienced users.

[wRAR]

Yeah, it makes sense, but in that case I'd want something more general or something written in the beginning of the tutorial that explains these basics, as the proposed "exit the scrapy shell" line would be OK in a differently structured doc (one that expected a single terminal opened in a specific directory and showed exact commands one after another, with "now open the scrapy shell", "now close it and run scrapy crawl" etc. steps) but looks out of place to me in this somewhat more abstract tutorial.

@Gallaecio what do you think?

[Gallaecio]

I think the proposed changes are great. While I agree with @wRAR’s points for general documentation, I think in a tutorial specifically hand-holding is more important than not repeating yourself.

[codecov]

Codecov Report

Merging #6128 (9cdb150) into master (593bfd8) will increase coverage by 0.07%.
Report is 3 commits behind head on master.
The diff coverage is n/a.

❗ Current head 9cdb150 differs from pull request most recent head a3cd068. Consider uploading reports for the commit a3cd068 to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #6128      +/-   ##
==========================================
+ Coverage   88.71%   88.78%   +0.07%     
==========================================
  Files         160      160              
  Lines       11428    11428              
  Branches     1862     1862              
==========================================
+ Hits        10138    10146       +8     
+ Misses        979      973       -6     
+ Partials      311      309       -2     

see 1 file with indirect coverage changes

[wRAR]

Thanks!