search

yesodweb / yesodweb.com-content

Content for the www.yesodweb.com site
http://www.yesodweb.com/
Other
67 stars 112 forks source link

Include Getting Started Information #256

Open finlaydotb opened 3 years ago

finlaydotb commented 3 years ago

I recently started reading the Yesod book and it was a bit confusing trying to figure out how to get started. The section that introduced the first code here https://www.yesodweb.com/book-1.6/basics does not work out of the box. It seems some prior installation needs to have happened.

I later found the quickstart guide here which seems to contain the prerequisites. I think it would be useful if the Yesod book itself contains this instructions, or it points to it

snoyberg commented 3 years ago

The book is broken into chapters. The quick start guide is linked in the previous chapter.

finlaydotb commented 3 years ago

Unfortunately the quick start guide is really essential that I believe it should not be buried in a "previous chapter". I think it will be nicer if it is linked in the side link, and also if the basic chapter mentions more explicitly that instructions listed in the quick start guide should have been executed...

and finally I would change the title from quick start guide into something more descriptive...ie something like setting up yesod, setting up development environment etc :)

snoyberg commented 3 years ago

PR welcome

On Fri, 13 Nov 2020 at 8:28 AM finlaydotb notifications@github.com wrote:

Unfortunately the quick start guide is really essential that I believe it should not be buried in a "previous chapter". I think it will be nicer if it is linked in the side link, and also if the basic chapter mentions more explicitly that instructions listed in the quick start guide should have been executed...

and finally I would change the title from quick start guide into something more descriptive...ie something like setting up yesod, setting up development environment etc :)

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/yesodweb/yesodweb.com-content/issues/256#issuecomment-726550598, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAAMCB2JP7LHF2K4KCRC45DSPTGZHANCNFSM4TP33X5Q .