show only first paragraph in glossary mouseover
proposal for improving in the way glossary works:
glossary items
- glossary items may have one or more paragraphs
- the first paragraph must be a brief explanation of the item
- additional paragraphs may complement the first one with extra information, links, etc.
glossary items display
- when a glossary term appears somewhere in the docs, the mouseoveor box shows only the first paragraph
- clicking on the glossary term takes the reader to the item in the glossary page, where the full explanation is available
proposed actions
-
review and update existing glossary items -
tweak the ruby plugin so it takes only the first paragraph