glossary

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 15 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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**](https://en.wikipedia.org/wiki/Argot) (Abbreviated
References to Generally Obvious Things), it's unfortunately easy to be left
feeling like an
[**IGNORAMUS**](https://www.merriam-webster.com/dictionary/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](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:

```
---
headword: PWS
expansion: Pivotal Web Services
definition: >
  Pivotal's CF-as-a-service offering. This is an instance of 
  cf-deployment maintained by the CloudOps team. This environment
  is useful for getting feedback on the experience of operating 
  Cloud Foundry at scale.
links:
- https://run.pivotal.io
see_also:
- CF-D
- PaaS
```

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`

## Acknowledgements

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](https://www.mcsweeneys.net/articles/our-top-secret-army-base-uses-too-many-acronyms) by Dan Caprera in McSweeny's Internet Tendency. Check it out.

## Related Projects

| Project | Description |
| ------- | ----------- |
| [mikfreedman/pivotal-glossary-clients](https://github.com/mikfreedman/pivotal-glossary-clients) | A collection of extensions for this glossary. [webstore link](https://chrome.google.com/webstore/detail/pivotal-glossary/ljjopgdkacddgfcpfofhngkbopmoamkk) |
| [Manifaust/cloud-glossary](https://github.com/Manifaust/cloud-glossary) | Another Glossary project, hosted here: <https://glossary.cfapps.io> |
| [motevets/pivotal-glossary](https://github.com/motevets/pivotal-glossary) | Chrome extension that will expand acronyms based on this glossary. [webstore link](https://chrome.google.com/webstore/detail/pivotal-glossary/ldjikeaflhaeahnfcloapnfpnmbjloog) |

glossary

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README