Closed bph closed 10 months ago
Hello @bph,
Thank you for creating the issue! I'm happy the article is moving forward. I know Adam is now on holidays, so if you can assign the issue to me, I will work on any required change on the article 😄.
Thank you @Angelmmiguel for taking this on.
Here are a few tips and.guidlines for writers on the Developer Blog.
On the page, How to contribute you'll find an outline of our processes.
Feel free to connect any time with questions, moving forward with the article.
Thank you for being prepared to contribute! 🥰
Hello @bph,
Thank you for the guidance! I took a look at the links you shared to understand better the process and writing guidelines. Adam, @ereslibre and myself already wrote a first draft for the article. Today, I took a second review based on the guidelines you shared.
I believe the article is ready for a first review 🎉. You can find the proposal in this Google Docs link: https://docs.google.com/document/d/1w2hwx5TybnyaM205rbAVyoSNehtYG4ZJ3Y-xWzirLv0/edit?usp=sharing.
Also, feel free to ask me for any required step I may missed in the process.
Thank you!
@Angelmmiguel What's your WordPress.org user name? We would need it to invite you to the blog as author, so you can post the article after the 1st review... if you don't have an account yet, you can create one here, I believe
And here are instructions to connect your GitHub account to your WordPress.org account.
Thank you for the reference @bph. I just created my account (angelmmiguel) and linked it to my GitHub account.
Hello @bph,
Since I'll be on PTO, @ereslibre will take over this issue to apply any feedback on the article. He's an author of this article too, so he's aware of all the content 😄.
He already created a WordPress.org account and linked it to GitHub. His user is ereslibre
.
Thank you!
Thank you @Angelmmiguel so much for keeping an eye on this issue and initiating a handover.
Welcome @ereslibre - we will get some more eyes on this post next week after the WordPress 6.3 RC is out.
Hello @bph,
It's fantastic to be here, thank you! I'm super excited about this blog post.
Thank you
@ereslibre Rafael, I just added you as author to the Dev Blog: "Invitation email sent to user. A confirmation link must be clicked for them to be added to your site."
And I did a first review of the post mainly changing formatting
Also, marked a couple of places we need to revisit regarding our external link policy. (YouTube, personal blogs, 3rd party products)
@marybaum when you get time would you please review the post, too?
Thank you @bph. I have accepted the invitation. Thanks for the formatting changes upon the first review.
I am happy to take action on whatever is needed. 👏
Hello @bph, just double checking. I accepted the invitation, but when logging in I am not able to see the blog post among the others. Am I supposed to be able to see it already? Thank you.
Ah, I should have checked. Are you familiar with WordPress as content creation tool? We invite our writers to post their article themselves, make sure the post looks good before publishing add alt text to images, an excerpt. Etc and have a 2nd review on site before publishing.
The task getting the article published was passed on from a WordPress contributor to outside contributors made for some leaky communication. Sorry about that.
Let's wait for the next step (= posting it to the site) until @marybaum has time to do a copy review via Google docs.
Afterwards I'd be happy to post the article for you.
My apologies, didn't see your comments and suggestions on the Google doc. I have addressed all of them I believe. Thanks :)
Are you familiar with WordPress as content creation tool?
Yes, I have used it in the past.
Thanks for the context and information. If I got it right, we wait until Mary has done a copy review via Google docs, I address all the issues over there, and then start a draft on the Wordpress platform. Then, when it is good to go, you will perform the final publishing to the world. Is this accurate?
Thanks again.
Can someone open up the Google Doc for comments? This will let us review it. Thanks!
Can someone open up the Google Doc for comments? This will let us review it
The linked document here should be open for comments from anyone. Please, let me know if that's not the case. I tried with an incognito session and it worked as expected.
Edit: Note, I just realized that the link on the top-most comment is a different one.
Ah, got it. Yes, I was trying to open the one in the first post. The second link is open for comments. Thanks, @ereslibre.
I gave this a quick round of copyediting and left a few suggestions/comments.
Because this post is quite text-heavy, I'd look at ways of incorporating some images into it just to help break things up and capture the reader's imagination a bit more. For example, one image that you could definitely add is of WP Playground in action.
Thank you for your review @justintadlock! I addressed all your feedback.
Because this post is quite text-heavy, I'd look at ways of incorporating some images into it just to help break things up and capture the reader's imagination a bit more. For example, one image that you could definitely add is of WP Playground in action.
This is a great idea. Do you prefer to handle this while we move the content to WordPress and layout there, or do you prefer to layout and add this extra content on the collaborative document itself?
This is a great idea. Do you prefer to handle this while we move the content to WordPress and layout there, or do you prefer to layout and add this extra content on the collaborative document itself?
It'd be fine to add them in the post editor at this point. But in general, it's best to add them into Google Docs as part of the initial review process.
This is a great idea. Do you prefer to handle this while we move the content to WordPress and layout there, or do you prefer to layout and add this extra content on the collaborative document itself?
It'd be fine to add them in the post editor at this point. But in general, it's best to add them into Google Docs as part of the initial review process.
Thanks for the suggestion @justintadlock. I will add the new images to the post. I agree the article is text-heavy, so I'll try to find more opportunities to add visual resources 😄
Hello @bph @justintadlock,
I was about to start moving the content to the WordPress blog for a final review and publishing. I believe I don't have the "author" role in WordPress.org as I couldn't create a new draft. My username is angelmmiguel
.
Thank you!
Let me see if I can get that handled for you.
I sent over an invite. You should see it for the email address you use for WordPress.org.
I got it! Thank you very much 😄
Hello 👋 ,
We finally introduced some images and updated some styles in the article. I saved it as a draft, so you can check it on the WordPress Developer blog. I believe we're ready for the final review @bph @justintadlock 😄.
I have a question regarding the authors. I created the article, but Adam and Rafael are co-authors. How can I add them to the article?
Thank you very much for all your help and guidance here!
Thank you @Angelmmiguel for posting a draft. I enabled 'public post preview' link You can give props to the co-authors and reviewers in a props section on the bottom of the article.
I will be able to review it further next week.
For reviewers and writers alike:
On it! Doing my editing at Contributor Day. #WCUS
Thank you all! From my side:
I seemed to have missed this before, but there's a blockquote just before the "Conclusions" section:
WebAssembly provides a few well-defined features to support maximum flexibility and an incredibly large number of environments.
Who is this quote from?
If this is not a quote and meant to be a note/highlight/tip/etc., this should use the Notice block instead.
I seemed to have missed this before, but there's a blockquote just before the "Conclusions" section:
WebAssembly provides a few well-defined features to support maximum flexibility and an incredibly large number of environments.
Who is this quote from?
If this is not a quote and meant to be a note/highlight/tip/etc., this should use the Notice block instead.
Hey @justintadlock,
Yes, this is a highlight we added when reviewing the article. Thank you for the feedback, I've just updated it to a "Notice Block" 😄
I just returned from my sabbatical and it’s great to see such an amazing collaboration here. Great job everyone 🙌
Welcome back @adamziel :-)
Hope you had a wonderful sabbatical @adamziel ! Welcome back :)
Welcome @adamziel! 👏 Hope you enjoyed your sabbatical :)
Discussed in https://github.com/WordPress/developer-blog-content/discussions/135