💫 Additional Async Transition Documentation

announce
1

Good news everyone!

Pasted image 20231030164358

TL;DR: I’ve worked on a first version of a more fully featured version of the Async Transition guide.

Please have a look & please post lots of feedback! With the link it’s also possible to add comments in the document itself.

Here it is: How to convert your existing Meteor App to ASYNC & Prepare for Meteor 3.0 - Google Docs

Note: THIS IS A WORK IN PROGRESS - I’m not done with this (and neither are you!) :smile:

This is meant to be a first impression & a call for feedback & support.

Please speak your mind freely (this goes for all of you except for you @harry97 ! :stuck_out_tongue:) & please let me know

  • Whether you like the format so far
  • What you’d like to have included
  • What you’d like to have changed

I’ve also created a slack channel for discussions of the transition guide: #async-transition-documentation

I wanted to get it done now because there are multiple parallel attempts at this and I thought it might be good to coordinate ourselves to avoid unnecessary duplication of effort.

Q: Why a google doc?
A: Because I felt like time would be of the essence & I wanted to get this out the door ASAP. Also because I hope it allows more people to cooperate together on this document going forward, I think the barrier to entry is much lower than creating PRs on the Meteor Guide.

Would you like to help out?

  • a) I think this could still use a lot of love & effort - if you are or know a talented technical writer, it’d be great to either get some input or just HELP in fixing this up & updating this as we go! It’s really surprising to me how much time this took me already, so i’d really be happy about all helping hands!
  • b) Reach out to me here or on slack or wherever & I’ll drop you an edit link so you can go to town on this yourself! :smile:

Please everybody, especially also @grubba and @denyhs, who are already involved in documenting this, I’d really be happy to discuss with you how to move this forward.

Please share this post far and wide if you can so we can organise around creating a really helpful migration guide for as many Meteor users as possible!

16 Likes
2

Amazing initiative @DanielDornhardt! You certainly have the support of the core team on this.

I’ll add this to my backlog so I can read it and give it a review, and I’m sending this to the core team and asking them to check it out. Maybe we can help to find a technical writer as well.

2 Likes
3

Ok, so I’ve given the document a read but sadly I couldn’t contribute much because I’ve not tried to migrate any Meteor applications yet. :man_shrugging:

This is a friendly ping for others to give it a read, I’ve only seen @rjdavid and @scharf .
cc @storyteller @radekmie @denyhs @grubba @jkuester @dr.dimitru @copleykj

1 Like
4

Hi guys, and thank you @harry97 for the push!

Just a small note that this is still very much a rough draft… coming week I hope I’ll clean it up some more & take into consideration the first remarks I got.

I think the goal for this doc would be to keep it updated as new information arrives & the migration target clarifies, so people taking the could always find an up-to-date picture of the current situation.

I’m also gonna try and take out the worst jokes… :stuck_out_tongue: it was pretty much a stream-of-consciousness approach to write down as much as I could in the time I had available.

Thank you for any feedback and I’m also willing to pass our edit links for any interested parties, so let me know if you’re interested!

Best & have a weekend everyone! :slight_smile:

2 Likes