We currently have a public page of resources (http://drupaldiversity.com/resources) but it is not up to date.
We have running lists of resources which should be added from
- https://github.com/drupaldiversity/administration/issues/83
- https://github.com/drupaldiversity/administration/issues/134
- https://docs.google.com/document/d/1sgIco6Il2OX9bFKb4GiRdXlmxzy62I2k2quW...
I'm assigning this to myself (and anyone else who wants to help, I have one volunteer so far) to update and reorganize our Resources page, create a way for people to add suggestions, and then to maintain the page in the future. (Maybe those should be separate issues?)
For those adding resources, the place to do so is currently http://live-ddi.pantheonsite.io/, until the new site is launched. See comment #21 for the list of outstanding data entry jobs.
Comments
Comment #2
rubyjiComment #3
rubyjiMore great resources (some of which we should incorporate) and also a possible model of how to organize this: https://github.com/folkswhocode/awesome-diversity
Comment #4
sacarney commentedExcellent - thanks for setting this up. Were we going to be moving this list to Drupal.org as well?
Comment #5
sugaroverflow commentedYes @sacarney, we should add this to our documentation guides somewhere.
I haven't had a chance to move over our wikis yet: https://www.drupal.org/docs/8/modules/drupal-diversity-inclusion
Comment #6
rubyjiGreat point, @sacarney! Let's just build the new version here on d.o.
@sugaroverflow, should I add a new page at the top level of our "documentation" https://www.drupal.org/docs/8/modules/drupal-diversity-inclusion, or start a new guide?
Comment #7
sugaroverflow commented@rubyji I think guides will appear as blocks on that page, so maybe we can have a guide for Resources and then have pages within that? That might give us the ability to expand later?
Comment #8
rubyjiThat sounds great, @sugaroverflow! I was hoping it would work that way.
Comment #9
rubyjiOK, I've started by recreating the old resources page at https://www.drupal.org/docs/8/modules/drupal-diversity-inclusion/resources
1. How do I get this added to the top level documentation? Or do I just need to wait for it to be reviewed? That is fine since I want to make a lot of changes to it. It might actually be good to wait on adding it.
2. Any thoughts on how to bring in the content from our Github issues? And @sacarney, can you help by writing the titles and short descriptions as we did for the older resources? Should each heading be a separate page in the guide for easier navigation?
My thinking is that these can all be under a heading something like "How developers values get encoded into our products."
Many of these and these are non-tech related so I think that's a heading ("Being Human" "Real Life" "Not Just Tech"?), with subheadings as currently appear in the document. The ones that are tech related can maybe get integrated into the three existing categories of What's the Problem, Talking about it, How to Help.
I'm verrry open to different headings and other ways to organize this if people have thoughts to share about that.
Comment #10
sugaroverflow commented@rubyji
1. I'll add you as a maintainer of the guide, you can review them when you're done with them. To remove the "needs approval", I think you can just add it to the menu and publish the page.
2. I like the idea of separate headings!
Comment #11
rubyjiNow that we are moving drupaldiversity.com to Drupal, I'm wondering if it would be better for the Resources page(s) to live there.
I feel like it would make more sense on our own site than on d.o. Anyone else have thoughts about this?
Comment #12
rubyjiOur new plan is to build the resources out as a content type on our new DDI Drupal site. This will allow for complex organization with taxonomies, easy filtering/finding, and a streamlined submission workflow.
sacarney and I will be meeting to plan this next week. Additional volunteers are still welcome. ;-)
Comment #13
rubyjiHere is the proposed taxonomy for resources:
There will also be a list of types:
And the content type itself:
Comment #14
rubyjiAfter getting some really helpful feedback from the DDI leadership team, the categories are really coming together. Here's how they look now:
Comment #15
rubyjiThanks to @sacarney, @agentrickard, and @hrodig we now have all of the original resources drupaldiversity.com/resources added to the new Resource Library!
Next we need people to add the links from https://github.com/drupaldiversity/administration/issues/83 and https://docs.google.com/document/d/1sgIco6Il2OX9bFKb4GiRdXlmxzy62I2k2quW...
I will take the links from https://github.com/drupaldiversity/administration/issues/134 because I have a special interest in that subject.
Comment #19
sugaroverflow commentedTalked to @rubyji - crediting @rubyji @hrodrig @agentrickard @sacarney and @OyaOrisha for this issue.
Comment #20
rubyjiThanks also to @OyaOrisha for adding resources last week!
I'm working on breaking out the remaining resources into chunks that volunteers can claim. Hopefully by our weekly meeting on Thursday.
Comment #21
rubyjiOK, here are some task chunks that people can grab. Please comment here to indicate the number of the section you are taking so that others don't work on the same one. This will also allow us to give you credit when this issue is completed!
(Ignore the Google Sheet and the book.)
All of this data entry should be done at http://dev-ddi.pantheonsite.io/resources. Thanks!
Comment #22
OyaOrisha commentedI'll take #1
Comment #23
OyaOrisha commentedDid #1. DiversiTech went to a site that wasn't related to diversity and the #notbuyingit app link went to therepresentationproject.org. Wasn't sure if we wanted to add that one to resources or not so I didn't.
Comment #24
kclarkson commentedUPDATE:
All Content should be added in the "live" pantheon environment.
You can access that link here: http://live-ddi.pantheonsite.io/
Once we go live we will point the URL and you will just log into the normal site.
Thanks everyone.
Comment #25
kclarkson commentedComment #26
rubyjiMoving the current website out of the list of legacy resources.
Comment #27
sparklingrobotsI'm taking:
UPDATE: These resources have been entered.
Comment #28
rubyjiSome more great resources to add from a mailing list I'm on:
Comment #29
sparklingrobotsUPDATE FOR SPRINTERS AT DRUPALCON NASHVILLE:
Resources can be added at: https://www.drupaldiversity.com/node/add/resource
You do not need a user account, they can be added anonymously.
Before you begin, please:
1) Announce that you are entering a particular segment of resources
and
2) Search for the resources you are adding to make sure they aren't already there (https://www.drupaldiversity.com/resources)
Comments 21 & 28 should be good places to start.
Comment #30
sparklingrobotsComment #31
marcelovaniComment #32
Unitoch commentedI'm taking chunk 2 from #21.
Comment #33
Unitoch commentedI went through chunk 2 from #21. All of it was already added, or pointed at a broken link, which might mean it was duplicative with other lists or was already done. I stuck to only the items that were present and accessible at the moment, i.e. I didn't put Ashe Dryden's book in there as it isn't written yet.
Moving on to chunk #3.
Comment #34
arizona2207 commentedI'll take task chunk #6
Comment #35
Unitoch commentedI got as far as the third item in the list from item 2 on #21, but there's still lots of stuff in that post to be done on that list.
Comment #36
rubyjiJust discovered MOAR wonderful links at http://po.st/18NTCamplify
Comment #37
sparklingrobotsI’m wondering if we could do something to break those resources into multiple issues (maybe like a quarterly issue refresh?)…. I asked people at the sprints on Friday to work on them and I would like to be able to close out the issue and grant that credit eventually. Just something I’m thinking about to keep up some momentum on those resources. Maybe every three months any remaining resources get moved into a fresh issue?
Comment #38
arizona2207 commentedI'm going to start working on them tonight and report progress with the list that members have compiled so far. If I find any more should I list them here for approval or add them myself?
Comment #39
sparklingrobots@arizona2207 If you find more resources, feel free to add them directly to the site! It's moderated so the editors will review there.
Comment #40
sparklingrobotsIn the hopes of getting people some credit and in an attempt to clarify what remains to be done, I'm closing this issue & moving the work to a new issue: https://www.drupal.org/project/diversity/issues/2966629
Comment #41
sparklingrobotsComment #42
sparklingrobotsComment #43
sparklingrobots@sugaroverflow, it seems I can't give credit since I'm not a maintainer. Can you give credit to everyone on this thread? Reopening until that happens.
If you wish to work on the issue, please work on the new issue: https://www.drupal.org/project/diversity/issues/2966629
Comment #44
aburke626Comment #45
aburke626Comment #46
laughnanClosing and providing credit per #43.
All future resources can be created on the website directly. We should (?) probably open up a discussion or issue for giving credit visually from the website for the user's Drupal.org username if desired.