{"id":8664,"date":"2023-08-18T16:36:37","date_gmt":"2023-08-18T11:06:37","guid":{"rendered":"https:\/\/razorpay.com\/learn\/?p=8664"},"modified":"2024-10-14T16:29:25","modified_gmt":"2024-10-14T10:59:25","slug":"the-importance-of-a-glossary","status":"publish","type":"post","link":"https:\/\/razorpay.com\/learn\/the-importance-of-a-glossary\/","title":{"rendered":"The Importance of a Glossary"},"content":{"rendered":"

Do you recall literature textbooks from your school days? Hefty and laden with discoveries? Across all language text books, one common thing was the chapter-end exercises, of course, but also the list of meanings right after the end of the lesson.<\/span><\/p>\n

Such literature often contained complex, period-specific wording choices that spun our heads. So the meanings lists made the text accessible and easy to understand. They remained a steady, reliable source that helped me decipher the text with relative context and simplicity.<\/span><\/p>\n

As I grew older, I found such lists everywhere. Think of dictionaries, directories, end-notes, citations, and glossaries. Diverse as they are, they served a singular purpose:\u00a0<\/span><\/p>\n

They were simple, concise, one-stop lists and acted as excellent references.\u00a0<\/span><\/i><\/p>\n

In a documentation context, such lists are arranged as a glossary: a list of terminologies simplified using contextual explanations.<\/span><\/p>\n

Does Anybody Read Glossaries?<\/b><\/h1>\n

I\u2019ll admit: going through the meanings solely wasn\u2019t so fun. Glossaries are used less for reading and are more commonly used to take references and immediate help. When you notice an unfamiliar word, you try to remove that uncertainty with some help.\u00a0<\/span><\/p>\n

\"\"A vintage glossary page<\/span><\/i><\/p>\n

Consider <\/span>Razorpay Docs<\/span><\/a>, our documentation platform. We host countless articles and media about multiple Razorpay products, spanning across countries and industries, containing complex application and code integrations to industry-specific business finance management.\u00a0<\/span><\/p>\n

The scope for technical jargon is vast. While we make our documentation accessible, it\u2019s critical to <\/span>balance the document’s intent with the audience<\/span><\/a>. Even if we tried simplifying the language, we would still face problems. For example:<\/span><\/p>\n