Problem/Motivation/Idea

There have been some comments for improvements.

Proposed resolution

List improvements here:

  1. Anti-gaming tips: https://www.drupal.org/project/icontact_integration/issues/3297388#comme...
  2. Add example event details
  3. Add qualifications for mentors to the documentation rather than just the event page: https://www.drupal.org/community/events/drupal-10-global-porting-day-aug...
  4. Great example of issue comments: https://www.drupal.org/project/features/issues/3297177#comment-14669258
  5. Simplify per slack feedback (see comments below)

Remaining tasks

  1. Finish updating list
  2. Make child issues as necessary
  3. Update docs
  4. Review

Comments

Kristen Pol created an issue. See original summary.

Kristen Pol’s picture

Note for the anti-gaming tips, having a clearer issue summary as to what to do for testing and what shouldn't be added as screenshots might be a good way to go.

Kristen Pol credited FeyP.

Kristen Pol’s picture

From @gambry in Slack:

It was well prepared and organised. It’s clear we’ve all improved.

The only comment I have to make is documentation got harder and harder while getting closer to the event. From two original documentation pages back in July, now we have five of them.

Also the pages are interlinked. For example to understand how to setup locally you go:

  1. Setting up Drupal 9 and Drupal 10 development environments
  2. which at the end then links to Getting started at Drupal 10 Global Porting Day#contribution paths
  3. where you can chose either Manually testing Drupal 10 compatibility patches or Creating or updating compatibility patches with Composer and DDev

Due last minutes additions, some paragraphs don’t make much sense and are confused, i.e. Create/Update Drupal 10 compatibility patch sections reads ” Just press the “Create issue fork”" without context where this button is, “Drupal.org provides two ways:” and there are 3 bullet points.

Not a complaint, just an observation D.org documentation tends to get too complex then it needs.

I’m a big advisor of “less is more”, providing ONE way for doing stuff and a “Read More” list of links at the bottom for advanced users. We won’t cover all our beautiful processes diversity, but contributors will get up and running faster.

Again, not a complaint, just an observation if many feels the same way.

Said that, wonderful job everyone!

Kristen Pol’s picture

Issue summary: View changes

Add event page example to summary.

Kristen Pol’s picture

We should update the bot issue summary per https://www.drupal.org/project/bootstrap4/issues/3296669#comment-14709997. I did make a core issue that I'll have to dig up.

Kristen Pol’s picture

Kristen Pol’s picture

Issue summary: View changes

Update summary list.

Kristen Pol credited mmjvb.

Kristen Pol’s picture

Kristen Pol’s picture

Issue summary: View changes

Update improvement list.