problem-solving icon indicating copy to clipboard operation
problem-solving copied to clipboard

Raku / Perl 6 books - CCR measures and beyond

Open 2colours opened this issue 3 years ago • 1 comments

Currently, I don't see a good, official-ish, up-to-date source for Raku books but such a list could be created based on the perl6book site and links at raku.org. The goal: provide an "officially" maintained, presentation-agnostic store for Raku books.

As mentioned in https://github.com/Raku/problem-solving/issues/347, lately I discovered the Raku / Perl 6 books site created by Moritz Lenz. I have mixed feelings about it, especially considering that it's linked at sites like raku.org and the to-be docs.raku.org.

  • the content is valuable, worth presenting AND maintaining
  • the presentation is off-putting (in my opinion), with inaccuracies (perl6org Twitter) on the way
  • +1: the domain perl6book seems unfortunate 3 years after the renaming

So far, I think this is a perfect setup for a collect-conserve-remaster scenario - however, I think having published learning materials always available and up-to-date even exceeds the usual scope of CCR.

I think we should set the goal to have an easily accesible, maintained, safe-to-advise source for Raku-related learning materials. In order to avoid the perl6book situation, this should be formal data without presentation:

  • no need to officially maintain a site or visual format, hence easier to keep up-to-date
  • there can be multiple presentations; moreover it's easy to replace a presentation / start over if a particular presentation turns unmaintained.

I consider this the "issue" itself - that's not to say it cannot be discussed or modified if others have a better idea. The technical details are considered a part of the solution.

2colours avatar Nov 01 '22 11:11 2colours

I think the content could live in another github repository. I don't feel strongly about the format; I'd think of a textual data serialization format, could be JSON, could even be XML given the document-ish nature of the content. Also, perhaps it could be hosted directly on the web some way, could be simply as a static file. It doesn't take more resources than hosting a site and it would allow sites to directly depend on the up-to-date content.

2colours avatar Nov 01 '22 12:11 2colours