search

speced / speced-cg

Specification Editors CG main repository
6 stars 0 forks source link

Contribute content to WPC Guide? #21

Open gregwhitworth opened 3 years ago

gregwhitworth commented 3 years ago

The purpose of the CG is perfect as it is a common issue that comes up. One thing that I'd like to ensure that we do is not necessarily re-create the wheel. Bocoup and others started a project called the WPC (web platform contribution) Guide which aims to help in many of the topics the CG aims to help document further.

https://wpc.guide/

I think it would be good for us to work alongside this site and have our content deployed there. I understand this is a meta topic but I really would love to have one place to point people to for this information.

marcoscaceres commented 3 years ago

Great idea @gregwhitworth. I'd not seen the WPC guide (super nice!), so I'll give it a look over and think about how we can best coordinate.

Just noting that a lot of what I'm hoping to do here is run "hands on" tutorial sessions - but capturing documentation somewhere would be good.

marcoscaceres commented 3 years ago

Ok, yeah... actually, I have read the WPC before. There is indeed a lot overlap - but yeah, I'm imagining this more as hands-on sessions with small focused groups (~5 people at a time over Zoom or whatever).

ericprud commented 3 years ago

any chance our work can feed back into, and thus synchronize with, the WPC? We could even treat it as a primary document and add cross-links to recorded sessions.

marcoscaceres commented 3 years ago

Anything is possible at the moment, as this has no structure. However, it really depends on how people want the sessions to be run... I'm imagining some sessions might not make any sense being recorded because they won't be lectures... they would be more hands on tutorials, making sure everyone taking part is up to date, back and forth discussions, questions throughout, etc.

Others would definitely make sense being recorded (e.g., possibly the Web IDL one could be a lecture)... but it really depends. I want us to avoid passively lecturing people about things, as that's only marginally better than reading documents (which are great as a reference, but can be overwhelming for beginners), and can get a bit boring. A lot of people learn better by actively doing with someone helping them side-by-side, know what I mean?