diff --git a/src/Magnum/GL/AbstractShaderProgram.h b/src/Magnum/GL/AbstractShaderProgram.h
index eca93e92e..9f7289052 100644
--- a/src/Magnum/GL/AbstractShaderProgram.h
+++ b/src/Magnum/GL/AbstractShaderProgram.h
@@ -796,7 +796,7 @@ class MAGNUM_GL_EXPORT AbstractShaderProgram: public AbstractObject {
         #endif
 
         /**
-         * @brief Attach shader
+         * @brief Attach a shader
          *
          * @see @fn_gl_keyword{AttachShader}
          */
@@ -812,7 +812,7 @@ class MAGNUM_GL_EXPORT AbstractShaderProgram: public AbstractObject {
         void attachShaders(std::initializer_list<Containers::Reference<Shader>> shaders);
 
         /**
-         * @brief Bind attribute to given location
+         * @brief Bind an attribute to given location
          * @param location      Location
          * @param name          Attribute name
          *
diff --git a/src/Magnum/GL/Shader.h b/src/Magnum/GL/Shader.h
index a5c538ca9..b8428e0c4 100644
--- a/src/Magnum/GL/Shader.h
+++ b/src/Magnum/GL/Shader.h
@@ -596,7 +596,7 @@ class MAGNUM_GL_EXPORT Shader: public AbstractObject {
         Shader& addSource(std::string source);
 
         /**
-         * @brief Add source file
+         * @brief Add shader source file
          * @param filename  Name of source file to read from
          * @return Reference to self (for method chaining)
          *