Talk:New Developers/Flow

No, thanks. This page is for NEW developers. Also see phab:T176668.

I'm a bit surprised to find the MediaWiki project absent on this page. I assume there is a good reason for this; something like complexity, lack of mentoring or development documentation, or something else entirely.

But that doesn't mean that it shouldn't be mentioned, at the very least as an intermediate option, perhaps at the bottom of the list. We have a phabricator project good first task with things that new developers can do.

It also does not help that the page links to New Developers#Choose a software project on the same page, which does not list MediaWiki, but the next item, "Set up your development environment" is irrelevant for any of the mentioned projects! It focuses solely on MediaWiki.

@Mainframe98 "Frustrating new developers with a super complex codebase" sounds very different from "could be an option for intermediate developers". On a more serious note, see phab:T176668

@Mainframe98 Very much agree, it makes absolutely no sense to not even mention MediaWiki even though it's the core, main project and has a large backlog of open, even basic, issues and a severe lack of new developers.

Furthermore, it's that page that developers who actually happen to find and click on the "Developers" link at the bottom of Wikipedia pages rather than this making it even more important that MediaWiki should not only be mentioned but be at the very top of that page. No good rationale for not including that page has been given and I reopened that issue which was closed because of the opinion of one employee.

I disagree here, obviously. The MediaWiki core codebase is definitely NOT a place for *new* developers to advertise for starting with.

I think you have a conception of the "New Developers" page as a page for people to learn code development. However, that page is about developers new to M̶e̶d̶i̶a̶W̶i̶k̶i̶ (irrelevant I guess?) Wikipedia-related software development. Of those people only a fraction are new developers or not-yet-developers aspiring to become developers (many already are experienced devs). Partly because of that, I included the note "Development may be more difficult than with the projects below." in the card which could also state that the codebase is large and somewhat complex if you think people should be aware of that. In any case, new developers for MediaWiki is far more important than for any of the other projects and as MediaWiki is the core software behind Wikipedia and other projects it definitely should be on that page.

It is not a page for people to learn code development in general. It is a page for people who are absolutely new to code development in Wikimedia software projects, and especially MediaWiki Core is one of the most complex codebases around. Have you done MediaWiki core code development? "Importance" does not imply "a good place to start with".

How will MediaWiki development become easier if you code some niche C++ negligible side-project? Users can decide which of those projects they start with, the card says it's more complicated than the other projects, there's "good first tasks" and it may be exactly what experienced developers are looking for. A good place to start with MediaWiki development is MediaWiki development.

Further info at the phabricator task.

There is no good reason for this to remain decline because of 1 (one) employee's opinion even though I can somewhat better understand you now. I don't think you understood my reasons though. As this page is about New MediaWiki- & Wikipedia-related-software- Developers, no actual reasons have been submitted so far.

Listing MediaWiki Core here will not magically make its "development become easier", so the question unfortunately doesn't make much sense to me.

A good place to start with MediaWiki development is NOT MediaWiki Core development. Some well-written extensions with a clear scope, good documentation, good architecture, and active maintainers can be a good place to start though.

Do you know for sure that is all the case for MediaWiki core; do you know its codebase?

Some reasons have actually been provided; see phab:T176668. I don't know why you repeat writing that statement (and I don't know either how it's relevant if I'm some "employee" of something or not).

The question was just meant to illustrate why "Have you done MediaWiki core code development? "Importance" does not imply "a good place to start with"." is not addressing anything relevant. You keep going back to previous points and ignore what I'm saying maybe just calm a bit (not sure how you could even misunderstand it that way), have a good night of sleep and then read it again. I'll repeat it anyway:

However, that page is about developers new to M̶e̶d̶i̶a̶W̶i̶k̶i̶ (irrelevant I guess?) Wikipedia-related software development. Of those people only a fraction are new developers or not-yet-developers aspiring to become developers (many already are experienced devs). Partly because of that, I included the note "Development may be more difficult than with the projects below." A lot of the people may already be sufficiently experienced developers.

The inadequacy is even more apparent when outlining the process users come to this page: Wikipedia page->Developers->clicking "Choose a project" next to "Software development"->land on the "New Developers" page with not even a mention of the software that powers Wikipedia page.

Also that page doesn't even list a MediaWiki extension. And even if it did, that wouldn't remove the necessity to mention MediaWiki development.

-

Basically, if you want to learn swimming and go to a page linked as "How to swim" you'd like it to contain info about swimming, not about how to walk. Yes, sure it may be easier to learn how to walk in your opinion but maybe, for example, you already can swim.

I'm pretty calm, no need to worry. :) Given the scope of the page (developers new to Wikimedia) there is no "necessity to mention MediaWiki development": the page is intentionally not listing all and any hundreds of Wikimedia software projects as most of them (such as MediaWiki core) are not well-suited for new developers.

Did you check New Developers/Featured Projects and can you explain why you think that the mentioned criteria is fulfilled by MediaWiki core? Because I don't.

And asking another time: Have you done any MediaWiki core code development?

