Topic on Talk:New Developers/Featured Projects

Featured project landing page, TCG, CoC

6
Qgil-WMF (talkcontribs)

One of the problems newcomers face is that useful information are all widespread and lacks basic consistency. I think it will be easier to engage newcomers if we organize our end better. A starting point is to expect that all Featured Projects will have a landing page with the basic project information in MediaWiki.org. Full stop. Once this landing page is in place, then they can have the rest of their information wherever they prefer, in the way it pleases to them.

I have checked the Technical Collaboration Guidance for guidance about how this project info page should be, but didn't find anything specific. I have asked / proposed.

By the way, I think that willingness to follow the TCG best practices could be a requirement for Featured Project. This is how we connect all the good stuff we are working on.

Explicit adoption of the Code of Conduct is another possibility (useful to promote the CoC among newcomers, also to make clear that even if some project infrastructure is out of the Wikimedia scope (GitHub etc), the CoC still applies there by decision of the project maintainers.

Consistent project info, TCG expectations and CoC adoption for all Featured Projects should help offering a better landing for newcomers.

AKlapper (WMF) (talkcontribs)

TCG and CoC are helpful but we'd recommend or require them anyway in software development / the community. Feel free to link to them under "See Also" if you feel like?

AKlapper (WMF) (talkcontribs)

Once we list projects on a page for potential contributors I don't think the landing page with basic project information must be on MediaWiki.org. If folks prefer to put such info on GitHub they are free to do so IMHO. Or that very information will be already included on the "overview of featured projects" page, which will be on mediawiki.org anyway...?

Qgil-WMF (talkcontribs)
Qgil-WMF (talkcontribs)

"Documentation for developers and users is in place and linked from a visible place". Here again we could be more precise with a requirement. That visible place is the landing page.

In fact, with all these instructions we are already providing an implicit structure to the project landing page. It needs:

  • a basic project description
  • mentors identified
  • link to microtasks
  • link to developer documentation
  • (link to) roadmap
AKlapper (WMF) (talkcontribs)

Ah, interesting. By "documentation" I had more or less "dev docs" in mind but you've got a point. Done.

Reply to "Featured project landing page, TCG, CoC"