Page MenuHomePhabricator

Create a "my first React app" tutorial for Toolforge
Open, In Progress, MediumPublic

Description

For this task, you need to be able to express yourself in English and spell correctly. (A few typos are still okay, of course!) :)

This task consists of two subtasks:

Background

React seems to be so popular these days and choice of many developers! Two of our GSoC developers expressed the challenges they faced due to lack of documentation around hosting a React app in Toolforge: https://discourse-mediawiki.wmflabs.org/t/help-to-host-react-apps-in-toolforge/1411/17. I'm wondering if a tutorial similar to the ones listed in the See also section below would make sense or help.

See also

Event Timeline

@Rammanojpotla documented the steps (link coming soon!) followed to host WikiContrib (a React app) on Toolforge.

If a tutorial on this topic makes sense, then it could be made a Google-Code-in-2019 task!

I think this would be in line with ongoing documentation improvements to Toolforge.

A related task would be looking for gaps in tutorials and creating Phab tasks or stubs for them, or gathering real developer stories/experience as examples (this is an ask that comes up frequently).

The "how-to" page could use many more examples: https://wikitech.wikimedia.org/wiki/Help:Toolforge/How_to

@Rammanojpotla documented the steps (link coming soon!) followed to host WikiContrib (a React app) on Toolforge.

If a tutorial on this topic makes sense, then it could be made a Google-Code-in-2019 task!

@srishakatux The document is currently hosted here. If this task is included in Google-Code-in-2019, I would like to mentor this :)

How can I request this activity??

@Ajuanca I'm not sure what you mean by requesting the activity. Could you explain?

taavi triaged this task as Medium priority.Wed, Feb 18, 3:13 PM
Hugoa changed the task status from Open to In Progress.Wed, Feb 25, 5:12 PM

Hi! Here is a first version of the tutorial: https://wikitech.wikimedia.org/wiki/User:Hugoa-wikis/My_first_React_application
I tried to keep things consistent with the other tutorials (Flask and NodeJS). Let me know what you think :)

As a side note, I faced some issues while running the Flask and NodeJS tutorials:

  • Flask: minor quotes issue that made things crash
  • NodeJS: I think newer versions of some package broke the provided code

I fixed/provided a workaround for both, so that we can follow the tutorials without getting errors.
I don't know if there were tasks related to that, so I'm mentioning it here, just in case.