Raku / problem-solving

🦋 Problem Solving, a repo for handling problems that require review, deliberation and possibly debate
Artistic License 2.0
70 stars 16 forks source link

Raku / Perl 6 books - CCR measures and beyond #349

Open 2colours opened 2 years ago

2colours commented 2 years ago

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.

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:

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 commented 2 years ago

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.