Link to "A coder's guide to answer set programming" from README.md

[madmike200590]

I've recently gotten around to get started on my "side-side-"project of writing a beginner-friendly guide on ASP and have been publishing my results via github pages here. The guide is still very much a work in progress and is going to grow significantly, both in terms of quantity as well as quality, but I think the tutorial as it is now might already be useful.

I'd like to reference the guide from Alpha's README.md in order to give people an easily digestible starting point for learning ASP.

[codecov[bot]]

Codecov Report

Merging #344 (482ca92) into master (e0d4705) will not change coverage. The diff coverage is n/a.

@@            Coverage Diff            @@
##             master     #344   +/-   ##
=========================================
  Coverage     70.77%   70.77%           
  Complexity     2150     2150           
=========================================
  Files           182      182           
  Lines          8025     8025           
  Branches       1424     1424           
=========================================
  Hits           5680     5680           
  Misses         1970     1970           
  Partials        375      375           

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[AntoniusW]

@madmike200590 The guide is a great addition! Is there a way to comment on the guide or suggest changes to it?

[lorenzleutgeb]

Great idea!

Is there a way to comment on the guide or suggest changes to it?

@AntoniusW I guess you could open a PR at https://github.com/madmike200590/asp-guide :)

I thought about doing something similar, but to use something like an "interactive notebook" for examples. Like a Jupyter Notebook, or Nextjournal where the "code cells" contain ASP code that evaluates to answer sets. The user could then (right on the website) modify the code cell and see how that changes the output. Going even further, one could visualize the in-/output, e.g. color a graph. Lots of work, but cool! :)

[madmike200590]

@madmike200590 The guide is a great addition! Is there a way to comment on the guide or suggest changes to it?

Yes, exactly like @lorenzleutgeb said, just make a fork of https://github.com/madmike200590/asp-guide, edit the markdown sources and open a PR. The deployment as github page is configured in the repo settings, so you can have your fork deployed to a separate URL as well for preview and testing. Github pages in the simplest config has jekyll behind it for html generation. I'll probably switch that over to mdBook at some point, but wanted to stay with the most straightforward option for the beginning.

[AntoniusW]

Thank you for pointing me in the right direction, @lorenzleutgeb and @madmike200590.