Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve the Perl 6 from Node.js - Nutshell page #1968

Open
Kaiepi opened this issue Apr 26, 2018 · 5 comments
Open

Improve the Perl 6 from Node.js - Nutshell page #1968

Kaiepi opened this issue Apr 26, 2018 · 5 comments
Labels
docs Documentation issue (primary issue type) new part of "docs" - indicates that this documentation is for a new, currently undoc'd section update part of "docs" - indicates this is an update for an existing section; rewrite, clarification, etc. wishlist "nice to have" issues; might require a lot of work or a big change or be low priority

Comments

@Kaiepi
Copy link
Collaborator

Kaiepi commented Apr 26, 2018

Introduction

You might need to have a quick introduction to the language. This is as short as it gets. If you have any question about Perl 6, it's probably better to either take it to StackOverflow or ask in the IRC channel, which you can access from the web.

The language used for the documentation is called Perl6 pod. You can pretty much follow the conventions that you already see in the document, but that guide above might help you find whatever is not there.

We are talking about this page, which you can edit directly on the GitHub page by clicking on the pencil right above the butterfly (a.k.a Camelia); saving it will generate a pull request, or via forking, editing locally and doing a pull request in the usual way.

The problem

There are already a bunch of pages to help users experienced in other languages learn Perl 6, but none for Node.js. The two languages share some common aspects, but many of them behave completely differently, e.g. promises and timeouts .

Suggestions

Start by looking at the TBD at the bottom of the page. Then, when you feel comfortable, proceed to create other sections. Create a pull request as soon as you've done some significant amount of writing.

@AlexDaniel
Copy link
Member

Sure, yes! Can you start it?

@jnthn
Copy link
Contributor

jnthn commented Apr 26, 2018

Yes, Node.js users are certainly an interesting potential target audience for Perl 6, in so far as they're used to working with a dynamic language and doing async, and Perl 6 provides a more nuanced static/dynamic balance and a higher-level approach to async. Actually, the experience of building a bunch of microservices in Node.js was what motivated me to write Cro. :-)

Kaiepi added a commit to Kaiepi/doc that referenced this issue Apr 29, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue Apr 29, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 2, 2018
@JJ JJ added wishlist "nice to have" issues; might require a lot of work or a big change or be low priority new part of "docs" - indicates that this documentation is for a new, currently undoc'd section labels May 14, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 16, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 16, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 17, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 17, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 17, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 17, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 17, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 17, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 17, 2018
@JJ JJ closed this as completed in #1975 May 21, 2018
@JJ
Copy link
Contributor

JJ commented May 21, 2018

I'm changing the subject and reopening it, just in case someone (or @Kaiepi ) wants to continue working on this.

@JJ JJ reopened this May 21, 2018
@JJ JJ changed the title Adding a Perl 6 from Node.js - Nutshell page Improve the Perl 6 from Node.js - Nutshell page May 21, 2018
Kaiepi added a commit to Kaiepi/doc that referenced this issue May 22, 2018
@JJ JJ added Hacktoberfest docs Documentation issue (primary issue type) update part of "docs" - indicates this is an update for an existing section; rewrite, clarification, etc. labels Oct 4, 2018
@cfa
Copy link
Contributor

cfa commented Feb 12, 2019

Bumping this as there're still a number of TBDs on the page.

@Kaiepi
Copy link
Collaborator Author

Kaiepi commented Mar 2, 2019

I won't have much time to deal with the TBDs for the next few months with the grant but I'll see what I can do. If anyone else wants to help out that'd be a big help. Sorry for not seeing this sooner

@coke coke removed the Hacktoberfest label Mar 5, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation issue (primary issue type) new part of "docs" - indicates that this documentation is for a new, currently undoc'd section update part of "docs" - indicates this is an update for an existing section; rewrite, clarification, etc. wishlist "nice to have" issues; might require a lot of work or a big change or be low priority
Projects
None yet
Development

No branches or pull requests

6 participants