Okay, great. Nevertheless, I don't think you considered the points I made or addressed them.

There is a necessity because that page is about new MediaWiki developers (as well as the Wikipedia app and some less important side-projects). Even if it was the most difficult thing to do, which it isn't, it should still be included there.

So apparently, as you ignore my points and in your opinion apparently that page should be about onboarding new developers to hire so that they later professionally work on other projects (MediaWiki) rather than volunteer-developers to directly work on MediaWiki (new MediaWiki developers) the only option is to change the page that links to it (and the point about the context of that page is one of those you keep ignoring).

To adapt the metaphor above: If you insist on learning swimming in stormy waters without help (like MediaWiki core), then How to become a MediaWiki hacker is the page you're looking for. If you want to learn swimming in calm waters with some help, then New Developers is the page you're looking for.

I don't think that I ignored your points, however there might be a bit of irony as you repeatedly chose not to answer my questions and as you again put words in my mouth I've never written, for example that I'd think the "page should be about onboarding new developers to hire".

If I understand correctly, you either think or wish that MediaWiki Core is or would be a good place to start for new developers in Wikimedia, I told you that it is not and I tried to explain what is [not] the scope and target group of the New Developers page, you haven't answered why MediaWiki Core would be a codebase to add to the New Developers page based on the criteria to be a project listed on the New Developers page, and you have not worked with the MediaWiki Core codebase...

