carpentries
Update glossary items
We now have a single glossary page: https://carpentries-beta-handbook-preview.netlify.app/pages/glossary.html
Most of the items are missing definitions, so definitions need to be added in. Definitions can be added by replacing the text "definition goes here" with the intended definition. Be sure the definition text is indented.
We also need to identify cross-referenced items (currently noted as "See also..."). @brynnelliott has identified this as ableist language. We should decide what language we want to use instead of that before creating all these cross-referenced links, so we don't have to update them all later.
@OscarSiba Had you decided whether to keep the glossary in the handbook or in the existing glossary (https://github.com/carpentries/community-engagement/blob/main/glossary.md)?
As we have a lot to do, it may be easier to keep the existing glossary as it is, and consider moving it to the handbook later.
We will eventually move this to the Handbook later, but let us keep it where it is for now while we deal with more pressing issue. We can link to it under the Resources section.
Discussed with @OscarSiba This should be moved from the current repo into the handbook. All the content of the glossary is currently complete.
@OscarSiba I am working on transferring the glossary from this repo into the handbook. You noted the content is complete but I want to double check with you as I see some things that are out of date. For example:
- Business Team (there is no longer a business team in the Core Team)
- Community Initiatives is listed as our fiscal sponsor (this is a very recent change)
- Executive Council is listed as the former governing group but there is no reference to BoD
I have not gone through everything but I saw those as I went through the first few letters of the alphabet. Would you and/or the CET be able to review this before I transfer everything to the handbook? Thanks!
Assigning back to you for now. Please assign back to me when your updates are complete.
I have a draft PR here that begins to create the glossary. As noted, since the glossary needs updating, I will come back to this once that is done. In the meantime you can preview what it would look like here.
Hi @maneesha. CET has completed the updates on the glossary. You can transfer it to the Handbook. There are minor updates still do to later in the year, but it is good to go now as is.
@OscarSiba A few notes as I move the glossary from the community engagement repo to here:
- "Discussion Host" is in both the main glossary and the archived glossary. Is this correct?
- For the definitions for COW and SOW - SOW uses the singular "workshop" while COW uses the plural. Should that be consistent?
- The definition for Instructor Training says refer to Instructor Training Curriculum but there is no definition for "Instructor Training Curriculum"
- There are several terms that start with the letter "I" in the "T" section.
- There are places in the glossary where it links to other resources (i.e., other parts of the handbook, curriculum pages, etc.). I haven not reviewed whether those links are correct.