pivotal-cf/glossary

Name: glossary

Owner: Pivotal Cloud Foundry

Description: null

Created: 2018-03-21 20:43:17.0

Updated: 2018-05-22 16:45:35.0

Pushed: 2018-05-24 15:28:47.0

Homepage: null

Size: 187

Language: HTML

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

PEDANT: Pivotal Electronic Dictionary of Arcane Nomenclature and Terminology

We have all felt the frustration of not being able to fully participate in a conversation because of the large number of ACRONYMS (Alphabetic Characters Representing Obscure Names You Must Shorten) in use by GURUS (Groups Uttering Regrettably Unclear Slang) and long-term company VETERANS (Very Experienced Technical Experts Repeating ACRONYMS Nobody Speaks). Until you develop the EAR (Experience, Appreciation, and Respect) for a team's specific ARGOT (Abbreviated References to Generally Obvious Things), it's unfortunately easy to be left feeling like an IGNORAMUS (Individual Given No Opportunity to Respond to A Million Unintelligible Sayings).

This project aims to make Pivotal a more inclusive environment by explicitly defining the terms, acronyms, initialisms, abbreviations, and jargon used throughout our company.

Visit the glossary

https://cf-glossary.cfapps.io

Contributing entries

The site is generated from yaml files located in the /entries directory. An entry will look something like this:


word: PWS
nsion: Pivotal Web Services
nition: >
votal's CF-as-a-service offering. This is an instance of 
-deployment maintained by the CloudOps team. This environment
 useful for getting feedback on the experience of operating 
oud Foundry at scale.
s:
tps://run.pivotal.io
also:
-D
aS

Other than headword, all fields are considered optional.

These files can be created and edited manually. Or, to get started on a new entry, you can create an empty template by running rake add_word["Pair Programming"].

To preview how the site will look with new entries, build it with rake && open build/index.html

Acknolwedgements

The need for this list became clear when two members of my team, both new Pivots, let me know how overwhelmed they felt by all the acronyms flying at them all the time. I don't think we would have had that conversation if not for the Inclusion workshop organized for us by Gareth Smith.

My humorous acronyming has been inspired by this delightful piece by Dan Caprera in McSweeny's Internet Tendency. Check it out.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.