2022-05-12 Meeting notes

30min

Team Roadmap

Ildikó

• Entry points to the community

  • Document the processes

    • Workflow to contribute code and related items

    • Non-developer type contributions

  • Make the documentation visible

    • Information on the website

    • Use social media

    • Starter tasks - mark and highlight them

      • https://github.com/magma/magma/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22 

  • Where to get help?

    • Next step is to identify the channels where people can get help and make them visible! 

    • Question topics

      • Platform and deployment related questions

      • Contribution related questions

    • Communication channel(s)

      • GH Discussions

      • Slack

  • Video content for newcomers

    • Discussed on April 14, see meeting notes!

• Attracting new contributors and increase retention

  • Low-hanging fruit tasks

  • Clear path towards leadership roles

  • Clear and simple processes

  • Contributor attribution related ideas

• Metrics

  • How to measure success?

  • How to identify bottlenecks?

• Mentoring

  • Participate in existing programs

  • Host interns at MCF

• Other ideas?

• Priorities

  • How to turn people who are asking about Magma and experimenting with it/using it into active contributors?

    • ie: FreedomFi is using Magma on large scale and they are also contributing back

    • How to find more companies and organizations who can contribute back?

    • Deployer feedback form: TSC Magma Commercial Deployer Feedback

      • Building a list of companies who are using and deploying Magma

      • Stage 2 is to work with them and help them contribute back

        • → Think about how our group can help with this effort and have new contributors joining as an outcome

      • Steps

        • Check with Wavelabs if they are getting any feedback on their info sharing sessions that they periodically have → also see how we can use those sessions to encourage people to contribute?

        • Provide the TSC with pointers to onboarding materials and work with them and new contributors to improve these materials on the way

  • How to make the onboarding materials and processes more accessible to companies?

    • Contributor guide for organizations

  • Build a task list that people can work on

  • Consider using this call as a working call

  • AP (Ildiko): Create GitHub issues for the outstanding Contributor Guide tasks!!

    • Describe the issue and the target state!

    • Add labels: 'component: docs', 'good first issue' - if applicable

      • https://github.com/magma/magma/labels/

15min

Contributor Guide updates

Ildikó

• Updates on the DCO process

  • → merged and done

• The Docusaurus needs to be fully cleaned up

  • Issue: https://github.com/magma/magma/issues/12707 

  • TSC norms:

    • Should this be in the contributor guide or is there any other TSC-related docs this should be moved to? 

    • https://github.com/magma/magma/blob/master/docs/readmes/contributing/contribute_tsc_norms.md

  • Feature proposal process is in two places currently

    • Is the content ready to be deleted from the Docusaurus? 

    • https://github.com/magma/magma/wiki/Adding-and-Tracking-Proposals

    • https://github.com/magma/magma/blob/master/docs/readmes/contributing/contribute_proposals.md

  • Codeowners Workflow

    • https://github.com/magma/magma/blob/master/docs/readmes/contributing/contribute_codeowners.md

  • Docusaurus needs to be reviewed for any "leftovers", including earlier versions

    • https://github.com/magma/magma/tree/master/docs/readmes/contributing

    • Any other places with relevant content to move?

• Need to clean up the community repo: https://github.com/magma/community/blob/main/CONTRIBUTING.md

• Point to the Governance repo for charter docs and details on the TSC: https://github.com/magma/Governance/blob/main/CHARTER.md

  • Issue: https://github.com/magma/magma/issues/12706

• Tracking and fixing bugs section still needs content

  • Issue: https://github.com/magma/magma/issues/12705

• Community repo cleanup

  • Issue: https://github.com/magma/magma/issues/12708

5min

Events

All

• Open Infra Summit

  • Shubham is giving a presentation about how to deploy Magma in a lab environment

    • Talk is focused on the deployment steps

    • Have one slide with content regarding how to get in touch with the project and where to start contributing would be very helpful!

10min

AoB

All

• How to improve contributor experience on the technical side?

  • ie: How to get the first build done? - Documentation seems a bit tangled up

    • Next step - Create a ticket and add 'component: docs' label!