As said if a) the page is linked as (and here also titled as) "How to swim in stormy waters" b) people are warned about it being stormy (and in many cases that's exactly what they are looking for and capable of) and c) doing so is important because there's currently a triathlon with swimming in that water (not that MW development currently is a "competition" but it's on-topic and what people seek), that is still required.

"New Developers" is also about new MediaWiki developers plus that page is linked as the main way to help with Software development in the context of Wikipedia.

With that "page should be about onboarding new developers" I meant to show you what my impression so far is. This is what it appears to me currently. Is that not the case? If so please address my points and clarify what you mean with "new developers in Wikimedia".

Yes, it is one of the good places at the very least. Even if it is very difficult. Plus it won't become easier if devs work on other C++ projects (btw unlike MediaWiki development which would become easier in time if they don't waste time with other projects if they only want to work on the software behind Wikipedia, are experienced devs, start with "good first tasks" and learn well by doing – if they develop MW they'd have to start doing so anyhow and as said developing unrelated projects won't make it easier) so your point doesn't even make sense (except if the page is about onboarding devs for hiring them which is why this is how it currently appears to me). I know you're one of the most active devs and people owe you a lot and MediaWiki development may be very difficult and the current criteria may not match the MediaWiki addition, nevertheless you didn't address the explanations and it should still be there or the link to that page moved down from where it is linked.

To point out only one of the wrong assumptions in the last comment: I am not one of the "most active devs", and it looks like we're running in circles as my questions are intentionally ignored. I'll turn to things that look like a more constructive use of time.

Good First Tasks is more than half given to Mediawiki core + extensions.

And "How to become a Mediawiki hacker" is listed on the page. So it is mentioned, and easy for any interested visitor to find.

I could see making it (and 'good first tasks' generally) a bit more prominent.

The whole Wiki project is centered around MediaWiki on its core. It should be somewhere under "Choose a software project", if necessary with some disclaimer that it may be more difficult than the, largely niche, side-projects listed there. It would be less confusing and easier to spot or come across if it was there. Re it being for *New* developers: the page doesn't suggest it's meant to be for people who just learned coding rather it seems to be for potential new people for the volunteer Wiki developers. Not adding a proper tile including a screenshot for MediaWiki – the key core software with tons of open basic issues like viewable tables on mobile – isn't a good idea and it hasn't been much discussed so far. Thus I hoped a discussion would take place here but it was just the more or less two-people internal discussion that took place earlier at the phab issue. Thinking of a temporary fix via small screenshot.

No. See previous arguments.

This is an idea, but what about supporting the open source program called "Language tool" in the editor? It is actively developed and might improve grammar on wikipedia:

https://languagetool.org/de/, https://github.com/languagetool-org/languagetool

Hi @Biggerj1, please see https://www.mediawiki.org/wiki/How_to_report_a_bug as this page is not for idea collection. Thanks!

There was some work on that idea a few years ago. But it needs a new developer to actually make any progress. (I.e. It's on the gigantic list of things we all wish someone would work on. Volunteers appreciated, if you are or know any devs who could do it!). See Extension:LanguageTool and phab:T89107 for more info.

However it is certainly not in a good state to be listed on this page. Criteria for being listed on this page is given at New Developers/Featured Projects. Hope that helps.

Off-topic

Dear Admins, I want to say about easily developing media-wiki. Whereas media-wiki is quite different from other wikis and other wiki is quitely depends on media wiki, so then we should add some more function on it, such as spell checker. Secondly we should invite the media wiki contributors for developing content. Thank you

@Md Tanbir Islam Hi, this page is for new developers, it is not for proposing code changes. Spell checkers are commonly provided by web browsers. Anyone is free and welcome to develop content or code - feel free to do so. PS: we are not "admins" here. :)

just like Reddit /stackexchange or Extension:Comments

See the answer that you already received on User talk:Ciencia Al Poder#Regarding integration of Extension:VoteNY and 'Flow'. Please don't ask the same thing on several pages. See How to become a MediaWiki hacker how you can start development.

All is marked for translation.

Hello, @Ameisenigel!

I'm asking for making some lines on this page translatable, this is, lines №№ 22-24, and 35. Thank you!

In addition: also, lines №№ 33 (after </translate> tag), and 133-146.

I have marked the page for translation.

@Ameisenigel, thank you! There is one more paragraph not marked for translation: lines №№ 33 (after tag), and 133-146. (I wrote an additional comment about it above).

Is there still something missing?

No, all is done. Thank you so much!

It looks like some of this has been addressed in previous discussions but whatever.

I just really don't like the "Choose a software project" section and the page. It makes it seem as if those are the only projects you can contribute to. The section should probably be renamed to "Featured projects".

Something the page doesn't handle well is helping developers who want to contribute to Wikimedia projects like Mediawiki Core or one of the sister projects like Wikidata or Commons and their tools. This page doesn't give them any information on how to do that. I think this is really important because on the Main page the link for "Start coding for a Wikimedia project" literally goes to this page and developers should anticipate to learn about Wikimedia projects they can start contributing to.

Also, some of the projects listed do not use a programming language or framework the developer is familiar with so they will likely consider not contributing to them.

I think we need to organize the page in a way that gives a much broader and in-depth overview of all the projects you can contribute to across Wikimedia so that users can find what they're looking for or something to work on.

I think How to contribute may be more aligned with your ideas for broad introductions to the Wikimedia FOSS ecosystem than this page.

@BDavis (WMF) Okay, then shouldn't the "Start coding for a Wikimedia project" on the Main Page link there instead?

The link is intended to target folks who are just starting their journey into Free and Open Source software development and looking for a guided path. Terse bullet lists are not ideal for providing deeper context, but on How to become a MediaWiki hacker (which is the 3rd bullet point on the Main Page 'Develop and extend code' section) we explain a bit better I think with "The main path to get started with Wikimedia development is to contribute to Wikimedia projects that offer mentoring." Maybe we should be talking about how to better phrase "Start coding for a Wikimedia project" to help set expectations of the linked content?

You may also find a review of MediaWiki/Homepage improvements 2018 and Talk:MediaWiki/Homepage improvements 2018 to be helpful in understanding why certain links were prioritized over others at the time of the last major overhaul of the Main Page.

Agree with this and the MediaWiki project (that is MediaWiki core) should have a special, highly visible place there:

It's linked at the MediaWiki-wiki-page and from the bottom of pages that run on MediaWiki like Wikipedia (bottom of the page Developers->Choose a project lead to here). Developers would anticipate to at least also learn about the MediaWiki project they can start contributing to. Instead of a dedicated tile for it at the very top, there's only a small link buried under "Additional resources".

This needs to be fixed asap WMF! And somebody should undo this revert for the above reasons. The rationale given at the revert is invalid also because of the above reasons, because "New Developers" doesn't necessarily refer to people new to coding but to people new to coding MediaWiki and Wikimedia projects, because it's important to include no matter the difficulty, and because there are many first good tasks even for MediaWiki core. I'd like to avoid reverting it myself / readding MediaWiki core and I explained this many times already.

Yep. Totally think MediaWiki Core needs to be on this page in some form.

"New Developer" shouldn't mean people who are just learning how to code. In fact, I really don't think any Wikimedia development project is suitable for a beginner developer. We do not have the documentation present on this site and projects simple enough for completely new developers to even think about contributing to without learning 5+ other technologies (Git, Docker/Vagrant, Node.JS, PHP, etc.)

Instead, we should think of "New developers" as people who have coding experience with a little or a lot of experience and are willing to learn new technologies according to their experience. I'm a "New Developer" myself and I picked up how Core and PHP works over the course of 3-5 days without ever working with them before. MediaWiki is suitable for me as a "New Developer" because I have 5+ years of coding experience and can understand the project and language structure of MediaWiki and PHP because I have worked with projects and languages similar to them before.

"The following projects offer resources, mentorship, and are looking for new developers to contribute to them." -- this is why MediaWiki core is not listed on this page. I empathize with folks like @Prototyperspective and @Lectrician1 who would like this to be different, but it is not. We have asked many times in many ways over the last 6 years for one or more Foundation teams involved in MediaWiki core to provide support for new contributors. There is nobody doing this work now and to our knowledge nobody planning to do it in the future.

Is it possible for a user to edit without being fully authorised

Yes, though it highly depends on what you mean by "edit" (and what to edit) and "authorised".

This is a wonderful initiative and I have shared it on the Africa Wikimedia Developers Facebook Page and will keep sharing it on various media to help new developers :).