9 Sep 2022
stevied what I'd really like to do is be able to generate the docs that are suitable for use as an ebook and sell it and donate proceeds to raku 16:17
it's nice to be able to markup the document with my pencil and take notes on it 16:19
[Coke] We did have the 'build a giant page' working years ago, but it fell into disrepair. Getting an ebook-ready format is in the backlog. If you'd like to take that on, more power to you. 16:20
I suspect you'd be better off doing it using a similar build mechanism (but different render target) rather than trying to render a single page and then converting that to an e-book, but I don't know for sure 16:21
anyway, welcome !
stevied I would like to take it on but I'm probably in over my head and would have to spend months on the project
[Coke] Join the club. :)
stevied the giant page feature does work, for the most part. it's usable when running on a server. Then I printed it to a PDF and added it to Apple's Books app. It works. But many of the links are now broken. 16:23
it's still better than nothing, though 16:24
I also exported to .epub and opened with an open source piece of software call calibre, but that's less usable. 16:25
the .epub version did not open at all on the apple books app. and when I tried to send it to my kindle device on my mac, it choked for some reason and didn't work.
by the way, the docs are 939 pages, not including the index on the left. with the index it's 1001 pages long 16:32
the index is the list of hyperlinks on the left hand side that links to each section of the doc 16:34
so what was the idea behind hub.docker.com/r/jjmerelo/perl6-doc? 16:57
when I run that container, I'm seeing docs from 3 years ago 16:58
sena_kun well, it gives you the Dockerfile you can build on your own?
that's if you want the old website
you can take a look at github.com/Altai-man/docs.raku.org/ 16:59
stevied ok, interesting. thanks 17:20
lizmat hmmm.. now that we have a raku-duc channel, maybe Geth should post commits etc here as well as on #raku ? 17:24
ok, commits to the doc repo will now also be reported here... please let me know if you *do* feel this to be inconvenient 17:30
[Coke] lizmat++ 17:35
sena_kun++ 17:49
10 Sep 2022
Geth doc: 7fa39b2044 | (Tom Browder)++ (committed using GitHub Web editor) | doc/Language/filename-extensions.pod6
Remove formatting from table until it works
21 Sep 2022
Nemokosch Hello 21:33
Browsing raku.org, I found this link of the "perl6-workshops" mailing list: groups.google.com/g/perl6-workshops?hl=en 21:34
It seems it cannot be accessed (not without some explicitly granted permission at least). Can I remove it? 21:35
[Coke] Seems reasonable to hide the obscure lists. 22:54
thanks 22:55
23 Sep 2022
Nemokosch Oops, apparently there is a #raku-docs channel when only SmokeMachine and I were 19:45
So yes... I wanted to ask another thing. Are there plans to move raku.org over to CIAvash's site, as of github.com/Raku/problem-solving/issues/158 ? If not - would it make sense for me to upgrade Bootstrap on that site? 21:10
patrickb exit 21:19
Nemokosch what does that mean? 21:26
24 Sep 2022
patrickb It means I confused a terminal window with the IRC window before going to bed. :-P 07:33
Nemokosch: We currently have no one feeling responsible for the websites. So no, there is no strategic plan for the sites. Work on improving them is appreciated. I guess the only requirement before making a (lager) change is giving enough time for potential feedback. So just go ahead, make a PR, ping lizmat so the PR ends up in the weekly, then merge it after two weeks time or earlier if you got respective positive feedback. 07:39
25 Sep 2022
Nemokosch patrickb: yes, I had this feeling that the main burder is currently the lack of management 12:01
Oh one more thing I wanted to say... I think it's essential to know what you are working on isn't set to become useless within a few months. I can collect ideas about the content of raku.org and that can last - however, I can't work on refurbishment without knowing the site itself won't get replaced to something else. The same way I think CIAvash deserves feedback on their site that they created years ago, with the intention o 12:44
g" it to raku.org.
26 Sep 2022
[Coke] team, I've been tied up with some personal items the past few weeks, apologies. I expect to spend more time on documentation items in the next four weeks. I think our main item is still getting the new site provisioned with devops, will (re?) start that thread this week 13:05
also, my home internet is VERY intermittent lately; hopefully will be resolved later this week 13:06
27 Sep 2022
Nemokosch Coke++ 23:07
29 Sep 2022
Geth doc/m-dango-patch-1: 46a7298394 | (Daniel Mita)++ (committed using GitHub Web editor) | doc/Language/syntax.pod6
Modify embedded comments documentation
doc: m-dango++ created pull request #4111:
Modify embedded comments documentation
[Coke] saw a patch in #raku for doc but not here? (Guessing it's my flaky internet) 12:46
Geth doc: c9cbe0fa58 | (Daniel Mita)++ (committed using GitHub Web editor) | doc/Language/syntax.pod6
Modify embedded comments documentation (#4111)