Remove unnecessary glossary entries #45894

New Issue

gandalf3 · 2015-08-25T03:47:09+02:00

gandalf3 commented

2015-08-25 03:47:09 +02:00

Some glossary entries seem unnecessary or contain explanations which should perhaps be elsewhere; e.g. tool descriptions.

Tool descriptions I've found in the glossary so far:

Subdivision Surface

Knife

Proportional Editing

Extrude

Others seem perhaps overly specific (I could not find any reference to any of these with a quick search):

Gouraud Shading

Phong

Doppler Effect

Are there any other glossary entries which perhaps should be in the glossary?
Do we have a solid definition of what should be a glossary term and what shouldn't?

Some glossary entries seem unnecessary or contain explanations which should perhaps be elsewhere; e.g. tool descriptions. Tool descriptions I've found in the glossary so far: **Subdivision Surface** **Knife** **Proportional Editing** **Extrude** ----- Others seem perhaps overly specific (I could not find any reference to any of these with a quick search): **Gouraud Shading** **Phong** **Doppler Effect** ----- Are there any other glossary entries which perhaps should be in the glossary? Do we have a solid definition of what should be a glossary term and what shouldn't?

gandalf3 commented

2015-08-25 03:47:09 +02:00

Changed status to: 'Open'

gandalf3 commented

2015-08-25 03:47:09 +02:00

Added subscriber: @gandalf3

gandalf3 commented

2015-08-25 03:57:26 +02:00

Control Cage also seems rather localized

**Control Cage** also seems rather localized

Campbell Barton commented

2015-08-26 07:31:15 +02:00

Added subscriber: @ideasman42

Campbell Barton commented

2015-08-26 07:31:15 +02:00

Changed status from 'Open' to: 'Resolved'

Campbell Barton closed this issue

2015-08-26 07:31:15 +02:00

Campbell Barton self-assigned this 2015-08-26 07:31:15 +02:00

Campbell Barton commented

2015-08-26 07:31:15 +02:00

Committed rBM564

Kept Subdivision Surface but updated the description since it was too specific.

Also Kept: Gouraud & Phong, Shading are also common tems WRT computer graphics, however only Phong shows up in Blender's UI.

Committed rBM564 Kept **Subdivision Surface** but updated the description since it was too specific. Also Kept: **Gouraud & Phong**, Shading are also common tems WRT computer graphics, however only **Phong** shows up in Blender's UI.

gandalf3 commented

2015-08-26 07:47:09 +02:00

Should glossary entries be kept if they are not referenced anywhere in the manual?

Greg Zaal commented

2015-08-26 08:10:28 +02:00

Added subscriber: @GregZaal

Greg Zaal commented

2015-08-26 08:10:28 +02:00

No harm in it I think.

Might be nice to have a script that goes through the glossary and adds :term: directives to the first match of each term on every page in the manual. Though maybe that's not necessary and just makes things messy.

No harm in it I think. Might be nice to have a script that goes through the glossary and adds `:term:` directives to the first match of each term on every page in the manual. Though maybe that's not necessary and just makes things messy.

Sign in to join this conversation.